On Friday, 25 December 2015 at 15:51:02 UTC, rcorre wrote:
On Friday, 25 December 2015 at 14:24:34 UTC, Bubbasaur wrote:
What happens when I see a DOC with comments is that sometimes
the comments are more clear than the Doc itself, or there are
tips or tricks that was not "well" documented.
Bubba.
If the comments are more clear than the Doc, then they should
_be_ the doc. Similarly, useful tips and tricks should probably
be included as doc examples. In other words, I think we should
encourage contribution to official documentation rather than
dividing between official docs and user comments.
This does raise the bar to entry though, so maybe a suggestion
box could be a nice middle ground.
I agree, but you know in a perfect world nothing always work as
we imagine, but anyway I think the suggestion box is a good idea.
Bubba.