[Openstack-docs] What's Up Doc? Special Summit Edition Nov 5 2013

Nermina Miller nerminamiller at gmail.com
Wed Nov 6 02:33:45 UTC 2013


No problem. Working on it, so should be done tonight. - Nermina


On Tue, Nov 5, 2013 at 9:20 PM, Anne Gentle
<annegentle at justwriteclick.com>wrote:

>
>
>
> On Tue, Nov 5, 2013 at 12:37 PM, Nermina Miller <nerminamiller at gmail.com>wrote:
>
>> I recall from the networking part of the install guide that they would
>> need to know or at least refer to the plugin configuration info. I'm
>> actually going to put a bunch of configuration info in the Config Ref to
>> support that chapter today. -
>>
>
> Actually, I'm hoping you can find a place for their plugins in the Cloud
> Admin Guide so we don't have to tell them about a double-hop, I don't think
> they'd be happy to hear about bouncing around.
>
> The movement of content is a big reason why I'm a bit concerned and want
> to ensure we're confident this is a final landing place. We have a bit of
> "selling" to do in the wider community. I think separate reference from
> other types of content is great, just want to be sure the rest of the
> projects "get it" also.
>
> Thanks!
> Anne
>
>
>> Nermina
>>
>>
>>
>> On Tue, Nov 5, 2013 at 1:32 PM, Diane Fleming <
>> diane.fleming at rackspace.com> wrote:
>>
>>>   Keeping it separate is fine – I wasn't aware the config ref was for
>>> more than just the admin role.
>>>
>>>
>>>   *Diane*
>>>  *----------------------------------------------*
>>>  Diane Fleming
>>>  Software Developer II - US
>>>  diane.fleming at rackspace.com
>>> Cell  512.323.6799
>>> Office 512.874.1260
>>>  Skype drfleming0227
>>> Google-plus diane.fleming at gmail.com
>>>
>>>   From: Nermina Miller <nerminamiller at gmail.com>
>>> Date: Tuesday, November 5, 2013 12:30 PM
>>> To: Diane Fleming <diane.fleming at rackspace.com>
>>> Cc: Nicholas Chase <nchase at mirantis.com>, "
>>> openstack-docs at lists.openstack.org" <openstack-docs at lists.openstack.org>
>>>
>>> Subject: Re: [Openstack-docs] What's Up Doc? Special Summit Edition Nov
>>> 5 2013
>>>
>>>   I like the idea of having the Config Ref be a complete reference for
>>> all roles so it can be maintained in one place and referred to from other
>>> guides, but I think you have more experience with the users to be able to
>>> gauge that. - Nermina
>>>
>>>
>>> On Tue, Nov 5, 2013 at 1:22 PM, Diane Fleming <
>>> diane.fleming at rackspace.com> wrote:
>>>
>>>>   Do we need two books?
>>>>
>>>>  Can the reference tables be appendices in the Cloud Admin Guide, and
>>>> rename that book "Cloud Admin Guide and Reference"?
>>>>
>>>>  I'm fine with it either way – though it might be nice to have
>>>> everything in one place given the book isn't too big.
>>>>
>>>>   *Diane*
>>>> *----------------------------------------------*
>>>> Diane Fleming
>>>>  Software Developer II - US
>>>>  diane.fleming at rackspace.com
>>>> Cell  512.323.6799
>>>> Office 512.874.1260
>>>>  Skype drfleming0227
>>>> Google-plus diane.fleming at gmail.com
>>>>
>>>>   From: Nermina Miller <nerminamiller at gmail.com>
>>>> Date: Tuesday, November 5, 2013 12:18 PM
>>>> To: Nicholas Chase <nchase at mirantis.com>
>>>> Cc: "openstack-docs at lists.openstack.org" <
>>>> openstack-docs at lists.openstack.org>
>>>> Subject: Re: [Openstack-docs] What's Up Doc? Special Summit Edition
>>>> Nov 5 2013
>>>>
>>>>   I just wonder what would happen if an install gal/guy needs to know
>>>> how to configure something and it's in the Cloud Admin Guide instead of
>>>> Config Ref. - Nermina
>>>>
>>>>
>>>> On Tue, Nov 5, 2013 at 1:10 PM, Nicholas Chase <nchase at mirantis.com>wrote:
>>>>
>>>>>
>>>>>
>>>>> On 11/5/2013 12:37 PM, Anne Gentle wrote:
>>>>>
>>>>>>
>>>>>>
>>>>>>
>>>>>> On Tue, Nov 5, 2013 at 10:02 AM, Nicholas Chase <nchase at mirantis.com
>>>>>>  <mailto:nchase at mirantis.com>> wrote:
>>>>>>
>>>>>>         Restructure:
>>>>>>         Despite the tradeoff that we have to re-communicate some more
>>>>>>         moves to
>>>>>>         all the teams, we want to trim the configuration reference
>>>>>> down
>>>>>>         to just
>>>>>>         listings of options, no how-to or explanatory information.
>>>>>> Move this
>>>>>>         type of info to the Cloud Admin Guide. Are we good with this
>>>>>>         plan for
>>>>>>         Icehouse?
>>>>>>
>>>>>>
>>>>>>     Are you suggesting that the Config References just lists
>>>>>> parameters
>>>>>>     without any explanation of what they mean?  I agree with
>>>>>> eliminating
>>>>>>     conceptual or how-to information and moving it to cloud admin, but
>>>>>>     I'm against removing explanations of what the parameters mean/do.
>>>>>>
>>>>>>
>>>>>> No, it'll be a book with just xi:includes of the current tables. What
>>>>>> do
>>>>>> you think?
>>>>>>
>>>>>
>>>>> That makes more sense, as long as it's convenient (read: reasonably
>>>>> intuitive) to find the additional information for those who will need it,
>>>>> regardless of their function.
>>>>>
>>>>>
>>>>> ----  Nick
>>>>>
>>>>> _______________________________________________
>>>>> Openstack-docs mailing list
>>>>> Openstack-docs at lists.openstack.org
>>>>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>>>>>
>>>>
>>>>
>>>>
>>>>  --
>>>> Thank you!
>>>>
>>>>  Nermina Miller
>>>> Tech Writer and Editor
>>>>
>>>
>>>
>>>
>>>  --
>>> Thank you!
>>>
>>>  Nermina Miller
>>> Tech Writer and Editor
>>>
>>
>>
>>
>> --
>> Thank you!
>>
>> Nermina Miller
>> Tech Writer and Editor
>>
>> _______________________________________________
>> Openstack-docs mailing list
>> Openstack-docs at lists.openstack.org
>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>>
>>
>
>
> --
> Anne Gentle
> annegentle at justwriteclick.com
>



-- 
Thank you!

Nermina Miller
Tech Writer and Editor
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20131105/54ca6cf0/attachment-0001.html>


More information about the Openstack-docs mailing list