AltME: Red Docs


The work I did was related to publishing to mediawiki directly from REBOL. This way, some mediawiki pages could be auto-generated.
Someone also wrote a makedoc GUI, didn't they? Are there tools like that for managing a doc base? I also agree with some earlier comments about some commercial sites having very good docs. How do they do it?
Gabriele wrote a MakeDoc GUI a long time ago.
Looks like Gigaspaces uses a wiki, and Confluence is in their footer.
Ah yes, thanks Henrik.
To amend my earlier statements, a wiki as a platform is not the problem. The problem is putting up a wiki and expecting great documentation to appear, without someone to set up a structure, design, and maintain it. You need a leader.
I can't commit to being the leader just now. I'm happy to help though.
I would write the structure as a dialect and sub-page generators from that. Each page would be a plain text file or a set of files which can be separately edited through a simple web interface.
I'll try to get back later, to pull other doc links from the #Red group. In the meantime, here is one:
I like the upper right link categories: API docs, Forum, Blog, White Papers.
Find something to emulate, whatever it may be. Learn from others who have done this before.
This is an interesting approach:
the Scala doc site seems pretty decent, as well:
Oldes: nice mashup!

We might have another good alternative option to the wiki (maybe easier and more flexible): use a github repo for all the    documentation pages in makedoc format, and have external export batch script to export them in HTML, PDF or whatever format.
I would be able to write most of the reference documentation, but would probably let the dictionnary be written by the community. The githun repo would allow for everyone to contribute while being filtered by one or several managers.
I would like to copy this extjs template component for documentation, with content in JSON format:
I guess it should be search-engines friendly.

Last message posted 104 weeks ago.