Instead of adding more posts to the feature wishlist thread, I start a new one.
This is a vicious circle as no doc = not that’s much people coming and wishing to help = less doc = less people = … = ultimately death (pessimistic ? maybe, maybe not)
Also, a forum is not a documentation and can’t be use as such so using it temporarily/because it’s convenient/there is nothing better yet it’s just delaying indefinitely the issue until it’s too late (because people who knows will be overwhelmed by the huge task to do).
The other usual issue with forum comes from the “modern selfishness” of people (“help me I have my emergency, help help help (please)…”, 2 mins later “no one ? help me please !!!” etc then, sometimes, “problem solved” without any more useful info for the record, usually). Those people want their very own solution to their own issue but forgot the big word chosen for the forum “COMMUNITY” :(.
Another issue with doc is people thinking doing good by creating a doc here, a doc there (like this one, they’ll help, but instead of the good “divide and conquer”, here it’s just divert people everywhere but where they should go FIRST to find doc: MonoGame official website ! I saw some questions on usual forum like gamedev.stackexchange.com, it looks like some people don’t even know there is a forum here.
By the way it would be good to have a full documentation on shader, it could be done first by gathering all intel of the subject in the forum (any motivated people can do it, prepare a draft document which could be reviewed and corrected if needed by the team/people who knows).
I think mostly only involved people (Tom & KonajuGames) can do the doc, and if they don’t create it, no one could, almost.
In order to beat this issue, it could be possible for you to write very simple doc without even any full sentences, and let other doing the redacting (which is where most of the time used in making doc), a very good start would be a complete XNA -> MonoGame (including shaders) like the great XNA 3.1->4.0 cheatsheet by Nelson Hurst.
To end, this is a little step by step for making doc, tell me what do you think about it:
-why using MonoGame: benefits and costs, for which kind of game, which platform, future plan …
-moving from XNA, checklist/cheatsheet
-compiling the game for platform … (each one would have its own part, tools needed, things to do, …)
-specific platform feature/lack of feature/limitations