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).
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.
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.
A document would be trickier as you'd need to manage line spacing, paragraph spacing, splitting paragraphs/docs over pages.
Yes, it managed only a single page, and yes, the hard part is flow of paragraphs across pages, not generating multiple pages in itself.
(that'd be page breaks, indeed)
You'd need to be able to measure as you go...
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 - 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 ...