[Openstack-docs] config-ref blueprints

Gauvain Pocentek gauvain.pocentek at objectif-libre.com
Tue May 13 22:08:26 UTC 2014


Le 2014-05-13 23:41, Anne Gentle a écrit :
> On Tue, May 13, 2014 at 2:28 PM, Gauvain Pocentek
> <gauvain.pocentek at objectif-libre.com> wrote:
> 
>> Hello guys,
>> 
>> I've drafted a couple blueprints for the config ref, I'd like to hear 
>> some feedback. A live discussion at the summit would be nice but I 
>> wanted to include everyone in the loop.
>> 
>> [1] deals with the fact that we don't have a single page listing all 
>> available options for each OS project (AFAIK).
> 
> Do you have a request from the community for this single page
> listing? I am not getting this type of input informally so I am not
> sure where this request comes from.

I don't think we've had a request from the community. But we discussed 
this kind of changes a while ago 
(http://lists.openstack.org/pipermail/openstack-docs/2014-March/004036.html).


>> For [2] the idea is to improve the documentation about options common 
>> to all the projects, but also avoid duplication.
> 
> I think avoiding duplication is a good goal here. 
> 
> A higher priority request to me, that I've gotten from various
> conversations, is that the reference listing is great, but the more
> requested next document is for combinations of configurations for a
> particular goal in mind. I think some of this type of documentation
> may come out of the design guide book sprint, but I'd also like us to
> think about how we might write this type of documentation.

Some kind of configuration cookbook? I like the idea :)

Isn't that something that would better be sitting in the Cloud Admin 
Guide rather than the config-ref? Either way it's something that would 
probably be very useful to users, and that would match the idea behind 
the spec (how do I use Qpid/Rabbit? How do I use keystone token 
authentication?).

> 
> Thanks Gauvain for brining this to the list!

Thanks for your answer :)

Gauvain



More information about the Openstack-docs mailing list