What is the current state of documentation of askbot? I am referring to following:
Of the four you mentioned we do not have "user manual" and "administration manual" yet.
Ideally the software should be just simpler to use, so that the manuals would not be as necessary, or could be kept more concise. I'd rather spend the effort on this, rather than writing the manuals.
In order for people to contribute on a question/answer site in my view user manual is absolutely necessary with as much details as possible, supplemented with online help. Regarding code documentation I was referring more to the documentation which describes the specific design decisions, classes and the inner workings of the code so that it becomes easier for people to use. In my view since askbot uses django, the documentation standard for this project should also match that of django. It will be good to create a documentation as sub part of this project and invite contributors.
I'd rather have askbot be self-evident, than documented. That said the installation procedure and documentation are neither.
Its impossible to have a good self-evident system for all common use cases, indeed the best user interface developers like apple also needs to be produce a very detailed documentation. As mentioned in my post earlier documentation is necessary for the success of this project. As its based on django I hope askbot should follow django example for documentation.
Comments