[Condor-devel] Effect of combining SRC and DOC

[Nathan Panike <nwp@xxxxxxxxxxx>]

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.

Nathan Panike

For reference, the queries I used to compute these statistics were

git --no-pager log --all --since=2010-08-01 --until 2010-10-01 --oneline -- doc/ | cat -n
git --no-pager log --numstat --pretty=format:'commit %h' --all --since=2010-08-01 --until 2010-10-01 -- doc/ | sed -n '/^[0-9]/p' | awk 'BEGIN { adds=0; dels=0; } {adds += $1; dels += $2} END { print "Adds="adds" Dels="dels}'

and

git --no-pager log --all --since=2011-08-01 --until 2011-10-01 --oneline -- doc/ | cat -n
git --no-pager log --numstat --pretty=format:'commit %h' --all --since=2011-08-01 --until 2011-10-01 -- doc/ | sed -n '/^[0-9]/p' | awk 'BEGIN { adds=0; dels=0; } {adds += $1; dels += $2} END { print "Adds="adds" Dels="dels}'