----- Original Message ----- > From: "Steve Gordon" <[email protected]> > To: "OpenStack Development Mailing List (not for usage questions)" > <[email protected]> > > ----- Original Message ----- > > From: "Steve Gordon" <[email protected]> > > To: "OpenStack Development Mailing List (not for usage questions)" > > <[email protected]> > > > > ----- Original Message ----- > > > From: "Graham Hayes" [email protected]> > > > To: "OpenStack Development Mailing List (not for usage questions)" > > > <[email protected]> > > > > > > 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/ > > > > Did you look at the link I provided above?: > > > > http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/install-guide/source/manila.rst > > > > This content is merged. > > > > -Steve > > Here is the Mitaka spec review for the proposal to add Magnum to the guide: > https://review.openstack.org/#/c/275200/ > Here is the Mitaka review to add the Magnum content to the guide: > https://review.openstack.org/#/c/273724/ > > -Steve
Sorry, I mean Manila above obviously (same project as the 213756 review was for) - the Magnum proposal will likely be looked at for Newton (assuming the owner keeps working on it). -Steve __________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: [email protected]?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
