On 22/05/11 21:50, fakedarren wrote:
With regards to comments.....this has been discussed endlessly before.
It sounds great but the reality is not as rosy as it seems. It would
need heavily moderating to be of real use; you could have a system
whereby comments only exist for a couple of weeks; if the comment is
really insightful, we adjust the documentation accordingly. But just
look at the PHP documentation; yes there is some great stuff in the
user comments. There is also some terrible stuff in there.
But as arian says we already have the ability for any and all users to
comment and / or adjust our documentation. It's all freely available
on github
<https://github.com/mootools/mootools-core/tree/master/Docs>. We
welcome all and any feedback.
What about adding linkback support to the docs? That way, people can
write up their notes on x, y, or z on their blog/website/whatever, and
have that listed on the docs. I think that you would generally get
better quality comments this way, because it takes more time and effort.
You'd still need some moderation, sure, but as the content won't be part
of the MooTools website itself, it won't inherit any authority.
--
Barry van Oudtshoorn
www.barryvan.com.au
Not sent from my Apple πPhone.
