[openstack-dev] [docs] Our Install Guides Only Cover Defcore - What about big tent?

Doug Hellmann doug at doughellmann.com
Fri Mar 25 19:22:42 UTC 2016


Excerpts from Mike Perez's message of 2016-03-25 11:32:58 -0700:
> > On Mar 25, 2016, at 06:10, Doug Hellmann <doug at doughellmann.com> wrote:
> > 
> > Excerpts from Lana Brindley's message of 2016-03-24 08:50:49 +1000:
> >> 
> >> All docs need to be drafted somewhere. I don't care where that is, but make the suggestion of /developer because at least it's accessible there, and also because it's managed in the project's own repo. If you want to create a different place, or rename /developer to be more inclusive, I think that's a great idea.
> > 
> > I think we'll want to add a new location, or publish to a similar
> > location to the existing install guide. I found, for example
> > http://docs.openstack.org/mitaka/install-guide-ubuntu/
> > 
> > If we take ironic as the example, and assume all OS-types would be
> > covered in one manual, we could make that:
> > 
> > (1) http://docs.openstack.org/mitaka/ironic/install-guide/
> > (2) http://docs.openstack.org/ironic/mitaka/install-guide/
> > (3) http://docs.openstack.org/install-guide/ironic/
> > (4) http://docs.openstack.org/ironic/install-guide/
> 
> I like option 3.
> 
> All install guides would be discoverable at /install-guides that are rendered docs from individual projects' repos.
> 
> Regardless of what direction people would like to go here, I will be happy to spearhead this from a cross-project perspective.

Thanks, Mike, that would be good. I'm happy to help out, too.

Doug



More information about the OpenStack-dev mailing list