[Doc-SIG] suggestions for a PEP

[Tony J Ibbs (Tibs)]

Edward Welbourne wrote:
> Tony, then Edward:
> >> On the other hand, sometimes people want that effect (the
> >> difficulties of mixing presentation and markup, and not being
> >> specificallty a typesetting language - ho hum).
>
> > Too bad for them. :)  If they really need *that much* control over
> > their typesetting, they shouldn't be using ST.
>
> If they're thinking that hard about layout, they aren't concentrating
> hard enough on writing API documentation and the result isn't going to
> be maintainable ('cos when I next fix a bug in their code, and update
> the docs, I'm going to have zero patience with their fancy layout, so
> I'm going to normalise it to something straightforward).

I agree. I *think* we were talking about indented paragraphs and lists -
it may well get simplified.

	(heh, we all agree - let's take over the world)

Tibs

--
Tony J Ibbs (Tibs)      http://www.tibsnjoan.co.uk/
"How fleeting are all human passions compared with the massive
continuity of ducks." - Dorothy L. Sayers, "Gaudy Night"
My views! Mine! Mine! (Unless Laser-Scan ask nicely to borrow them.)