Re: [openstack-dev] [kolla][infra] How to handle doc in kolla and kolla-ansible

2016-11-21 Thread Andreas Jaeger
On 11/21/2016 08:25 PM, Steven Dake (stdake) wrote: > Andreas, > > Just thinking about all the documentation rework that would be necessary… > Perhaps it just confuses me ;) I think the short term result would be mass > confusion as we sort out the next iteration of the documentation in this

Re: [openstack-dev] [kolla][infra] How to handle doc in kolla and kolla-ansible

2016-11-21 Thread Steven Dake (stdake)
Andreas, Just thinking about all the documentation rework that would be necessary… Perhaps it just confuses me ;) I think the short term result would be mass confusion as we sort out the next iteration of the documentation in this structure since the docs are well tested at present and I’m a

Re: [openstack-dev] [kolla][infra] How to handle doc in kolla and kolla-ansible

2016-11-21 Thread Jay Pipes
On 11/21/2016 07:43 AM, Andreas Jaeger wrote: On 2016-11-21 13:24, Steven Dake (stdake) wrote: Pete, The main problem with that is publishing docs to docs.oo which would then confuse the reader even more then they are already confused by reading our docs ;) Regards -steve From: Pete Birley m

Re: [openstack-dev] [kolla][infra] How to handle doc in kolla and kolla-ansible

2016-11-21 Thread Andreas Jaeger
On 2016-11-21 13:24, Steven Dake (stdake) wrote: > Pete, > > The main problem with that is publishing docs to docs.oo which would > then confuse the reader even more then they are already confused by > reading our docs ;) > > Regards > -steve > > > From: Pete Birley mailto:pete@port.direct>> >

Re: [openstack-dev] [kolla][infra] How to handle doc in kolla and kolla-ansible

2016-11-21 Thread Andreas Jaeger
On 2016-11-21 13:00, Steven Dake (stdake) wrote: > Yup this is a real challenge to sort out properly. I’ve included infra for > their guidance (thanks people :). > > Here is the issue > > Each package should include enough docs that it stands alone after a git > checkout (IMO). We also publis

Re: [openstack-dev] [kolla][infra] How to handle doc in kolla and kolla-ansible

2016-11-21 Thread Steven Dake (stdake)
Pete, The main problem with that is publishing docs to docs.oo which would then confuse the reader even more then they are already confused by reading our docs ;) Regards -steve From: Pete Birley mailto:pete@port.direct>> Reply-To: "OpenStack Development Mailing List (not for usage questions)

Re: [openstack-dev] [kolla][infra] How to handle doc in kolla and kolla-ansible

2016-11-21 Thread Steven Dake (stdake)
Yup this is a real challenge to sort out properly. I’ve included infra for their guidance (thanks people :). Here is the issue Each package should include enough docs that it stands alone after a git checkout (IMO). We also publish docs to docs.oo which should IMO contain one set of docs for