[OpenStack-docs] [telemetry] Ceilometer and Aodh install guide(s)

Ildikó Váncsa ildiko.vancsa at ericsson.com
Tue Jun 28 12:55:56 UTC 2016


I'm currently working on to move the Install Guide for Ceilometer [1] and Aodh [2] under the project trees. I faced with a few difficulties so far about which I would like to ask your opinion.

First of all these two projects are under the Telemetry umbrella, so they are not completely separate. I tried to name the services in the documents accordingly in the files. My question here would be whether these two guides will be included in the overall document as two totally standalone services or we can link them together somehow?

The other question I had in mind is in connection with removing ".. only::". As Ceilometer is integrated with several other projects it needs additional configuration steps, where we have distro specific steps to follow. I chose the direction of extracting the common parts and reused them in the distro specific files. The end result still looks ugly and I have concerns about maintainability. We merged a first version of the structure, but I'm happy to change if we can come up with a better solution. Do you have suggestions on this?

I have a third less urgent question. The install-guide has it's own folder at the same level where these two projects have their 'doc' folder. I would assume other projects have the same or similar folder for the developer docs. Would that be reasonable/possible to have one main 'doc' folder for all the docs?

Thanks and Best Regards,

[1] https://review.openstack.org/#/c/330051/ 
[2] https://review.openstack.org/#/c/330048/ 

More information about the OpenStack-docs mailing list