[Openstack-docs] config reference guide

Tom Fifield tom at openstack.org
Mon Sep 2 01:00:45 UTC 2013


Can we sign you up? :D


On 02/09/13 10:59, Summer Long wrote:
> It's just a matter of structure for the guide. I definitely don't want
> to create a blueprint that won't be used just because there isn't one!
>
> I guess the real question is: if there isn't a blueprint, is someone
> already tasked with making the Config Reference structure more coherent
> once all the content has been moved from other guides?
>
> thanks, Summer
>
> Summer Long
> OpenStack Documentation
> Engineering Content Services
>
> Red Hat Asia Pacific
> Brisbane, Australia
> slong at redhat.com <mailto:slong at redhat.com>
>
> On 08/30/2013 11:55 PM, Anne Gentle wrote:
>>
>>
>>
>> On Thu, Aug 29, 2013 at 6:50 PM, Summer Long <slong at redhat.com
>> <mailto:slong at redhat.com>> wrote:
>>
>>     Thanks Anne, and looping in the mailing list.
>>     I was just wondering if there is a blueprint for the Config Ref
>>     guide from which you and others are working (other than the
>>     paragraph in the Restructure doc).
>>
>>     If there is not, would you like me to redo the Etherpad to include
>>     the HowTos, and then move that into a visible blueprint? (It
>>     doesn't really matter what I thought the intent was, just what is
>>     happening going forward. :>)
>>
>>
>> My first instinct is that it's really late in the release for new
>> blueprints, but if it helps you, go ahead. Outlines help me a BUNCH so
>> if that's what you need, do it. You can also just add the outline to
>> the wiki page.
>>
>> I know I told Nermina to update the admin blueprint, but it already
>> existed. And really she's updating an outline.
>>
>> If you want to get started on a blueprint for the next release, that's
>> fine too.
>>
>> Anne
>>
>>
>>     thanks, Summer
>>
>>
>>
>>
>>
>>     Summer Long
>>     OpenStack Documentation
>>     Engineering Content Services
>>
>>     Red Hat Asia Pacific
>>     Brisbane, Australia
>>     slong at redhat.com <mailto:slong at redhat.com>
>>
>>     On 08/30/2013 02:58 AM, Anne Gentle wrote:
>>>     The etherpad you reference does pull in info from the Admin
>>>     Guides. The resulting set must be bigger than you had imagined.
>>>     :) The original blueprint is
>>>     https://wiki.openstack.org/wiki/Blueprint-restructure-documentation#OpenStack_Configuration_Reference,
>>>     and it has the Admin Guides as a source of info as well.
>>>
>>>     When you say "had thought that the use cases and options would be
>>>     listed together with the files" what do you mean?
>>>
>>>     Happy to discuss further on the mailing list as well so others
>>>     can benefit.
>>>     Anne
>>>
>>>
>>>     On Thu, Aug 29, 2013 at 12:57 AM, Summer Long <slong at redhat.com
>>>     <mailto:slong at redhat.com>> wrote:
>>>
>>>         Hi there,
>>>         Can you tell me a bit about the state of the Config Ref
>>>         guide, and its direction? I'd not realised all the config was
>>>         being moved from individual project guides, and had been
>>>         under the impression that the Ref would be initially a
>>>         smaller, based-on-files reference (not including all the
>>>         project's how-to procedures).
>>>
>>>         Is there now a blueprint from which you're working? I started
>>>         working with Tom to put together a draft
>>>         (https://etherpad.openstack.org/Config_Reference-4.0) a while
>>>         back, had thought that the use cases and options would be
>>>         listed together with the files....but then content started
>>>         moving.
>>>
>>>         Just trying to get my head around it all. :)
>>>
>>>         thanks, Summer
>>>         --
>>>         Summer Long
>>>         OpenStack Documentation
>>>         Engineering Content Services
>>>
>>>         Red Hat Asia Pacific
>>>         Brisbane, Australia
>>>         slong at redhat.com <mailto:slong at redhat.com>
>>>
>>>
>>
>>
>




More information about the Openstack-docs mailing list