Hi Andreas, If we would end up moving more guides to the project tree then it will be confusing having multiple top level docs folder in a basically code repository.
Can that be an option to have a top level 'doc' folder and having sub-folders under like 'doc/developer', 'doc/install-guide', etc.? Thanks and Best Regards, /Ildikó > -----Original Message----- > From: Andreas Jaeger [mailto:a...@suse.com] > Sent: June 28, 2016 15:12 > To: Ildikó Váncsa; openstack-d...@lists.openstack.org > Cc: openstack-dev@lists.openstack.org > Subject: Re: [OpenStack-docs] [telemetry] Ceilometer and Aodh install guide(s) > > On 2016-06-28 14:55, Ildikó Váncsa wrote: > > [...] > > I have a third less urgent question. The install-guide has it's own folder > > at the same level where these two projects have their 'doc' > folder. I would assume other projects have the same or similar folder for the > developer docs. Would that be reasonable/possible to > have one main 'doc' folder for all the docs? > > I understand the sentiment. The install-guide is a separate book, as > Sean Dague called it nicely, which gets published to a different place, > integrated into the full Install Tutorial. If you make it part of the > developer documentation, it might integrate more nicely there but not in > the overall cross-project Install Tutorial. Developer documentation is a > separate book already and placing several books under doc will need even > further changes to make it clear what goes where and how to publish. > > So, I think the top-level folder is the best place for this, > > Andreas > -- > Andreas Jaeger aj@{suse.com,opensuse.org} Twitter: jaegerandi > SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany > GF: Felix Imendörffer, Jane Smithard, Graham Norton, > HRB 21284 (AG Nürnberg) > GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126 __________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev