[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
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.
[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 |
Remove author lines from source files.
None yet.
[ << ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This document was generated by Graham Percival on June 13, 2012 using texi2html 1.82.