Skip to content

Conversation

@jsquyres
Copy link
Member

@jsquyres jsquyres commented Apr 25, 2016

This is a proposal for reformatting the AUTHORS file. The intent is as follows:

  • Several of us have committed under multiple different email addresses. We need to list then all.
  • The organization acronyms were out of date with the list at the bottom (i.e., there were some acronyms that weren't in the legend at the bottom)

What do people think of the new format? I'm a little concerned about the people who have gone through multiple organizations, and therefore have super-long text lines for their affiliation, e.g., Josh Hursey: https://github.com/open-mpi/ompi/pull/1581/files#diff-3d350169560e75d0cf9fc8e3574a3639R159

Signed-off-by: Jeff Squyres [email protected]

@jsquyres jsquyres added the RFC label Apr 25, 2016
@bosilca
Copy link
Member

bosilca commented Apr 25, 2016

Multiline file are not easy to read/parse. Why not starting with the constant part (the name), followed by the current email address, and then all the institutions in order (current first). We can use a traditional CSV format (https://tools.ietf.org/html/rfc4180).

AUTHORS Outdated
Rainer Keller, High Performance Computing Center, Stuttgart, Oak Ridge National Laboratory
[email protected]
[email protected]
Ralph Castain, Los Alamos National Laboratory, Cisco, Intel
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should add Greenplum to list

@jsquyres jsquyres force-pushed the pr/AUTHORS-update branch from c3aaa31 to 136189c Compare April 26, 2016 10:46
@jsquyres
Copy link
Member Author

@rhc54 Done
@kmroz Done
@jjhursey Done
@derbeyn Your email address change will be reflected in your future commits. Your past commits were all done with the old @bull.net addresses, and will always be listed as such in the Git history (i.e., we can't change Git history in the public repo).

@bosilca Is machine-parsable a requirement?

FWIW, here's the rationale for the initial format I submitted:

  • List all the email addresses (so that every commit is accounted for)
  • As is obvious by the list, we've had people switch between organizations multiple times
  • I did not try to match email address with organization (that's complicated for some people)
  • It seemed desirable to put the name and list of organizations on the same line. But this has an undesirable side-effect for people who have been to a lot of organizations (e.g., Josh Hursey had multiple internships, which made a super-long list of organizations)
  • I reasoned that indenting would make the file "machine-parsable enough", if that was actually a requirement.

How about fully embracing the multi-line strategy with something like this:

Name: Josh Hursey
Org: Indiana University
Org: Oak Ridge National Laboratory
Org: Los Alamos National Laboratory
Org: Lawrence Berkeley National Laboratory
Org: University of Wisconsin-La Crosse
Org: IBM
Email: [email protected]
Email: [email protected]

Name: Joshua Ladd
Org: Mellanox
Email: [email protected]
Email: [email protected]

(note the blank line between people)

@bosilca
Copy link
Member

bosilca commented Apr 26, 2016

Doing a quick grep for authors (git log | grep "^Author:" | grep -v '\-\-quiet' | sed 's/^Author://' | sort -u) gives the following list. It would be nice if we can parse the content of AUTHORS and match it with the git knowledge to make sure we account for everyone.

 Abhishek Kulkarni <[email protected]>
 Adrian Knoth <[email protected]>
 Adrian Reber <[email protected]>
 Alejandro Vilches <[email protected]>
 Aleksey Senin <[email protected]>
 Alex Margolin <[email protected]>
 Alex Mikheev <[email protected]>
 Alina Sklarevich <[email protected]>
 Anandhi S Jayakumar <[email protected]>
 Andreas Knüpfer <[email protected]>
 Andrew Friedley <[email protected]>
 Andrew Friedley <[email protected]>
 Andrew Friedley <[email protected]>
 Andrew Lumsdaine <[email protected]>
 Anya Tatashina <[email protected]>
 Artem Polyakov <[email protected]>
 Aurelien Bouteiller <[email protected]>
 Aurelien Bouteiller <darter4.nics.utk.edu>
 Aurélien Bouteiller <[email protected]>
 Avneesh Pant <[email protected]>
 Bert Wesarg <[email protected]>
 Bill D'Amico <[email protected]>
 Brad Benton <[email protected]>
 Brad Penoff <[email protected]>
 Brian Barrett <[email protected]>
 Brice Goglin <[email protected]>
 Camille Coti <[email protected]>
 Christian Bell <[email protected]>
 Christoph Niethammer <[email protected]>
 Christopher Yeoh <[email protected]>
 Craig E Rasmussen <[email protected]>
 Dan Lacher <[email protected]>
 Dave Goodell <[email protected]>
 Dave Goodell <[email protected]>
 David Daniel <[email protected]>
 Denis Dimick <[email protected]>
 Devendar Bureddy <[email protected]>
 Devendar Bureddy <[email protected]>
 Dimitar Pashov <[email protected]>
 Donald Kerr <[email protected]>
 Doron Shoham <[email protected]>
 Edagr Gabriel <[email protected]>
 Edgar Gabriel <[email protected]>
 Edgar Gabriel <[email protected]>
 Elena <[email protected]>
 Ethan Mallove <[email protected]>
 Eugene Loh <[email protected]>
 Federico Reghenzani <[email protected]>
 Francois WELLENREITER <[email protected]>
 Francois WELLENREITER <[email protected]>
 Gabriel Pichot <[email protected]>
 Galen Shipman <[email protected]>
 Geoffrey Paulsen <[email protected]>
 George Bosilca <[email protected]>
 George Bosilca <[email protected]>
 Gilles Gouaillardet <[email protected]>
 Gilles Gouaillardet <[email protected]>
 Gilles Gouaillardet <[email protected]>
 Ginger Young <[email protected]>
 Gleb Natapov <[email protected]>
 Gopal Santhanaraman <[email protected]>
 Graham Fagg <[email protected]>
 Greg Koenig <[email protected]>
 Greg Watson <[email protected]>
 Guillaume Papauré <[email protected]>
 Hadi Montakhabi <[email protected]>
 Howard Pritchard <[email protected]>
 Howard Pritchard <[email protected]>
 Howard Pritchard <[email protected]>
 Iain Bason <[email protected]>
 Igor Ivanov <[email protected]>
 Igor Ivanov <[email protected]>
 Igor Usarov <[email protected]>
 Jeff Squyres <[email protected]>
 Jeff Squyres <[email protected]>
 Jeff Squyres <[email protected]>
 Jelena Pjesivac-Grbovic <[email protected]>
 Jithin Jose <[email protected]>
 John Westlund <[email protected]>
 Jon Mason <[email protected]>
 Jose Roman <[email protected]>
 Josh Hursey <[email protected]>
 Joshua Hursey <[email protected]>
 Joshua Hursey <[email protected]>
 Joshua Ladd <[email protected]>
 Joshua Ladd <[email protected]>
 KAWASHIMA Takahiro <[email protected]>
 Karen Norteman <[email protected]>
 Karl Mroz <[email protected]>
 Karol Mroz <[email protected]>
 Kenneth Matney <[email protected]>
 Laura Casswell <[email protected]>
 Lenny Verkhovsky <[email protected]>
 Leobardo Ruiz Rountree <[email protected]>
 Li-Ta Lo <[email protected]>
 MPI Team <[email protected]>
 Mangala Jyothi Bhaskar <[email protected]>
 Mangala Jyothi Bhaskar <[email protected]>
 Mangala Jyothi Bhaskar <[email protected]>
 Manjunath Gorentla Venkata <[email protected]>
 Mark Santcroos <[email protected]>
 Mark Santcroos <[email protected]>
 Mark Taylor <[email protected]>
 Matias A Cabral <[email protected]>
 Matias Cabral <[email protected]>
 Matthias Jurenz <[email protected]>
 Maximilien Levesque <[email protected]>
 Mike Dubman <[email protected]>
 Mitch Sukalski <[email protected]>
 Mohamad Chaarawi <[email protected]>
 Nadezhda Kogteva - [email protected] <[email protected]>
 Nadezhda Kogteva <[email protected]>
 Nadia Derbey <[email protected]>
 Nathan Hjelm <[email protected]>
 Nathan Hjelm <[email protected]>
 Nathan Hjelm <[email protected]>
 Nathaniel Graham <[email protected]>
 Nathaniel Graham <[email protected]>
 Nick Papior Andersen <[email protected]>
 No Author <[email protected]>
 Nysal Jan <[email protected]>
 Nysal Jan K A <[email protected]>
 Nysal Jan K.A <[email protected]>
 Orion Poplawski <[email protected]>
 Oscar Vega-Gisbert <[email protected]>
 Pak Lui <[email protected]>
 Patrick Geoffray <[email protected]>
 Pavel Shamis (Pasha) <[email protected]>
 Pavel Shamis / Pasha <[email protected]>
 Pavel Shamis <[email protected]>
 Pierre Lemarinier <[email protected]>
 Piotr Lesnicki <[email protected]>
 Prabhanjan Kambadur <[email protected]>
 Raghavendra Pendyala <[email protected]>
 Rainer Keller <[email protected]>
 Rainer Keller <[email protected]>
 Ralph Castain <[email protected]>
 Ralph Castain <[email protected]>
 Reese Faucette <[email protected]>
 Rich Graham <[email protected]>
 Rob Awles <[email protected]>
 Rob Latham <[email protected]>
 Rolf vandeVaart <[email protected]>
 Ron Brightwell <[email protected]>
 Ryan Grant <[email protected]>
 Ryan Grant <[email protected]>
 Sami Ayyorgun <[email protected]>
 Samuel Gutierrez <[email protected]>
 Sayantan Sur <[email protected]>
 Sharon Melamed <[email protected]>
 Shiqing Fan <[email protected]>
 Steve Wise <[email protected]>
 Sushant Sharma <[email protected]>
 Sven Stork <[email protected]>
 Swen Boehm <[email protected]>
 Sylvain Jeaugey <[email protected]>
 Sylvain Jeaugey <[email protected]>
 Teng Lin <[email protected]>
 Terry Dontje <[email protected]>
 Thananon Patinyasakdikul <[email protected]>
 Thara Angskun <[email protected]>
 Thomas Herault <[email protected]>
 Tim Mattox <[email protected]>
 Tim Mattox <[email protected]>
 Tim Prins <[email protected]>
 Tim Woodall <[email protected]>
 Todd Kordenbrock <[email protected]>
 Todd Kordenbrock <[email protected]>
 Todd Kordenbrock <[email protected]>
 Tom Naughton <[email protected]>
 Tomislav Janjusic <[email protected]>
 Torsten Hoefler <[email protected]>
 Valentin Petrov <[email protected]>
 Vasily Filipov <[email protected]>
 Vishal Sahay <[email protected]>
 Vishwanath Venkatesan <[email protected]>
 Weikuan Yu <[email protected]>
 Wesley Bland <[email protected]>
 William Throwe <[email protected]>
 Yael Dayan <[email protected]>
 Yevgeny Kliteynik <[email protected]>
 Yohann Burette <[email protected]>
 Yohann Burette <[email protected]>
 Yossi <[email protected]>
 Yossi Etigin <[email protected]>
 Yossi Itigin <[email protected]>
 Zhi Ming Wang <[email protected]>
 Zhiming Wang <[email protected]>
 adrianreber <[email protected]>
 annu13 <[email protected]>
 bosilca <[email protected]>
 bureddy <[email protected]>
 elenash <[email protected]>
 hpp <[email protected]>
 igor-ivanov <[email protected]>
 [email protected] <[email protected]>
 lrrajesh <[email protected]>
 matcabral <[email protected]>
 mjbhaskar <[email protected]>
 rhc54 <[email protected]>
 rolfv <[email protected]>
 yohann <[email protected]>
 yosefe <[email protected]>

[email protected]
Patrick Geoffray, Myricom
[email protected]
Pavel Shamis, Mellanox, Oak Ridge National Laboratory
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

add ARM to the list

@jsquyres
Copy link
Member Author

@bosilca Yes, I used git log --format="%an %ae" | sort | uniq to manually create the list that is on this PR. I think we would definitely have some kind of cron script (once a day?) that looks for new commits that are not listed in AUTHORS (and mails a warning if it finds some).

@jsquyres
Copy link
Member Author

@bosilca Forgot to mention: the output from the git commits sometimes reveals that people spell their names differently in different commits. So even the git knowledge is... imprecise. 😢

@bosilca
Copy link
Member

bosilca commented Apr 26, 2016

Yes, I noticed that. I wonder what are the email address on users.noreply.github.com ? Online modifications ?

@jsquyres
Copy link
Member Author

It looks like that comes if you do a PR merge and you haven't set a primary email address on your github account properly.

@bosilca
Copy link
Member

bosilca commented Apr 26, 2016

After investigation it appears that if you protect your email address in your github profile, your UI actions automatically get associated with an users.noreply.github.com email.

@jsquyres
Copy link
Member Author

@bosilca Do you have something we can cite/link to about that? If so, I can add it to the github startup pages on our wiki (e.g., for new OMPI devs). Thanks!

@bosilca
Copy link
Member

bosilca commented Apr 26, 2016

Empirical evidence ;) And github doc

@jsquyres
Copy link
Member Author

@goodell
Copy link
Member

goodell commented May 2, 2016

On a related note, it looks like the .mailmap file could use an update. After the official transition to git, we no longer have any addresses that contain open-mpi-git-mirror.example.com in them. This file should probably be autogenerated from whatever AUTHORS file we end up with, possibly with a static bit of text glued on the top to handle things like Jeff's --quiet <--quiet> .gitconfig snaggle. The main value of generating such a file is to help unify the "I clicked the Merge PR button" address with whatever address is used when running git commit.

@ibm-ompi
Copy link

Test passed.

@jsquyres jsquyres force-pushed the pr/AUTHORS-update branch from f86f5b5 to 02af4cf Compare May 28, 2016 13:53
jsquyres added 2 commits May 31, 2016 19:18
Remove all @open-mpi-git-mirror entries; those are no longer necessary
since the official migration to Git/Github.

Add aliases for @users.noreply.github.com addresses.

Add fixes for what look like accidental name mispellings /
common-name-isms.

Signed-off-by: Jeff Squyres <[email protected]>
@jsquyres jsquyres force-pushed the pr/AUTHORS-update branch from 02af4cf to 36f6531 Compare May 31, 2016 23:18
@jsquyres
Copy link
Member Author

@goodell Good points; I updated the .mailmap file.

@ggouaillardet
Copy link
Contributor

@jsquyres my previous email ([email protected]) is not listed here, i do not use it any more, but should it be listed anyway ?

@jsquyres
Copy link
Member Author

jsquyres commented Jun 4, 2016

@jsquyres
Copy link
Member Author

jsquyres commented Jun 4, 2016

@ggouaillardet I'm sorry; I misunderstood your question. We're listing all the email addresses that appear in the output of git log -- i.e., if you see email address X, it maps to person Y. Even if that email address doesn't exist/work any more.

@jsquyres jsquyres merged commit c0fc0d1 into open-mpi:master Jun 4, 2016
@jsquyres jsquyres deleted the pr/AUTHORS-update branch June 4, 2016 01:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

9 participants