melonjs / melonJS

a fresh, modern & lightweight HTML5 game engine
https://melonjs.org
MIT License
5.92k stars 643 forks source link

Consider putting a FAQ in the docs? #1108

Open L1lith opened 2 years ago

L1lith commented 2 years ago

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

obiot commented 2 years ago

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" ?

ShukantPal commented 2 years ago

@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

obiot commented 2 years ago

oh that's 2 times interesting :

  1. 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)
  2. 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 ?

ShukantPal commented 2 years ago

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.

L1lith commented 2 years ago

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 😄