AltME: Red Docs

Messages

DocKimbel
Is their docs generating tool available somewhere?
Kaj
TOC syncing is broken for me
DocKimbel
Do you have JS disabled?
Kaj
No, then it wouldn't work at all
Gregg
I don't know Doc. I'll find out when I can. Being the commercial branch of CouchDB, they may not make everything available.
What browser Kaj?
DocKimbel
Gregg, no problem, anyway, this is something we can generate ourselves and copy the good-looking parts from it.
Gregg
Agreed.
Kaj
Firefox 29
Gregg
First time here, FF28, didn't sync. Then I opened the TOC one level and it started working.
Gregg
I think the clojure ref model and the couchbase manual model are fairly compatible as well.

Gregg
DocKimbel
So, in a nutshell:
- github for hosting the docs (in a red/documentation repo)
- markdown for the initial format (with eventually some additions)
- Nim's documentation layout and style
DocKimbel
For the content itself, we need:
1) a user manual (with the same level as the Rebol/Core Manual)
2) a dictionary of the words
3) some tutorials
(1) is the biggest and most important part.

Andreas
4) a language reference
DocKimbel
You mean a language specification document?
Andreas
Yes. Everything that is not covered by the dictionary.
And stuff at a technical detail that is too much for the user manual.
One of the more important aspects: syntax. But also stuff like: binding, argument passing modes, cor e evaluation semantics.
Gregg
Language Design/Implementation Reference?

Last message posted 408 weeks ago.