> -----Original Message-----
> From: Ildikó Váncsa [mailto:[email protected]]
> Sent: Tuesday, June 28, 2016 7:56 AM
> To: [email protected]
> Cc: [email protected]
> 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
> [email protected]
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
__________________________________________________________________________
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: [email protected]?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

Reply via email to