[openstack-dev] [SPAM] [all][docs] recruiting for help with documentation tools

Doug Hellmann doug at doughellmann.com
Wed Aug 2 12:17:47 UTC 2017

Excerpts from Thierry Carrez's message of 2017-08-02 14:01:47 +0200:
> Doug Hellmann wrote:
> > [...]
> > The areas we need help are maintaining the doc build jobs, the
> > sphinx extensions in oslo.config and oslo.policy, the Sphinx theme,
> > and the template build tool in the openstack-manuals git repo. These
> > are all minimally complete, but there is definitely feature work
> > and bug fixing to do. I can guarantee that, if you sign up to help,
> > you will have a chance to land changes that will be visible for all
> > OpenStack users. At the start of Queens, I will be doing some
> > one-on-one training with volunteers to ensure they understand the
> > system we have in place now and help them start on some of the
> > remaining feature work.
> > [...]
> Feels like the doc owners/liaisons that we are looking for in the Top 5
> help wanted list[1] would be in a good position to help with that.
> Should we extend the description of the need so that it's clearer that
> help with maintaining the doc toolchain is also a top wanted thing ?
> [1]
> https://governance.openstack.org/tc/reference/top-5-help-wanted.html#documentation-owners

I'm torn on that. On the one hand, I would like to recruit. On the
other, we do need far more content contributors than tool maintainers.
Let's wait and see. There were 2 responses to this thread already, so
maybe we won't need to go that far.


More information about the OpenStack-dev mailing list