Solution for web documentation

[shawn_a]

Does anyone know of some software to easily manage docs and tutorials.
Steps, screenshots , figures etc , FAQ?

Webbased or node etc.

[Lars]

Why not a Wiki?

e.g. DokuWiki was devolped for this kind of usage.

[datiswous]

Nowadays I use Google presentation software for this purpose.

Allthough This is the making of the docs itself, not really the managing.

[shawn_a]

yeah a wiki is a bit overkill, and not really what i need.

[Lars]

Hmm. Overkill? A Doku-Wiki! Set up in minutes up and running in less an hour... details UAC, no database, simple Syntax, easy links and media... running an a stick with micro apache ....

OK, I thought it would be a great idea ;-)

Tell us what you have chosen, im very intrested in :-)

[shawn_a]

I have not chosen anything yet.

[datiswous]

Maybe Draft

[datiswous]

Guide on the Side:
https://github.com/ualibraries/Guide-on-the-Side

[shawn_a]

very very cool, thanks

[datiswous]

Where do you need it for by the way?

[shawn_a]

For work, I need a way to manage screenshots, annotate, add as figures, create step by step directions, and doing it in word sucks.

I love to just have it as data
step 1, desc, attach images, insert figure here, link etc.

[datiswous]

I also recently found Visme, can also be used for that:
http://www.visme.co/

Maybe a bit over the top..

[hameau]

For work, I need a way to manage screenshots, annotate, add as figures, create step by step directions, and doing it in word sucks.

Depending on your complexity, perhaps Zim would work for you.

Lightweight, text files based (easy backup, easy search), export to html (custom templates, whole notebook or single page, with or without child pages). Lots of plugins for extra features.

I have used it for several years on the desktop for note-taking and as a, well, personal wiki, I suppose.

[shawn_a]

great suggestions, thanks

[datiswous]

Not realy a system, but maybe can be used in a system in some way:
http://usablica.github.io/intro.js/

[datiswous]

It seams you can use Doxygen for normal documentation

[shawn_a]

Not what i was looking for but this is awesome, i have been fiddling with phpdoc to try to get our source cleaned up and documented better than the wiki.

This is just perfect for that, how did I not know about that. ( they even have win binaries!, so i can run this on anything)

[datiswous]

Not what i was looking for but this is awesome, i have been fiddling with phpdoc to try to get our source cleaned up and documented better than the wiki.

This is just perfect for that, how did I not know about that. ( they even have win binaries!, so i can run this on anything)

Glad to be of help. Maybe these extensions are handy as well:
https://github.com/avleze/brackets-doxygen
https://github.com/dail8859/DoxyIt

[shawn_a]

neato

I use sublime text with docblockr, which is pretty much the same thing.
Uses pretty much the same syntax.

[datiswous]

Did you know about this site:
https://readthedocs.org/

[datiswous]

Just found this documentation generator: http://daux.io/

[shawn_a]

Very nice

[datiswous]

And another one...
https://www.gitbook.com/