[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