It's not a "dislike" - rather it fulfills a need for reuse of content so that sections are not rigidly numbered for certain types of deliverables, such as the admin guides.
The requirement for a unique identifier is filled by having unique IDs for each section that then create an HTML page. Please copy and paste URLs when you need to discuss a section in IRC or when logging bugs. For API reference guides auto-numbering meets a need for a section reference. I believe the use case is correct for each type of document. I'd be happy to talk with you on IRC tomorrow to discuss our doc toolchain and some style decisions that have been made on the way as well as the mechanics. I'm typically online from 8-5 GMT-6. Anne On Mon, Feb 27, 2012 at 4:59 PM, Alexey Eromenko <[email protected]> wrote: > On Tue, Feb 28, 2012 at 12:55 AM, Anne Gentle > <[email protected]> wrote: >> Yes it is a flag in the build file, pom.xml. Based on prior discussion I >> have chosen not to use autonumber for admin guide output. The settings are a >> postscript in my prior email. >> > > Is there a specific reason to dislike auto-numbers indexing ? > > For me, the big reason to *like* auto-numbers, is that it makes it > easy to share config steps on IRC. > > -- > -Alexey Eromenko "Technologov" > > _______________________________________________ > Mailing list: https://launchpad.net/~openstack > Post to : [email protected] > Unsubscribe : https://launchpad.net/~openstack > More help : https://help.launchpad.net/ListHelp _______________________________________________ Mailing list: https://launchpad.net/~openstack Post to : [email protected] Unsubscribe : https://launchpad.net/~openstack More help : https://help.launchpad.net/ListHelp
