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

Bogdan Dobrelya bdobreli at redhat.com
Wed Aug 2 08:55:13 UTC 2017

On 01.08.2017 21:35, Doug Hellmann wrote:
> With the changes we've made to docs processes upstream, every team
> is going to need to build up their knowledge of how the new
> documentation tools and jobs work. The docs team will still help,
> but things will obviously go more smoothly if folks know how the
> tools work, now that the bulk of the content is in-tree with the
> code.
> At the same time, the docs team could use help with developing and
> maintaining those tools. We have a couple people working on them
> now (me, Andreas, and Anne), but none of us is doing it full time.
> I need to transition off of this work, so over the course of Queens
> I will be trying to build up the skills of the existing team so
> they do not need to rely on me so much. Also, Andreas and Anne have
> said that they cannot commit to driving any work.
> Although the documentation team has some skills in this area, they
> could use help, so I would like to find a few people to join the
> team specifically to work on the tooling (although if you wanted
> to write documentation, too, no one will object).
> Some of you have been helping informally (thank you!), but the
> community shift is big enough that we need to account for the new
> need a bit more formally. I think if we could find several people
> who could give a small percentage of their time (10%?), we would
> be well covered. There will not be work every week, but when there
> is something to do it's likely to take a small extended period (1-2
> days) to add a feature or resolve an issue. If we found 4-6 people,
> I think we would be covered and have a sustainable group.
> 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.
> If you are interested in helping, please let me know by following
> up to this thread, and then join #openstack-docs on IRC.


> Doug
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

Best regards,
Bogdan Dobrelya,
Irc #bogdando

More information about the OpenStack-dev mailing list