Graham experimenting with user-generated content. Idea is that we'll pull the answers to this question as a list of user-contributed comments/suggestions.

Wait, I'm confused... you're asking US to write the documentation/API for you? ... Isn't that your job, not ours? After all, you know Unity best?

We'd like talented members of the Unity community to be able to share tips and advice, similar to the http://php.net docs. We're not sure how best to make this happen, so are doing some experiments.

maybe those that have good karma are able to edit it?

after all well I've started programming since new year any yes I've got around 300 karma points and so far know something

propably those that have 1k or more know much more than me

but here's the trick you make 2. karma that is being started on editing the API

so when user enteres the edit mode let say 5k karma points he gets 50 karma points for 2. karma

now If the documentation is well written and if user thumbs up the API he gets 2 karma

if user is confused he downvotes the API and HE MUST provide what's the confusion about and OFC the writer of manual get's -5 karma

so the manual can be repaired

IF the down vote has not been provided with correct what's the cuonfusion about.

and if this down vote is found within 48 hours the down vote get's a down vote and it means that the writer losts only -1 karma and not -5

IF the writer looses 50 2. karma points he's not able to write any API any longer.

what do you think?