yade-dev team mailing list archive
-
yade-dev team
-
Mailing list archive
-
Message #11924
Re: Inspecting authors for next doc release
Hi Bruno,
I committed code from Jan Eliáš twice [1,2]. In both cases, the
documentation is from source code in both cases.
cheers
Jan
[1] http://bazaar.launchpad.net/~yade-pkg/yade/git-trunk/revision/3362.10.49
[2]
http://bazaar.launchpad.net/~yade-pkg/yade/git-trunk/revision/3362.10.291
2015-03-05 12:00 GMT+01:00 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.
> 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