[Openstack-docs] What's Up Doc? Special Summit Edition Nov 5 2013
Nermina Miller
nerminamiller at gmail.com
Tue Nov 5 18:37:11 UTC 2013
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. - 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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20131105/f72719a8/attachment-0001.html>
More information about the Openstack-docs
mailing list