Thanks for contributing to CSrankings! Please read and indicate you agree with all these guidelines to getting your pull request accepted. Note that pull requests may take some time to get merged (please don't contact us for at least three months for updates, unless you are a sponsor - see below).
If you find CSrankings useful, please consider becoming a sponsor.
NOTE: IF YOU DO NOT FOLLOW THE STEPS BELOW, YOUR COMMIT WILL BE SUMMARILY REJECTED. You must read and check all the boxes below by filling them in with an X or your PR will be rejected.
The Basics
-
All pull requests and issues must come from non-anonymous accounts.
-
Use a reasonable title that explains what the PR corresponds to (as in, not "Update csrankings-x.csv").
-
Combine multiple updates to a single institution into a single PR.
-
Only submit one pull request per institution.
-
Do not modify any files except
csrankings-[a-z].csv
or (if needed)country-info.csv
andold/industry.csv
(see below). -
Do not use Excel to edit any .csv files; Excel incorrectly tries to convert some Google Scholar entries to formulas, corrupting the database. Use the GitHub user interface or a text editor like emacs or NotePad instead.
-
Insert new faculty in alphabetical order (not at the end) in the appropriate
csrankings-[a-z].csv
files. Do not modifycsrankings.csv
, which is auto-generated. -
Check to make sure that you have no spaces after commas, or any missing fields.
-
Check to make sure the home page is correct.
-
Make sure the Google Scholar IDs are just the alphanumeric identifier (not a URL or with
&hl=en
). -
Check to make sure the name corresponds to the DBLP entry (look it up at http://dblp.org).
-
If a faculty member is not in a CS department or similar, include a comment explaining how they meet the inclusion criteria (see below).
Inclusion criteria
- Make sure that any faculty you add meet the inclusion
criteria. Eligible faculty include only full-time, tenure-track research
faculty members on a given campus who can solely advise PhD students in
Computer Science. Faculty not in a CS department or similar who can
advise PhD students in CS can be included regardless of their home
department. Provide justification, pointing to specific home pages
showing how faculty not in a CS department meet the inclusion criteria,
e.g. showing a courtesy appointment in CS. Faculty must also have a 75%+ time appointment (check
old/industry.csv
for faculty who are now more than 25% in industry).
Updating an affiliation or home page
- Update affiliations, home pages, and Google Scholar entries by modifying
csrankings-[a-z].csv
. For the Google Scholar entry, just use the alphanumeric identifier in the middle of the URL. If none is there, putNOSCHOLARPAGE
.
Adding one or more faculty members (including an entire department)
-
If the department is not yet listed in CSrankings, the entire CS faculty needs to be added (not just one faculty member).
-
Enter each faculty member's DBLP name, home page, and Google Scholar entry (just the alphanumeric identifier, not the whole URL) by modifying
csrankings-[a-z].csv
(the letters correspond to the first letter of the faculty members' names); include disambiguation suffixes like0001
as needed. If the faculty entry is currently ambiguous, please do not include them. Send mail to the DBLP maintainers ([email protected]) with a few publications by a particular faculty member; also, open an issue so that when the DBLP database is updated, that faculty member's information can be added. -
If DBLP has multiple entries for this person, all of them need to be listed. Do not update
dblp-aliases.csv
. -
If the institution you are adding is not in the US, update
country-info.csv
and add all of the faculty in the CS department.
(Advanced) Quick contribution via a shallow clone
We recommend that you use the GitHub web user interface to make changes. However, it may be more convenient to clone the repository for larger-scale changes.
However, a full clone of the CSrankings repository is almost 2GB. To contribute a change without creating a full local clone of the CSrankings repo, you can perform a shallow clone. To do so, follow these steps:
-
Fork the CSrankings repo. If you have an existing fork, but it is not up to date with the main repository, this technique may not work. If necessary, delete and re-create your fork to get it up to date. (Do not delete your existing fork if it has unmerged changes you want to preserve!)
-
Do a shallow clone of your fork:
git clone --depth 1 https://github.com/yourusername/CSrankings
. This will only download the most recent commit, not the full git history. -
Make your changes on a branch, push them to your clone, and create a pull request on GitHub as usual.
If you want to make another contribution and some time has passed, perform these steps again, creating a fresh fork and shallow clone.