[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