Paul C. Anagnostopoulos via llvm-dev
2020-Aug-03 00:33 UTC
[llvm-dev] Numbering sections in documents
I think the LLVM documentation set would benefit from having numbered sections and subsections. It's pretty much a rule in the technical publishing business that at least two levels of numbering are included, both for referencing and to give the reader a better idea of the outline of the text. This may have been considered previously and rejected. I'd be interesting in opinions.
Nicolai Hähnle via llvm-dev
2020-Aug-04 20:53 UTC
[llvm-dev] Numbering sections in documents
On Mon, Aug 3, 2020 at 2:34 AM Paul C. Anagnostopoulos via llvm-dev <llvm-dev at lists.llvm.org> wrote:> I think the LLVM documentation set would benefit from having numbered sections and subsections. It's pretty much a rule in the technical publishing business that at least two levels of numbering are included, both for referencing and to give the reader a better idea of the outline of the text. > > This may have been considered previously and rejected. I'd be interesting in opinions.FWIW, I'd be in favor. Cheers, Nicolai -- Lerne, wie die Welt wirklich ist, aber vergiss niemals, wie sie sein sollte.