Hello,
Right now I am looking for a cms, or something similar, where I can write down the documentation of my projects.
I already looked at projects like "tikiwiki", "redmine", "mediawiki" and some more.
What I am looking for is a wiki like site with a WYSWYIG editor and an editable navigation so I can structure hierarchies like:
project
- install
- - web service
- changelog
- user
- - design mode
- - - drag mode
Plus point would be inline edit like in tiki wiki. I have to say, that I really like tiki wiki, but I don't get the navigation thing. I already tried structures and tocs etc, but i want it simple and easy.
Does someone know of any such tool? Or, what tools do you use for your documentation? (I am not talking about automatic documentation tools!)
Have you tried out Sphinx? It was originally created to document the new Python release (3.0 I guess). The only downside is that it uses reStructuredText rather than Markdown. Have a look. It may work for you.
Remco Boerma
CTO@NPO, python dev, dba
Most of my documentation lives inside the source code. But the "project" source code sometimes resides in markdown/html text files near the code or on a wiki. I have mostly used moinmoin but am changing to both a custom pastebin/snippet like application as well as using evernote. Also, google docs has been a a savior in our corporate environment once or twice because many suppliers use it and it allows for great collaboration.
What i came acros yesterday was penflip.com - it may be a viable alternative. When i start a new open source project i will probably use it because of the ease of collaboration. Hope this helps!