[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

15. GOP c - authorship in source files

Proposal summary

Our documentation currently does not attempt to track individual authors of each file, while our source code makes a confused and jumbled attempt to track this. A number of guidelines for F/OSS projects explicitly recommends not tracking this in individual files, since the code repository will track that for us in a more reliable format.

I suggest that we remove authorship lines in source files in git.

Rationale

 
[on names in source files]
... many projects have taken the step of banning the inclusion of
author names or designated maintainer names in source files...

(quoting Apache Software Foundation member Sander Striker)
    At the Apache Software foundation we discourage the use of
author tags in source code. There are various reasons for this,
apart from the legal ramifications. Collaborative development is
about working on projects as a group and caring for the project as
a group. Giving credit is good, and should be done, but in a way
that does not allow for false attribution, even by implication.
There is no clear line for when to add or remove an author tag. Do
you add your name when you change a comment? When you put in a
one-line fix? Do you remove other author tags when you refactor
the code and it looks 95% different? What do you do about people
who go about touching every file, changing just enough to make the
virtual author tag quota, so that their name will be everywhere?

    There are better ways to give credit, and our preference is to
use those. From a technical standpoint author tags are
unnecessary; if you wish to find out who wrote a particular piece
of code, the version control system can be consulted to figure
that out. Author tags also tend to get out of date. Do you really
wish to be contacted in private about a piece of code you wrote
five years ago and were glad to have forgotten?

http://producingoss.com/en/managing-volunteers.html#territoriality

Proposal details

Remove author lines from source files.

Implementation notes

None yet.


[ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]

This document was generated by Graham Percival on June 13, 2012 using texi2html 1.82.