← Back to team overview

yade-dev team mailing list archive

Re: Inspecting authors for next doc release

 

Thanks for the stats! very interesting results ...

Zitat von Bruno Chareyre <bruno.chareyre@xxxxxxxxxxxxxxx>:

A general comment on git stats: don't try to get more than what they
really mean, especially when it comes to ranking.
Running automatic formatting on a 500 lines file will look as 500
commited lines, for instance. Counting lines is unfair.
Or one guy will work for months on a project, then send everything
(plenty lines) in one single commit. Commit count: 1. Counting commits
is unfair.

what about log((number of commits)*factor(added lines + removed lines)) ?
factor may be around 1/[average (or median) of added lines + removed lines from all authors]

Some obvious junk stats can be avoided (e.g. lines of mesh/data files in
example folders are ignored [1]), but the numbers are still meaningless
if one doesn't know what's behind.
I would keep the authors in alphabetic order after V. Smilauer, like before.

A question for Jan (Stransky): I guess you commited Jan Elias code under
your name because I don't see him anywhere. Correct?
Do you remember if there was some related documentation in rst files or
only documentation in source code?

Bruno

[1] grep -E '*\.cpp|*\.hpp|*\.rst|*\.cmake|*\.txt|*\.bib|*\.ipp|*\.in|*\.py'



On 04/03/15 20:29, Bruno Chareyre wrote:
Hi there,
1/ I mapped all "Author Name e@mail" of git in order to have a single
name for every contributor [1]. Please check if the email adress is the
one you want to see in the futur version of the documentation (I used
the one with highest commit count). And please try to use always the
same name and email, there is sometimes five different names for one person.
2/ I ran some stats between early 2011 (date of last stable
documentation) and now, the stats are in [2]. They give an idea (not
100% accurate yet) of the additional authors to include: the last table
for user manuals, the one just before for reference manual. The first
table in the page can be used for listing contributors of the code, who
may not appear as authors of the documentation.
Cheers

Bruno

[1]
https://github.com/yade/trunk/commit/ed7259b48c180cf01d5d39a635fa17f881bb473e
[2] https://www.yade-dem.org/wiki/A_couple_tricks_for_stats



--
_______________
Bruno Chareyre
Associate Professor
ENSE³ - Grenoble INP
Lab. 3SR
BP 53
38041 Grenoble cedex 9
Tél : +33 4 56 52 86 21
Fax : +33 4 76 82 70 43
________________



_______________________________________________
Mailing list: https://launchpad.net/~yade-dev
Post to     : yade-dev@xxxxxxxxxxxxxxxxxxx
Unsubscribe : https://launchpad.net/~yade-dev
More help   : https://help.launchpad.net/ListHelp






Follow ups

References