[Openstack-docs] Folder renaming in openstack-manuals

Anne Gentle anne at openstack.org
Wed Sep 4 18:27:11 UTC 2013


On Wed, Sep 4, 2013 at 1:24 PM, Sean Roberts <seanrob at yahoo-inc.com> wrote:

> 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?
>
>
Sorry, that fell off my radar as I thought that set "just worked" -- can
you log a bug with details?

Thanks,
Anne


> ~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
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130904/82672d9f/attachment.html>


More information about the Openstack-docs mailing list