/developer-guide

Guidelines for software developers at LASP

MIT LicenseMIT

developer-guide

This repository provides guidelines for software developers at LASP

Contributing

If you would like to contribute changes to the content of this repository, do the following:

  1. Create a fork of this repository
  2. Make a local clone of your fork:
git clone https://github.com/<username>/developer-guide.git  # For HTTPS
git clone git@github.com:<username>/developer-guide.git  # For SSH
cd developer-guide/
  1. Set your personal fork to point to an origin and upstream remote:
git remote set-url origin git@github.com:<username>/developer-guide.git  # For SSH
git remote add upstream git@github.com:lasp/developer-guide.git  # For SSH

git remote set-url origin https://github.com/<username>/developer-guide.git  # For HTTPS
git remote add upstream https://github.com/lasp/developer-guide.git  # For HTTPS
  1. Install the pre-commit hooks (i.e. pre-commit install)
  2. Create a branch on that personal fork (i.e. git checkout -b <branch-name>)
  3. Commit changes (i.e. git add <file-that-changed.md>, git commit -m <commit-message>)
  4. Push that branch to your fork (i.e. git push origin <branch-name>)
  5. On the lasp repository, create a new pull request
  6. Assign a reviewer
  7. Iterate with the reviewer over any needed changes until the reviewer approves of the pull request. This may require additional commits to the pull request. Once all changes are approved, merge the pull request.

Questions?

Any questions about this effort may be directed to the #ds-best-practices-documentation Slack channel.