A recent announcement on SO introduces the idea of user-contributed documentation. Altho the Mathematica documentation is quite long, it has been said at various points that it could certainly be improved. (A look through the site will show not a few grumbles on how the docs were remiss in explaining the subtle points of a function's usage.) Also, tho there are a number of "advanced documentation" entries in the official docs for some functions (e.g. NDSolve[]
, NIntegrate[]
), there still are areas of Mathematica that can certainly benefit from having user-contributed advanced documentation.
Should we, the Mathematica SE community, be participating in this?
(In particular, I'm interested in hearing of any possible cons of this; while looking through that site, I had a hard time thinking about cons, and could only enumerate pros.)