Excerpts from Doug Hellmann's message of 2017-08-01 15:35:35 -0400: > 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 >
If you want an idea of the sorts of work ahead, check out the tracking pad: https://etherpad.openstack.org/p/doc-future-problems Not everything on that list is related to the tools, but quite a lot is. Doug __________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
