First time here? Check out the FAQ!
2

Suggestion: Make askbot.org/doc/ community edited wiki

It would be good if the Askbot docs were presented as a wiki so developers could put notes against paragraphs and so on. I think Django uses something like this on their docs pages. It could be hidden from view by default to prevent viewers being hit by a barrage of comment tags.

There are several typos, style changes and more important missing functionality documentation that I'd like to put in. Askbot needs a mechanism to manage these submissions.

It looks like the documentation shown on this site comes from the git controlled source so I could just make changes and then do a git pull request. However this mechanism would lack any discussion around a documentation issue and those only interested in deploying and not coding might be locked out.

powlo's avatar
260
powlo
asked 2012-03-03 13:00:21 -0600
edit flag offensive 0 remove flag close merge delete

Comments

add a comment see more comments

1 Answer

2

The reason for this is that it will be very hard to guarantee consistency of the documentation with the code when the documentation is not in the source control system. So unfortunately this cannot be done.

However - askbot is hosted on github - so anyone can make a fork and edit documentation directly on github, then make a pull request.

Evgeny's avatar
13.2k
Evgeny
answered 2012-03-03 16:26:40 -0600
edit flag offensive 0 remove flag delete link

Comments

add a comment see more comments