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

Petr Kovar pkovar at redhat.com
Wed May 2 13:56:36 UTC 2018

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.



More information about the OpenStack-dev mailing list