Re: [openstack-dev] [OpenStack-docs] Admin guide in-tree?

2016-10-06 Thread Lana Brindley
(Adding the dev list to cc, as I think this conversation deserves a wider audience) Thanks for this feedback. I'm really glad that the new Install Guide model is working out well for people! Since our new Install Guides have only just been published, at this stage I'm intending to gather some

Re: [openstack-dev] [OpenStack-docs] Admin guide in-tree?

2016-10-07 Thread Jay Faulkner
I'm not necessarily just asking for it to be done -- I'm curious what the scope of work is because I'm potentially willing to help (and find folks to help) get it done sooner. If the docs team does not support the admin guide in-tree until Pike, It'll be Q or later before other projects can util

Re: [openstack-dev] [OpenStack-docs] Admin guide in-tree?

2016-10-09 Thread Lana Brindley
Thanks for the offer. The scope of the work is probably not huge, based on what we know from the Install Guide. We should be able to more or less copy what we did there. However, I want to collect data based on that experience before we begin, rather than barrelling on down that road. Additional

Re: [openstack-dev] [OpenStack-docs] Admin guide in-tree?

2016-10-09 Thread Steve Martinelli
On Oct 9, 2016 6:57 PM, "Lana Brindley" wrote: > > Why the rush? I think its more eagerness than rush. Project teams made a lot of head way with the API ref and install guides being in-tree that they want to keep the momentum with the admin guide. _

Re: [openstack-dev] [OpenStack-docs] Admin guide in-tree?

2016-10-09 Thread Lana Brindley
On 10/10/16 09:37, Steve Martinelli wrote: > On Oct 9, 2016 6:57 PM, "Lana Brindley" > wrote: >> >> Why the rush? > > I think its more eagerness than rush. Project teams made a lot of head way > with the API ref and install guides being in-tree that they want t

Re: [openstack-dev] [OpenStack-docs] Admin guide in-tree?

2016-10-09 Thread Andreas Jaeger
On 2016-10-10 01:37, Steve Martinelli wrote: > On Oct 9, 2016 6:57 PM, "Lana Brindley" > wrote: >> >> Why the rush? > > I think its more eagerness than rush. Project teams made a lot of head > way with the API ref and install guides being in-tree that they want

Re: [openstack-dev] [OpenStack-docs] Admin guide in-tree?

2016-10-10 Thread Lana Brindley
On 10/10/16 16:25, Andreas Jaeger wrote: > On 2016-10-10 01:37, Steve Martinelli wrote: >> On Oct 9, 2016 6:57 PM, "Lana Brindley" > > wrote: >>> >>> Why the rush? >> >> I think its more eagerness than rush. Project teams made a lot of head >> way with the API ref

Re: [openstack-dev] [OpenStack-docs] Admin guide in-tree?

2016-10-11 Thread Ruby Loo
>From my point of view, the rush is so that we can be more efficient with all of our time/efforts. In ironic, we have a bit of a mess. We now have duplicated (and perhaps out-of-sync) admin-related information in our developer docs [1] as well as in the official admin guide [2] -- the latter conten