Red Hat Bugzilla – Bug 967359
duplicated indexes in summary
Last modified: 2015-02-20 11:25:08 EST
Created attachment 753374 [details]
highlight of the overlapping indexes
Section Number and Name:
Describe the issue:
The first 2 parts of the introduction (1 Document conventions and 2. We Need Feedback!) have indexes which overlap with those of the first 2 chapters and make navigation via the summary links incorrect
See the attached snapshot
Suggestions for improvement:
Define correct indexes
The appearance of the numbering within prefaces/introductions is how the books build, and this is how it appears in all of the documents on the Customer portal, numbered like this: The main sections of the prefaces are numbers as 1, 2, etc. And the main chapters are numbered as 1, 2.
I will look into finding out where to address this BZ, but it's not specific to this document.
What can I say? 25 years ago when I started to use multilevel lists, having the summary not functional because of incorrect indexes was considered an error and led to the proof reader rejecting that particular version of the document. But of course one can always go with a "good enough" policy.
I can't say that I like it myself.
With 6.6 Beta about to go out the door, for administrative reasons I'm moving this to 6.7 until I can determine where to pass this information along. It may be an RFE for publican itself -- that's my current thought -- which is not connected to any particular release.
I am no longer seeing this issue in the latest builds on the Portal (there has been some work on re-doing the formatting through Publican, including streamlining what appears) so I'm closing this Bug.