[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