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: [email protected]?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
