[Openstack-docs] doc-specs repo?
Andreas Jaeger
aj at suse.com
Fri Jun 27 12:59:23 UTC 2014
On 06/27/2014 02:40 PM, Anne Gentle wrote:
>
>
>
> On Wed, Jun 25, 2014 at 3:22 PM, Sean Roberts <seanrob at yahoo-inc.com
> <mailto:seanrob at yahoo-inc.com>> wrote:
>
> Having many sub-directories follows the docs layout because of the
> different repos. If we go that way then we would need to treat each
> project directory separate with their own release directories like
> /doc-spec/training-guides/juno
>
> The drawback will be that this makes finding approved specs
> difficult. The other projects are using the single /specs directory
> with a flat naming scheme like ml2-dell-afc-mech-driver.rst.
>
> For specs that overlay projects like install-guides and
> training-guides, it will be confusing which, what, where. Because of
> this I vote for this structure
>
> doc-spec -
> specs -
> juno - (all docs program juno cycle RST reside here)
> tests -
> doc -
>
>
>
> Yep, looks like that's the accepted structure.
>
> Here's the starting openstack-infra/config patch:
>
> https://review.openstack.org/103115
>
> and I'll populate the repo with this repo:
>
> https://github.com/annegentle/docs-specs
That repo contains many references to Glance - do you want to update it
first or do this later?
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
More information about the Openstack-docs
mailing list