Hi Goutham, Thanks, I already checked your solution briefly.
I will wait until there is some decision about the global way forward. If '.. only::' remains an option I might change the Ceilometer setup back. Best Regards, /Ildikó > -----Original Message----- > From: Ravi, Goutham [mailto:[email protected]] > Sent: June 28, 2016 15:32 > To: Ildikó Váncsa; [email protected] > Cc: [email protected] > Subject: Re: [OpenStack-docs] [telemetry] Ceilometer and Aodh install guide(s) > > Hi Ildikó, > > Please take a look at the tooling in https://review.openstack.org/#/c/317152/ > - I tried preserving the ‘only::’ tags because I had a > similar concern about all the common parts to someone compiling the install > guide from time to time. We were discussing whether > this was a good solution as opposed to using ‘include’ directives with > distro-specific files referencing common sections; or ignore both > and maintain four different files (obs, debian, rdo, ubuntu) with common > sections included within each. > > Thanks, > Goutham > > On 6/28/16, 8:55 AM, "Ildikó Váncsa" <[email protected]> wrote: > > Hi, > > 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, > 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
