[Buildbot] #3468: [docs] section numbering produces confusing labels like "2.4.5.4.2.4.1.1. CoreOS"

[Buildbot trac]

#3468: [docs] section numbering produces confusing labels like "2.4.5.4.2.4.1.1.
CoreOS"
----------------------+-----------------------
Reporter:  rutsky     |      Owner:
    Type:  undecided  |     Status:  new
Priority:  major      |  Milestone:  undecided
 Version:  master     |   Keywords:
----------------------+-----------------------
 While it's good to have

 {{{
 1. Buildbot Tutorial
 2. Buildbot Manual

     2.1. Introduction
     2.2. Installation
     2.3. Concepts
 }}}

 It's confusing to have in titles

 {{{
 2.4.5.4.2.4. Docker latent worker
 2.4.5.4.2.4.1. Docker Installation
 2.4.5.4.2.4.1.1. CoreOS
 2.4.5.4.2.4.1.2. boot2docker
 }}}

 e.g. here: http://docs.buildbot.net/latest/manual/cfg-workers-docker.html

 Is there option in Sphinx to generate numbers only to specific depth of
 headers?
 Maybe other way to look them better?

--
Ticket URL: <http://trac.buildbot.net/ticket/3468>
Buildbot <http://buildbot.net/>
Buildbot: build/test automation