melonJS
melonJS copied to clipboard
Consider putting a FAQ in the docs?
It might make it easier for people to solve issues on their own and for us to track (and post solutions to) issues as they arise
it's a good suggestion indeed, we have a FAQ here but having it indeed in the doc would make it "easier" to see, and to contribute
@ShukantPal any suggestion on how we could do that ? maybe add a specific FAQ.md somewhere and having it accessible in the doc header with a "FAQ" link just beside the "API reference one" ?
@obiot webdoc has a concept of tutorials from JSDoc. You can also call them guides or wikis. You can see how to set it up here: https://www.webdoclabs.com/guides/getting-started/tutorials.html
oh that's 2 times interesting :
- we can indeed have a FAQ "only" repository, where it's easier for user to contribute, and have it totally integrated with the documentation (in terms of visual / layout)
- we can actually have the tutorial rewritten the same way and also fit within the documentation page
where are those links then available ? In the header beside the API link ?
Yeah, the header will have two options "API" and "FAQ" (if you rename tutorials to FAQ).
If you want to have a separate repository, I would recommend using git submodules to import them into this repo so webdoc can parse the API and the tutorials in a single run.
https://melonjs.org/wiki/Frequently-Asked-Questions/ The styling isn't done yet, but we're in the process of moving the wiki to the main website 😄