> -----Original Message----- > From: Ildikó Váncsa [mailto:ildiko.vancsa at ericsson.com] > Sent: Tuesday, June 28, 2016 7:56 AM > To: openstack-docs at lists.openstack.org > Cc: openstack-dev at lists.openstack.org > Subject: [OpenStack-docs] [telemetry] Ceilometer and Aodh install > guide(s) snip > > 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? > [<rcaballeroMX>] I would suggest a modular approach with the use of .. include:: It would look something like this: ================== Instructions for Ubuntu ================== .. include:: file-with-common-steps.rst .. include:: file-with-ubuntu-steps.rst Then you can do the same for each distro. Having all the separate procedures in different files should help solve your maintainability concerns. Regards, Rodrigo Caballero snip > > Thanks and Best Regards, > Ildikó > > [1] https://review.openstack.org/#/c/330051/ > [2] https://review.openstack.org/#/c/330048/ > > _______________________________________________ > OpenStack-docs mailing list > OpenStack-docs at lists.openstack.org > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs