tools-python icon indicating copy to clipboard operation
tools-python copied to clipboard

Add AUTHORS file

Open xavierfigueroav opened this issue 5 years ago • 7 comments

An authors file is needed to list and thank people who have contributed to the project.

xavierfigueroav avatar Aug 21 '19 04:08 xavierfigueroav

Hi, could you quote and link docs on the AUTHORS file standard? I'm interested in what advantages the split-out AUTHORS file has over the current authors=[...] field in setup.py or extracting authors from the git log.

SKalt avatar Oct 13 '19 17:10 SKalt

More googling yielded https://opensource.google/docs/releasing/authors/, which outlines how an AUTHORS file (1) delineates who has copyrights to the open-source project and (2) creates a central place to acknowledge contributors' work. Seems worth a look to me. Then again, git log --format=format:'%aN <%aE>' | awk '!x[$0]++' or whatever powers Github's repo insights also can shows who committed, and possibly when and how much.

SKalt avatar Oct 13 '19 17:10 SKalt

Hi. AUTHORS file may be a platform-independent (git/github) alternative to acknowledge contributors' work. It is also a common, good practice in open source projects.

It looks like no SPDX repository has an AUTHORS file, so, if you are interested in, you could follow the style of the license-expression library's one, (which is maintained by tools-python's maintainer, who, by the way, suggested adding this file).

xavierfigueroav avatar Oct 13 '19 22:10 xavierfigueroav

Anything remaining in this issue, which I can do?

b-thebest avatar Mar 04 '21 17:03 b-thebest

@xavierfigueroav is this resolved or should i complete this?

thealphacod3r avatar Apr 08 '21 16:04 thealphacod3r

@meretp Is this issue still open? It has the label of 'tech debt'.

harshkasat avatar Feb 19 '24 10:02 harshkasat

Yes, it is still open, the repo does not have an AUTHORS file yet. We used this label to categorize this as something that is not urgent but rather a nice-to-have. One could potentially find a better label for this.

meretp avatar Feb 19 '24 12:02 meretp