openstack team mailing list archive

[Anne Gentle <anne@xxxxxxxxxxxxx>]

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 <al4321@xxxxxxxxx> wrote:
> On Tue, Feb 28, 2012 at 12:55 AM, Anne Gentle
> <annegentle@xxxxxxxxxxxxxxxxxx> 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     : openstack@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~openstack
> More help   : https://help.launchpad.net/ListHelp