Re: [Condor-devel] Effect of combining SRC and DOC

[Cathrin Weiss <cweiss@xxxxxxxxxxx>]

Just being a statistics cynic: These statistics don't tell me much about change in documentation productivity. More useful (than absolute time) would be, for example, the amount of documentation produced between two releases (for both, stable and developer) last year and this year, or the amount of documentation  compared to lines of code modified (last year and this year). Documentation very much depends on the release cycle (minus the fact that we have a lot of outstanding doc tasks from years ago), which makes comparison a little tricky. 

Furthermore, the number of new features in a release impacts the amount of documentation that (should be) is produced, but granted, that requires  a little more careful digging. 

Another interesting question: Did the merge impact the documentation behavior of individual developers? In what way? (Now, yes, this  also highly depends on which features were committed by whom) 

Thanks,
Cathrin


On Oct 2, 2011, at 6:31 PM, Nathan Panike wrote:

> Dear colleagues:
> 
> It has been two months since we combined the SRC and DOC repositories.  I did a
> couple queries to see if that means more documentation is being produced.  For
> comparison, I used the same two-month period from 2010.  Here is what I found:
> 
> In 2010, from 1 August through 1 October: there were 2044 added lines and 1045
> deleted lines, in 94 commits.
> 
> In 2011, from 1 August through 1 October: there were 2379 added lines and 1281
> deleted lines, in 182 commits.
> 
> (The merge of SRC and DOC occurred on 30 July 2011).
> 
> This gives a very high-level view, with almost no insight into whether *better*
> documentation is being produced, but I believe the numbers above are evidence
> that the quantity of documentation produced has increased since the merge of
> SRC and DOC.
> 
>