[openstack-dev] [Docs] Documentation PTL Candidacy

Anne Gentle anne at openstack.org
Sun Sep 22 18:19:00 UTC 2013


Hi all,
I'm writing to declare my intention to run for OpenStack documentation
program technical lead. [1]

I've been working on OpenStack docs since September 2010, and it has been
an honor and a privilege to serve in this position informally prior to
having documentation declared a program. I've been serving as the interim
PTL as encouraged by my doc peers.

In Havana we've been hard at work (and continue to do so), refactoring the
openstack-manuals repo to ensure installation, configuration, and
administration info is as complete and accurate as we can, including the
addition of automation tools for gathering configuration options into one
location.

We've added an End User Guide, an Admin User Guide, and a Cloud
Administration Guide to document OpenStack as a whole, including all the
clients and the things you can do with your OpenStack clouds through
command-line calls.

We also work on API documentation to bring you a compete reference listing
of all OpenStack APIs including example requests and responses.

In the last year we've held two successful book sprints in the past year
resulting in the OpenStack Operations Guide and the OpenStack Security
Guide. We're actively recruiting writers for a book sprint to write an
OpenStack Architecture Design Guide. The Operations Guide has been
translated to Chinese and Japanese.

I believe the documentation PTL role is one of coordination, coaching, and
providing platforms for documentation. This doesn't happen in isolation and
requires constant attention and coordination. I do know our shortcomings
and continue to work through the difficulties we face trying to document a
fast-moving integrated set of projects. In the future I'd like to recruit
more upstream OpenStack writers and have designated project doc leads.

I continue to be the top committer to the openstack-manuals repo [2] and I
am an active reviewer of all docs repos. [3]

I'm proud of the work we've done so far and would be privileged to continue
this most challenging work.
Thanks,
Anne

1. Wow, that sounds too formal, but that's what this email is.
2. https://github.com/openstack/openstack-manuals/graphs/contributors
3. https://review.openstack.org/#/q/reviewer:anne%2540openstack.org,n,z
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20130922/3bb5aeb7/attachment.html>


More information about the OpenStack-dev mailing list