[Openstack-docs] config reference guide

Summer Long slong at redhat.com
Tue Sep 3 23:13:28 UTC 2013


Hi Nermina,
I finished the config ref general restructure yesterday, and definitely 
didn't touch any install files. So you're good to go.:)

cheers, Summer

Summer Long
OpenStack Documentation
Engineering Content Services

Red Hat Asia Pacific
Brisbane, Australia
slong at redhat.com <mailto:slong at redhat.com>

On 09/04/2013 03:58 AM, Nermina Miller wrote:
> Summer,
>
> I've begun the migration of files to what will be OpenStack Cloud 
> Admin Guide based on this blueprint: 
> https://wiki.openstack.org/wiki/Blueprint-os-admin-docs. I'm not 
> deleting anything until both of us are done. Are you also 
> appropriating the install files? I have a deadline to move the files 
> until tomorrow, so I plan to finish by 5 pm EST.
>
> Please let me know if you have any questions.
>
> Thanks!
>
> Nermina
>
>
> On Mon, Sep 2, 2013 at 8:49 AM, Anne Gentle <anne at openstack.org 
> <mailto:anne at openstack.org>> wrote:
>
>
>
>     On Sun, Sep 1, 2013 at 8:20 PM, Summer Long <slong at redhat.com
>     <mailto:slong at redhat.com>> 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.
>
>
>     Yay, please do! With git I'm not too worried about toe-stepping
>     but it's good of you to let your intentions be known.
>
>     Today's a holiday in the US so I'll be less responsive than usual,
>     but I do want to dig into the Object Storage config tables this
>     week again. But I'm happy to have you organize and do whatever you
>     see fit all along.
>
>     Anne
>
>
>
>
>
>         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>
>>>         <mailto: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>
>>>>         <mailto: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>
>>>>         <mailto: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>
>>>>>         <mailto: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>
>>>>>         <mailto:slong at redhat.com> <mailto:slong at redhat.com>
>>>>>
>>>>>
>>>>
>>>>
>>>
>>
>
>
>
>     _______________________________________________
>     Openstack-docs mailing list
>     Openstack-docs at lists.openstack.org
>     <mailto:Openstack-docs at lists.openstack.org>
>     http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
>
>
>
> -- 
> Thank you!
>
> Nermina Miller
> Tech Writer and Editor

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130904/ae575a5a/attachment-0001.html>


More information about the Openstack-docs mailing list