> I usually add my name as author when I feel that I'm contributing something
> new, not just fixing bugs.

It can make sense to add your name when you add something new, but
code is not static like a scientific paper. Contrary to it, code is
modified over time and after a while an authors block does not make
any sense.

The best we can have when it comes to acknowledgement is our trac
server: it stores what each of us did, and this history does not
change. Then we have 'git blame' when we want to know who wrote one
specific line.

With the trac history and the git history, I believe that we have
trustworthy information in both directions.

Authors block, however, are maintained manually and represent more
accurately how we feel with respec to acknowledgement than the
work/sweat we put into it.

You, Jeroen, believe that it is not worth adding your name when you
add a bugfix. If you read the 'authors' block of the graph.py file
(the module, not some specific function) you will see that some people
added their name there after fixing a docstring!

http://doc.sagemath.org/html/en/reference/graphs/sage/graphs/graph.html#graph-format

On the other side of the spectra, Vincent's name and mine appear twice
in the whole combinat/design/ folder, and we basically wrote (or
rewrote) everything that is in there. I spent months for what it is
that folder.

If we start adding our names to authors block at every patch, I will
have to decide whether I want everybody else's name but mine to
appear, or whether I want every single function of the graph/ folder
to have an 'AUTHORS' block with my name on it.

And I will hate myself.

Nathann

-- 
You received this message because you are subscribed to the Google Groups 
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-devel+unsubscr...@googlegroups.com.
To post to this group, send email to sage-devel@googlegroups.com.
Visit this group at http://groups.google.com/group/sage-devel.
For more options, visit https://groups.google.com/d/optout.

Reply via email to