[openstack-dev] [tc][docs] documenting openstack "constellations"

Doug Hellmann doug at doughellmann.com
Wed May 2 19:13:23 UTC 2018


Excerpts from Petr Kovar's message of 2018-05-02 15:56:36 +0200:
> On Tue, 01 May 2018 10:08:23 -0400
> Doug Hellmann <doug at doughellmann.com> wrote:
> 
> > The TC has had an item on our backlog for a while (a year?) to
> > document "constellations" of OpenStack components to make it easier
> > for deployers and users to understand which parts they need to have
> > the features they want [1].
> > 
> > John Garbutt has started writing the first such document [2], but
> > as we talked about the content we agreed the TC governance repository
> > is not the best home for it, so I have proposed creating a new
> > repository [3].
> > 
> > In order to set up the publishing jobs for that repo so the content
> > goes to docs.openstack.org, we need to settle the ownership of the
> > repository.
> > 
> > I think it makes sense for the documentation team to "own" it, but
> > I also think it makes sense for it to have its own review team
> > because it's a bit different from the rest of the docs and we may
> > be able to recruit folks to help who might not want to commit to
> > being core reviewers for all of the documentation repositories. The
> > TC members would also like to be reviewers, to get things going.
> > 
> > So, is the documentation team willing to add the new "constellations"
> > repository under their umbrella?
> 
> Fine with me and thanks for bringing this up!
> 
> From the top of my head, this will also require updating the doc contrib
> guide and the docs review dashboard.
> 
> https://docs.openstack.org/doc-contrib-guide/team-structure.html
> https://is.gd/openstackdocsdashboard
> 
> Thanks,
> pk
> 

Thanks, Petr.

I will make a note of that and look for a volunteer to take care of it.

Doug



More information about the OpenStack-dev mailing list