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

Nermina Miller nerminamiller at gmail.com
Tue Nov 5 18:18:28 UTC 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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20131105/be8807b5/attachment.html>


More information about the Openstack-docs mailing list