First time here? Check out the FAQ!
1

What is the state of documentation for askbot project?

What is the current state of documentation of askbot? I am referring to following:

  • Code Documentation
  • User Manual
  • Administration Manual
  • Installation Manual - I guess this is complete
Incheon's avatar
11
Incheon
asked 2012-02-28 03:33:34 -0500, updated 2012-02-28 23:06:23 -0500
edit flag offensive 0 remove flag close merge delete

Comments

add a comment see more comments

1 Answer

1

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.

Evgeny's avatar
13.2k
Evgeny
answered 2012-02-28 10:31:52 -0500, updated 2012-02-28 10:33:09 -0500
edit flag offensive 0 remove flag delete link

Comments

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.

Incheon's avatar Incheon (2012-02-28 23:08:19 -0500) edit

I'd rather have askbot be self-evident, than documented. That said the installation procedure and documentation are neither.

brycenesbitt's avatar brycenesbitt (2012-03-04 23:24:20 -0500) edit

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.

Incheon's avatar Incheon (2012-03-08 21:26:48 -0500) edit
add a comment see more comments