We have tried a wiki…
GitHub - MonoGame/MonoGame: One framework for creating powerful cross-platform games.
That was the MonoGame wiki for 3 or 4 years and it was always a total mess. It was always out of date, the information was good and bad, formatting totally different from page to page, etc.
I used to think a Wiki is great for docs, but that and a ton of other experiences told me it was not.
The docs are now here:
http://www.monogame.net/documentation/?page=main
… the benefits so far:
- They are versioned with the code… so a feature change can me matched with a doc change.
- Docs get reviewed like any other code change.
- We finally have reference docs.
The big problem is that no one cares to write good docs. No matter where we put them… the lack of good docs is because no one writes them. And we have tried for over a year now to get people to help:
- Help Us Improve MonoGame Documentation!
- MonoGame Documentation Project · Issue #2378 · MonoGame/MonoGame · GitHub
- Move Old Wiki Docs To MonoGame Docs · Issue #4080 · MonoGame/MonoGame · GitHub
In that time maybe 2 or 3 people have helped with docs here and there, but no big efforts for big chunks of getting started documentation.
IMO until myself or one of the other core contributors decides to spend 3 months only writing docs… it will never get done. No one else really wants to help in that capacity.