[openstack-dev] [Docs] PTL Candidacy

Lana Brindley openstack at lanabrindley.com
Mon Mar 14 01:11:26 UTC 2016


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

Hi everyone,

I am seeking re-election as Documentation PTL for Newton. I have now been the
docs PTL for two releases (Liberty and Mitaka), and would love another term in
the middle of the alphabet! We've achieved a lot this time around, including
an almost complete conversion to RST, quite a few structural overhauls of
popular books, and some fundamental toolchain improvements. There is still
lots to be done, though, and I would love your support to achieve this in
Newton.

During Liberty we got the bulk of our books migrated away from Docbook XML and
into RST. In Mitaka, we completed that work (with only the Ops Guide remaining
to be converted in Newton). For the last couple of releases, we've also had a
focus on improving the information architecture of our books, and have now
successfully completed overhauls of our most popular books, with the
Architecture Guide also well underway. All of these tasks will be carried over
to Newton, with many of them finally coming to completion. In Newton, I would
also like to address some of the larger issues around the organisation of our
documentation suite, making it easier for developers to contribute quality
code to our docs, and better welcoming and introducing new big tent projects
to the documentation team.

At the Mitaka summit in Tokyo, we decided to make a concerted effort to pay
down a lot of our tech debt, and one of the main ways we chose to do that was
to change the way we handled the DocImpact flag in our bugs. We merged those
changes to DocImpact about a month ago now, and it is already having a
significant impact on the amount of untriaged bugs outstanding. We're now much
more able to keep on top of our bug queue, which is giving us a much greater
ability to pay down tech debt. In this vein, we also have put a lot of effort
into ensuring new contributors have a better onboarding experience to docs,
with the creation of our new Contributor Guide which replaces a lot of old
wiki-based content, a great 'get started with docs' campaign at the last
Summit (which resulted in a hard copy article in the Summit edition of
SuperUser, and Anne and I on SuperUser TV), and a general willingness to
respond to questions on the mailing lists and help out new users wherever we
find them.

In the Liberty release cycle, we closed just over 600 bugs, and we're very
close to matching that number for Mitaka, with 505 bugs closed as I write
this. Again, we've managed to keep on top of the aging bugs as well, with all
bugs older than a year now closed. In the Mitaka release, we managed to close
16 blueprints, which is a massive increase over Liberty's 7.

I'm very excited about making the trek to Austin soon for the Newton summit,
to catch up with old friends, and hopefully meet some of our newest
contributors. Please be sure to stop for a chat if you see me around :)

I'd love to have your support for the PTL role for Newton, and I'm looking
forward to continuing to grow the documentation team.

Thanks,
Lana (@loquacities)

- -- 
Lana Brindley
Technical Writer
Rackspace Cloud Builders Australia
http://lanabrindley.com
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/

iQEcBAEBCAAGBQJW5g++AAoJELppzVb4+KUy9LAH/RC5y/gM22qywGZaE2y4hWEc
b+xdCxFUuh41l3WJhQ2iRJrnZUjm84doG2eCIcCpJW/OC5udo+2GiQYGmLUH278A
uz8Rfglsu/SmDhWZbaIWtiKXo3WedmWzXUbBCV7/+aftphKLMdckD1KAharZZOWq
Jqzg56SjWRqzbO++XiciCVwQ+zgoGuzJzYEQ1SsYsAdp/+wdtO2qPORZO1UuoOfz
wFFS/OG8O4PsJa3e9KW/kHzDY3Emkz7bhqDcbE6w3HyszC6bEq8lDgmcXtg2SoNn
FzjEpoiiAyalncUfo3p+v+7CV/3M/N4nCB2K+VhYO0hIAxPgUMxhrP3jzzq/gSI=
=sboQ
-----END PGP SIGNATURE-----



More information about the OpenStack-dev mailing list