ubuntu-packaging-guide-team team mailing list archive

[Jonathan Riddell <jriddell@xxxxxxxxxx>]

** Summary changed:

- Table of contents
+ Enumberate chapters and table of contents

** Changed in: ubuntu-packaging-guide
   Importance: Undecided => Low

-- 
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:
  Enumberate chapters and 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

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu-packaging-guide/+bug/737455/+subscriptions