Adding Content

To add content to the webpage, we use the GitHub flow. For this tutorial, we assume you’ve cloned the source code for the website to your computer using $ git clone https://github.com/StanfordMSL/msl_website/.

  1. Create a feature branch from master (it’s easiest to do this using the GitHub web interface).
  2. Pull down your new feature branch with $ git pull. Check out the branch ($ git checkout <feature_branch>), make your desired changes, commit them, and push to remote.
  3. Open a pull request (PR) using the GitHub web interface to merge your branch’s changes into master. Make sure to assign a reviewer (ideally someone from the web team).
  4. Check your changes on msl-dev.stanford.edu. Make sure all pages you’ve added or edited have built correctly.
  5. When your PR is approved by your assigned reviewer, merge your branch, and then delete it.

Notes

  • The dev website will rebuild automatically whenever you push a new commit to a branch with an open PR. The build process should finish in 1-2 min (you can see the build status on the PR page itself).
  • If you have any questions, or are not getting a timely review on your PR, feel free to post to #webpage on our Slack, or mention @web-team on a relevant channel.