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

Nicholas Chase nchase at mirantis.com
Tue Nov 5 18:10:32 UTC 2013



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



More information about the Openstack-docs mailing list