This file is not used anywhere else in the project and should be removed. We are now storing credentials in build-local.json. See Getting Started for details.

1. Setup credentials

• You must add the developerGithubAccessToken and developerGithubUsername properties to ~/.phet/build-local.json. See https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line#creating-a-token for creating a personal access token. Under "Select Scopes", the token should be given full "repo" access.

2. Install npm packages

• The node scripts in this repo require running npm install in the phet-info/github-labels directory.

3. Github label code requires a checkout of perennial/.

1. cd phet-info/github-labels
2. Run ./new-repo-add-labels.sh phetsims/{{new-repo-name}}

1. Choose a new label following the labeling-scheme
2. cd phet-info/github-labels
3. Run ./new-label-all-repos.sh {{new-label-name}} {{new-label-color}}. new-label-color should be the hexcode with no # symbol, e.g. FF00AA.

1. Update the desired label in github-labels, following the labeling-scheme
2. cd phet-info/github-labels
3. Run ./change-label.sh {{old-label-name}} {{new-label-name}} {{new-label-color}}. new-label-color should be the hexcode with no # symbol, e.g. FF00AA.

1. cd phet-info/github-labels
2. Run ./delete-label.sh {{label-name}}.

1. If you have the file .repos (because you have used this tool before), delete the repo line from that file

• Error statuses during label script execution

  • 200, 201, etc - Anything in the 200 range indicates success.
  • 400 Bad Request - This probably indicates a fatal error. Verify if the change did not happen as expected and contact the responsible dev if not (Matt Pennington as of 2020).
  • 401 Unauthorized - This indicates that your credentials are incorrect. Make sure your username and personal access token are entered in ~/.phet/build-local.json correctly and check the status of your PAT at https://github.com/settings/tokens.
  • 403 Forbidden - This indicates that the Github User that you used does not have admin access for that repo. Make sure your username and personal access token are entered in ~/.phet/build-local.json correctly and contact any PhET Github Admin for further assistance.
  • 422 Unprocessable Entity - This is probably not an error and most likely indicates that the script attempted a duplicate action. Verify if the change did not happen as expected and contact the responsible dev if not (Matt Pennington as of 2020).