[openstack-dev] [Docs] PTL Candidacy

Tristan Cacqueray tristan.cacqueray at enovance.com
Thu Sep 25 13:58:46 UTC 2014


confirmed

On 25/09/14 12:10 AM, Anne Gentle wrote:
> I'm writing to announce my candidacy for the Documentation Program
> Technical Lead (PTL).
> 
> The past six months have flown by. I still recall writing up wish lists
> per-deliverable on the plane home from the Atlanta Summit and the great
> news is many are completed. Of course we still have a lot to do.
> 
> We face many challenges as an open source community as we grow and define
> ourselves through our users. As documentation specialists, we have to be
> creative with our resourcing for documentation as the number of teams and
> services increases each release. This release we have:
> - experimented with using RST sourcing for a chapter about Heat Templates
> - managed to keep automating where it makes sense, using the toolset we
> keep improving upon
> - held another successful book sprint for the Architecture and Design Guide
> - split out a repo for the training group focusing not only on training
> guides but also scripts and other training specialties
> - split out the Security Guide with their own review team; completed a
> thorough review of that guide
> - split out the High Availability Guide with their own review team from
> discussions at the Ops Meetup
> - began a Networking Guide pulling together as many interested parties as
> possible before and after the Ops Meetup with a plan for hiring a contract
> writer to work on it with the community
> - added the openstack common client help text to the CLI Reference
> - added Chinese, German, French, and Korean language landing pages to the
> docs site
> - generated config option tables with each milestone release (with few
> exceptions of individual projects)
> - lost a key contributor to API docs (Diane's stats didn't decline far yet:
> http://stackalytics.com/?user_id=diane-fleming&release=juno)
> - still working towards a new design for page-based docs
> - still working on API reference information
> - still working on removing "spec" API documents to avoid duplication and
> confusion
> - still testing three of four install guides for the JUNO release (that
> we're nearly there is just so great)
> 
> So you can see we have much more to do, but we have come so far. Even in
> compiling this list I worry I'm missing items, there's just so much scope
> to OpenStack docs. We serve users, deployers, administrators, and app
> developers. It continues to be challenging but we keep looking for ways to
> make it work.
> 
> We have seen amazing contributors like Andreas Jaeger, Matt Kassawara,
> Gauvain Pocentek, and Christian Berendt find their stride and shine. Yes, I
> could name more but these people have done an incredible job this release.
> 
> I'm especially eager to continue collaborating with great managers like
> Nick Chase at Mirantis and Lana Brindley at Rackspace -- they see what we
> can accomplish when enterprise doc teams work well with an upstream.
> They're behind-the-scenes much of the time but I must express my gratitude
> to these two pros up front.
> 
> Thanks for your consideration. I'd be honored to continue to serve in this
> role.
> Anne
> 
> 
> 
> _______________________________________________
> OpenStack-dev mailing list
> OpenStack-dev at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
> 


-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 473 bytes
Desc: OpenPGP digital signature
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20140925/9a1dbec4/attachment.pgp>


More information about the OpenStack-dev mailing list