AltME: Red Docs

Messages

DocKimbel
No problem for making it public.
Henrik
Not sure if this is enough. Changed the title.

Gregg
On docs, in one of my dreams, I see another category along with Example and See Also: Tests. Make it easy for people to contribute tests (and expected results).
AdrianS
Agree that examples are a must have. I see way too many reference sites that just show an API along with a brief description. Even when these are very nicely presented, they leave me wanting. Seeing an APIs in action makes a huge difference to me, but of course the work of creating examples should come from the community.

james_nak
Gregg, that's a good dream and very meaning for learning. The figuring out of why something doesn't work is so powerful especially when one thinks it should.

Chris
<from #Red>
A document would be trickier as you'd need to manage line spacing, paragraph spacing, splitting paragraphs/docs over pages.
Henrik
Yes, it managed only a single page, and yes, the hard part is flow of paragraphs across pages, not generating multiple pages in itself.
Chris
(that'd be page breaks, indeed)
You'd need to be able to measure as you go...
Henrik
I'd still think that doing it in the graphics engine is simpler than in PDF. For R3, someone is probably going to do it anyway.
and I hope DRAW or similar will be available for Red.
Kaj
It will

Henrik
cool :-)
Pekr
Kaj - sounds like sure thing but also news for me :-) AFAIK you and Doc were not much interested in bringing View to Red. Well, unless you mean DRAW equivalent done using different engine ...
DocKimbel
Pekr: DRAW is a dialect for 2D vector drawings.

Gregg
Ping.
DocKimbel
Funny that I even forgot that this group existed. :-) Thanks for bringing it back to life. ;-)
GregP
No real standard for MD, so I vote for a Red made parsing, similar to MakeDoc. The TOC is great. Table are so-so, the one from MakeDocPro are better.
Arnold
+1

Gregg
http://docs.couchbase.com/couchbase-devguide-2.5 - Synced nav TOC on the left, and one long doc.

Last message posted 65 weeks ago.