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. Additionally, I don't feel as though the Install Guide is absolutely complete until we've got the index page done. As I said earlier, there is also the consideration of the short release cycle for Ocata.
One point I will make, though, that is with a Pike schedule, you would have Admin Guides up under this model by the Pike release date (about twelve months from now). We planned the Install Guides at the Austin summit, and have published them with Newton. Why the rush? Lana On 08/10/16 02:13, Jay Faulkner wrote: > 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 utilize it. > That's over a year from today, and I'd rather not have to wait that long to > get a better admin guide up for Ironic. > > Thanks, > Jay Faulkner > OSIC > >> On Oct 6, 2016, at 8:04 PM, Lana Brindley <openst...@lanabrindley.com> wrote: >> >> (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 data on how projects and users are using the >> project-specific Install Guides during the next cycle. I'm also intending to >> spend some time in the Ocata cycle on improving that index page. It's pretty >> ugly right now, and I think there's some serious UX improvements to be >> done. Since Ocata is a short cycle, I'm also conscious of how much the docs >> team might realistically be able to achieve. >> >> All that said, you are certainly not the first to ask if this model can be >> extended! I think it's something that the docs community would like to see, >> and it seems as though it has broad support amongst developers and projects >> as well. So, in short, I think this is a thing that will happen, but >> probably not in Ocata. I'm tentatively willing to tell you that Pike is a >> possibility though ;) >> >> Lana >> >> On 07/10/16 12:43, Steve Martinelli wrote: >>> FWIW, the keystone team would also be interested in this model >>> >>> On Thu, Oct 6, 2016 at 11:40 AM, Jay Faulkner <j...@jvf.cc >>> <mailto:j...@jvf.cc>> wrote: >>> >>> Hi all, >>> >>> For those of you who don't know me, I'm Jay Faulkner and I work on >>> Ironic as the Docs liaison as one of my hats. >>> >>> Ironic launched our install-guide right after newton closed, and >>> backported it, thanks to the changes to make the install-guide available in >>> tree. We're a huge fan of this model, and I'm curious if there's any plans >>> to make this happen for the admin-guide. If not, can someone help me >>> understand the scope of work, presuming it's something that the docs group >>> is interested in. >>> >>> If we can get the technical infrastructure in place to do admin-guide in >>> tree, I'd expect Ironic to quickly adopt it, like we did for the install >>> guide. >>> >>> Thanks, >>> Jay Faulkner >>> OSIC >>> >>> >>> _______________________________________________ >>> OpenStack-docs mailing list >>> openstack-d...@lists.openstack.org >>> <mailto:openstack-d...@lists.openstack.org> >>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs >>> <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs> >>> >>> >>> >>> >>> _______________________________________________ >>> OpenStack-docs mailing list >>> openstack-d...@lists.openstack.org >>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs >>> >> >> -- >> Lana Brindley >> Technical Writer >> Rackspace Cloud Builders Australia >> http://lanabrindley.com >> >> _______________________________________________ >> OpenStack-docs mailing list >> openstack-d...@lists.openstack.org >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs > -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com
signature.asc
Description: OpenPGP digital signature
__________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
