[Openstack-docs] Folder renaming in openstack-manuals

Sean Roberts seanrob at yahoo-inc.com
Wed Sep 4 18:24:58 UTC 2013


Fyi, training already follows folder/pom plus source. I did it to reduce confusion with new contributors. 

Along the same lines of house cleaning, I'd like to revive the request to include support for set along with book, chapter, section. We have four books that I would like to produce and establish as separate but similar. Right now I cannot do that. Should I create a bug to restart the debate?

~sean

On Sep 4, 2013, at 7:56, "Andreas Jaeger" <aj at suse.com> wrote:

> On 09/04/2013 04:40 PM, Diane Fleming wrote:
>> Andreas, 
>> 
>> I agree with getting rid of the parent directories: doc/src/docbkx.
>> 
>> As for the src directory inside a book directory, I think we need those -
>> to me the structure should be:
>> 
>> 
>> book-folder
>>    pom.xml
>>    src
>>        figures
>>        wadls
>>        examples
>>        (whatever)
>>    target
>>        ŠŠ
>> 
>> 
>> To me, this is a cleaner structure and easier to navigate.
> 
> Right now we're inconsistent, we have these few directories with src:
> basic-install/src
> cli-guide/src
> docbkx-example/src
> openstack-user-admin/src
> openstack-user/src
> 
> The rest is without. I'd like first consistency and not two different
> ways. My preference is to remove src.
> 
> Btw. my structure suggestion is:
> book-folder
>    pom.xml
>    figures
>    examples
>    (whatever)
>    target
>       ....
> 
> Andreas
> -- 
> Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
>  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
>   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
>    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126
> 
> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs



More information about the Openstack-docs mailing list