← Back to team overview

yade-dev team mailing list archive

Re: Inspecting authors for next doc release

 

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.
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
________________




Follow ups

References