[Openstack-docs] config reference guide
Tom Fifield
tom at openstack.org
Mon Sep 2 07:51:56 UTC 2013
FYI Summer has started a work in progress here:
https://review.openstack.org/#/c/44641/
On 02/09/13 11:20, Summer Long wrote:
> Of course! I just don't want to step on toes, and I know that others
> have already been doing work. And I'm not sure where the book is, in
> that 'move stuff' process.
>
>
> Summer Long
> OpenStack Documentation
> Engineering Content Services
>
> Red Hat Asia Pacific
> Brisbane, Australia
> slong at redhat.com <mailto:slong at redhat.com>
>
> On 09/02/2013 11:00 AM, Tom Fifield wrote:
>> 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