[Doc-SIG] Comments on the reST notes
Garth T Kidd
Thu, 9 Aug 2001 09:18:44 +1000
> This is some text.
> This *looks* like it might
> be indented wrongly, but...
> ...in fact this blockquote is
> OK, so it isn't.
> Does that "fall out" ok with your current parser?
This is some text.
like it might
be indented wrongly, but...
...in fact this blockquote is
OK, so it isn't.
> You're assuming that the "author" gives a toss - that they come in to
> edit a Wiki page (for instance) and actually bother to read it
> afterwards to make sure it makes sense. I bet this isn't always so.
> I'm assuming that the reader should be given a chance to make
> sense out of what a poor author wrote,
I'm pretty sure that even if the XML above were translated to HTML, a
reader would be able to figure out that there was some crummy
indentation. If a community suffered enough from documents with crummy
indentation from authors who never bothered to go back and read their
contributions, I suspect they'd add a "click here to read the original
reST" button. :)