← Back to team overview

ubuntu-packaging-guide-team team mailing list archive

[Bug 737455] [NEW] Table of contents

 

Public bug reported:

In the current packaging guide, sections (and subsections) are numbered
only in the table of contents (1. Introduction, 1. Where to begin, 2.
Prerequisites). I believe it is useful repeat these identifiers also in
the guide (not only in the contents). The proposed behavior for example
is generally used by Latex and is also used in Debian guides like
http://www.debian.org/doc/FAQ/ch-uptodate.en.html

I believe that also the numeration used in the table of contents of the current packaging guide is improvable using a progressive numerations that takes into consideration the hierarchy of each section. So for example the current table of contents from:
1. Introduction
    1. Where to begin
    2. Prerequisites
could became something like:
1. Introduction
    1.1 Where to begin
    1.2 Prerequisites

** Affects: ubuntu-packaging-guide
     Importance: Undecided
         Status: New

-- 
You received this bug notification because you are a member of Ubuntu
Packaging Guide Team, which is subscribed to Ubuntu Packaging Guide.
https://bugs.launchpad.net/bugs/737455

Title:
  Table of contents

Status in Ubuntu Packaging Guide:
  New

Bug description:
  In the current packaging guide, sections (and subsections) are
  numbered only in the table of contents (1. Introduction, 1. Where to
  begin, 2. Prerequisites). I believe it is useful repeat these
  identifiers also in the guide (not only in the contents). The proposed
  behavior for example is generally used by Latex and is also used in
  Debian guides like http://www.debian.org/doc/FAQ/ch-uptodate.en.html

  I believe that also the numeration used in the table of contents of the current packaging guide is improvable using a progressive numerations that takes into consideration the hierarchy of each section. So for example the current table of contents from:
  1. Introduction
      1. Where to begin
      2. Prerequisites
  could became something like:
  1. Introduction
      1.1 Where to begin
      1.2 Prerequisites



Follow ups

References