Re: Comments on Learning Manual 3 -- Fundamental concepts

[Valentin Villenave]

2008/8/9 Graham Percival <address@hidden>:

> This must be a Frenchism; I winced when I saw it in some of
> Valentin's text.itely changes.  Why on earth remove the
> parentheses?  They help clarify the structure of the sentence.

Actually, this is a Johnism (I don't know why he keeps asking us to
remove parentheses).

And I agree that some of my sentences were better with parentheses. So
if no Grahamism objects, I'll put them back again.

> Other than specific warnings about formatting issues, don't add
> comments to the .tely files.  If you feel the need to comment
> something about the content, it just means that the docs aren't
> clear enough.

What I have in mind when commenting an .itely file is that comments
may be useful for the next documentation team (when the guys will
start their own Grand Documentation Project in 10 years).
In this specific case, theoretically doc writers are aware that the
engraver is not used anymore...

Cheers,
Valentin