[OpenStack-docs] Reviewed page for Conventions and Style guide?

Anne Gentle annegentle at justwriteclick.com
Sat Nov 8 21:40:30 UTC 2014


My first thought is move off the wiki sends a message that a deliverable is a style guide and I'm not at all ready for that shift. There are way too many docs to deliver. 

Let me think about it but I had an immediate gut reaction I had to share. It was "blerg!" :)

Anne Gentle
Content Stacker
anne at openstack.org


> On Nov 8, 2014, at 1:27 PM, Andreas Jaeger <aj at suse.com> wrote:
> 
> Discussing the style guide with the infra-team, Jim Blair suggested to
> move the content from the wiki to a permanent place - like the infra
> team moves content from the wiki to infra-manuals.
> 
> We could place the content in openstack-manuals and publish from there.
> This would give us the advantage of a reviewed content and record of
> changes.
> 
> The infra team also offered infra-manuals as place for it.
> 
> So, let's discuss this: What do you think of moving?
> * Should we move the style guide to a git repository?
> * If yes, which one (openstack-manual, infra-manuals, or any other
> proposal)?
> * If yes, which format (Docbook or RST)?
> 
> Andreas
> -- 
> Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
>  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
>   GF:Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB 21284 (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