From 2e34a35fca368640f36dcf04d736a4a130812a6d Mon Sep 17 00:00:00 2001 From: Lana Brindley Date: Thu, 15 Sep 2016 09:24:39 +1000 Subject: [PATCH] Adding Lana Brindley candidacy for Documentation Change-Id: I97af3941f8ee8260cd3891c6661940834d74c0b3 --- .../ocata/Documentation/loquacities.txt | 51 +++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 candidates/ocata/Documentation/loquacities.txt diff --git a/candidates/ocata/Documentation/loquacities.txt b/candidates/ocata/Documentation/loquacities.txt new file mode 100644 index 00000000..daba2573 --- /dev/null +++ b/candidates/ocata/Documentation/loquacities.txt @@ -0,0 +1,51 @@ +Hi everyone, + +I am seeking re-election as Documentation PTL for Ocata. I have been the docs +PTL since Liberty, and together we've converted the entire docs suite to RST, +decommissioned the old DocBook infrastructure, and fundamentally changed the +way projects document their installation procedures. Ocata is a short cycle, +so I want to take this opportunity to focus inwards on our community. I would +love your support to do this in Ocata. + +In Mitaka we embarked on an ambitious plan to convert our entire documentation +suite to RST, and in Newton we put the finishing touches to that project by +decommissioning the old DocBook infrastructure. With that long-term project +complete, we have gone on to develop a new publication model that allows +projects to write documentation in their own repos, and publish seamlessly to +the docs.openstack.org front page. This project goes live for the Installation +Guide and API docs with Newton, and means our documentation efforts are +continuing to scale out to represent a much greater proportion of products, +contributors, operators, and users. I would like to continue this work in +Ocata by evaluating the success of the project, and identifying more efficient +and productive pathways for users to find and use the information provided by +the docs team. I also want to explore more innovative ways for the +documentation team to work together, including a review of the speciality team +and release processes. I want to continue to foster collaboration between +developers and writers to provide the best possible documentation for the +entire OpenStack community. + +During Newton, in addition to the Installation Guide changes, we focussed on +streamlining our processes, clarifying the way we operate, consolidating +guides, and general editing and tidying up. I want to continue this work in +Ocata to provide a better documentation experience for everyone: writers, +developers, operators, and users. + +In the Liberty release cycle, we closed just over 600 bugs, and in Mitaka we +closed 645. With the rate of new bug creation rapidly dropping thanks to +procedural changes we made in Mitaka, our consistent effort has really paid +down a lot of our technical debt. For Newton so far, we've closed well over +400 bugs, and we have only 327 bugs in the queue as I write this, so this +positive trend continues. + +I'll be making the trek to Barcelona soon for the Ocata 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'm also excited about the new +Project Team Gathering coming up in February; I think this will be a great +opportunity for cross-project teams like docs. + +I'd love to have your support for the PTL role for Ocata. I'm looking forward +to continuing to grow the documentation team and to keep working on these +incremental improvements to content delivery. + +Thanks, +Lana (@loquacities)