AltME: Red Docs
Thursday 16th October, 2014
TOC syncing is broken for me
Do you have JS disabled?
No, then it wouldn't work at all
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?
Gregg, no problem, anyway, this is something we can generate ourselves and copy the good-looking parts from it.
First time here, FF28, didn't sync. Then I opened the TOC one level and it started working.
I think the clojure ref model and the couchbase manual model are fairly compatible as well.
Friday 16th January, 2015
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
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.
Saturday 24th January, 2015
4) a language reference
You mean a language specification document?
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.
Language Design/Implementation Reference?
That's a very, very good suggestion Andreas. It won't be easy to write well. Do you think you may have a little time to help with it?
Last message posted 74 weeks ago.