<div dir="ltr"><p style="color:rgb(51,51,51);font-family:Georgia,'Times New Roman','Bitstream Charter',Times,serif;font-size:13px;line-height:19px">Hi all, </p><p style="color:rgb(51,51,51);font-family:Georgia,'Times New Roman','Bitstream Charter',Times,serif;font-size:13px;line-height:19px">
I'm going to post this next week to give my Hong Kong post time to marinate, but I wanted to share the news here first. Send me any suggestions and questions by Monday and I'll clarify as needed, thanks!</p><p style="color:rgb(51,51,51);font-family:Georgia,'Times New Roman','Bitstream Charter',Times,serif;font-size:13px;line-height:19px">
--</p><p style="color:rgb(51,51,51);font-family:Georgia,'Times New Roman','Bitstream Charter',Times,serif;font-size:13px;line-height:19px">I know, I know, OpenStack is too obsessed with statistics for contributors. I agree! I want to rise above it but the trend release-over-release for docs is way too tempting for me in my research lab for documentation. So allow me to indulge in some analysis that is similar to my post about this last release, <a href="http://justwriteclick.com/2013/04/26/who-wrote-openstack-grizzly-docs/">Who Wrote OpenStack Grizzly Doc</a>s? Remember? We had 79 docs contributors overall, with 3 of us writing half of the changes for Grizzly. This time we had 130 docs contributors with 7 of us writing just over half the changes in overarching install/config/deploy/operations guides. Progress! We also had at least three supporting companies hire writers dedicated to OpenStack upstream docs. Full of win. I love having <a href="http://www.openstack.org/community/jobs/">OpenStack job postings</a> to offer great tech writers.</p>
<p style="color:rgb(51,51,51);font-family:Georgia,'Times New Roman','Bitstream Charter',Times,serif;font-size:13px;line-height:19px"></p><p style="color:rgb(51,51,51);font-family:Georgia,'Times New Roman','Bitstream Charter',Times,serif;font-size:13px;line-height:19px">
We added 100,000 lines more than last release. What? Yes, it's true. Much of that is from our autodoc efforts, pulling all 1500 configuration options directly from the code, but that's a compelling number to share.</p>
<p style="color:rgb(51,51,51);font-family:Georgia,'Times New Roman','Bitstream Charter',Times,serif;font-size:13px;line-height:19px">I ran the same scripts as last time to maintain consistency. All these stats are from the tools that aren't being maintained any more from <a href="https://github.com/markmc/openstack-gitdm">openstack-gitdm</a>.</p>
<p style="color:rgb(51,51,51);font-family:Georgia,'Times New Roman','Bitstream Charter',Times,serif;font-size:13px;line-height:19px">Here are the numbers for the openstack-manuals repository only:</p><p style="color:rgb(51,51,51);font-family:Georgia,'Times New Roman','Bitstream Charter',Times,serif;font-size:13px;line-height:19px">
<code>Processed 966 csets from 130 developers<br>92 employers found<br>A total of 187524 lines added, 275056 removed (delta -87532)</code></p><pre style="font-size:12px;line-height:18px;font-family:Consolas,Monaco,monospace;color:rgb(51,51,51)">
Developers with the most changesets
Andreas Jaeger 233 (24.1%)
annegentle 89 (9.2%)
Tom Fifield 70 (7.2%)
Diane Fleming 70 (7.2%)
Christian Berendt 65 (6.7%)
Sean Roberts 44 (4.6%)
Stephen Gordon 41 (4.2%)
Summer Long 21 (2.2%)
Lorin Hochstein 20 (2.1%)
nerminamiller 17 (1.8%)
Gauvain Pocentek 15 (1.6%)
Emilien Macchi 15 (1.6%)
Colin McNamara 14 (1.4%)
Shaun McCance 13 (1.3%)
Deepti Navale 11 (1.1%)
Phil Hopkins 9 (0.9%)
Aaron Rosen 8 (0.8%)
Kurt Martin 8 (0.8%)
Scott Radvan 7 (0.7%)
Edgar Magana 7 (0.7%)
Covers 80.434783% of changesets</pre><p style="color:rgb(51,51,51);font-family:Georgia,'Times New Roman','Bitstream Charter',Times,serif;font-size:13px;line-height:19px">This is another interesting data set:</p>
<pre style="font-size:12px;line-height:18px;font-family:Consolas,Monaco,monospace;color:rgb(51,51,51)">Employers with the most hackers (total 136)
Red Hat 12 (8.8%)
IBM 12 (8.8%)
Rackspace 8 (5.9%)
HP 7 (5.1%)
Nicira 4 (2.9%)
Mirantis 4 (2.9%)
SUSE 2 (1.5%)
Yahoo! 2 (1.5%)
eNovance 2 (1.5%)</pre><p style="color:rgb(51,51,51);font-family:Georgia,'Times New Roman','Bitstream Charter',Times,serif;font-size:13px;line-height:19px">I also ran these same stats for the api-site repository, where the API user docs are sourced. These docs are still quite different from a contributor and sourcing standpoint and I'm not sure why. Rackspace dedicating Diane Fleming has made a huge difference here, think of what we could do with one more dedicated API doc writer? Ok, we can't clone Diane, but think of the possibilities.</p>
<pre style="font-size:12px;line-height:18px;font-family:Consolas,Monaco,monospace;color:rgb(51,51,51)">Developers with the most changesets
Diane Fleming 46 (58.2%)
annegentle 5 (6.3%)
Cyril Roelandt 2 (2.5%)
Kersten Richter 2 (2.5%)
Brian Rosmaita 2 (2.5%)
Rupak Ganguly 2 (2.5%)
QingXin Meng 2 (2.5%)
ladquin 2 (2.5%)
dcramer 2 (2.5%)</pre><pre style="font-size:12px;line-height:18px;font-family:Consolas,Monaco,monospace;color:rgb(51,51,51)">Employers with the most hackers (total 23)
Rackspace 5 (21.7%)
IBM 5 (21.7%)
Red Hat 2 (8.7%)</pre><p style="color:rgb(51,51,51);font-family:Georgia,'Times New Roman','Bitstream Charter',Times,serif;font-size:13px;line-height:19px">I'm also a web analytics hound. What docs were the most accessed during the lead-up to the Havana release? Here are the top five:</p>
<ol style="color:rgb(51,51,51);font-family:Georgia,'Times New Roman','Bitstream Charter',Times,serif;font-size:13px;line-height:19px"><li><a href="http://docs.openstack.org/developer/swift">Swift Developer site</a></li>
<li>Install Guides (Basic and Deploy, both Ubuntu and RedHat/Fedora/Centos)</li><li><a href="http://docs.openstack.org/api/quick-start/content/">API Quick Start</a></li><li><a href="http://docs.openstack.org/trunk/openstack-ops/content/">OpenStack Operations Guide</a></li>
<li><a href="http://docs.openstack.org/grizzly/openstack-compute/admin/content/starting-images.html">Getting Virtual Machine Images page</a> from the OpenStack Compute Administration Guide</li></ol><p style="color:rgb(51,51,51);font-family:Georgia,'Times New Roman','Bitstream Charter',Times,serif;font-size:13px;line-height:19px">
To me, these stats show that we're doing the right things such as dedicating a contractor to the install guide. Thank you Cisco. We still have areas to improve, such as API docs and ensuring end-user docs are a top priority. Our readers are definitely after both deployment and consumption of OpenStack clouds.</p>
</div>