On 23/03/2016 15:37, Steve Gordon wrote: > ----- Original Message ----- >> From: "Mike Perez" <[email protected]> >> To: "OpenStack Development Mailing List" <[email protected]> >> >> Hey all, >> >> I've been talking to a variety of projects about lack of install guides. This >> came from me not having a great experience with trying out projects in the >> big >> tent. >> >> Projects like Manila have proposed install docs [1], but they were rejected >> by the install docs team because it's not in defcore. One of Manila's goals >> of >> getting these docs accepted is to apply for the operators tag >> ops:docs:install-guide [2] so that it helps their maturity level in the >> project >> navigator [3]. >> >> Adrian Otto expressed to me having the same issue for Magnum. I think it's >> funny that a project that gets keynote time at the OpenStack conference can't >> be in the install docs personally. > > Just two minor clarifications here: > > * Manila install docs are actively being worked on for inclusion in the > Mitaka version of the guide: > http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/install-guide/source/manila.rst > > * Magnum install docs were only very recently proposed here - > https://review.openstack.org/#/c/288580/ - nobody is saying they can't be in > the install guide assuming someone is willing to write/maintain them, but > until now it wasn't clear anyone was. > > I certainly think a better system for linking out-of-tree install docs for > big tent projects would be worth pursuing, but regardless of where it lives > someone still has to write/maintain that user-orientated content. For those > that have someone actively doing this on an ongoing basis they already have a > path to inclusion in the guide (or at least, it seems that way based on the > cases I am familiar with like those above). > > Are there examples of projects that have this user orientated install > documentation written but are actively being rejected from including it in > the install guide (in the Magnum case it has been pushed out to Newton as it > was a late submission, not rejected permanently)? >
the linked review - https://review.openstack.org/#/c/213756/ Lana Brindley Aug 18, 2015 Patch Set 1: Code-Review-2 The Install Guide covers defcore projects only, sorry. Lana Brindley Aug 27, 2015 Abandoned This content belongs in the Manila /developer docs. If this has changed - that is great, I will start getting our docs together for the guide, but seeing patches like this is why we didn't try before. > -Steve > > __________________________________________________________________________ > OpenStack Development Mailing List (not for usage questions) > Unsubscribe: [email protected]?subject:unsubscribe > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > __________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: [email protected]?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
