This README for contributors. The tutorials are publicly available at https://eecs280staff.github.io/tutorials/.
EECS 298 Python tools and tutorials.
The markup source files live in docs/. We're using GitHub pages to publish the docs/ folder using the Primer Spec custom theme.
For local spec development, render GitHub pages locally using the Primer Spec instructions. Summary:
One time install:
$ ruby --version # Need version 2.4.0 or later
ruby 2.6.1p33 (2019-01-30 revision 66950) [x86_64-darwin18]
$ gem install bundler
$ pwd
/Users/creiglas/src/eecs298/tutorials
$ bundle installEvery day usage:
$ pwd
/Users/creiglas/src/eecs298/tutorials/docs
$ bundle exec jekyll serveIf you run into Jekyll errors, run bundle update:
$ pwd
/Users/creiglas/src/eecs298/tutorials
$ bundle update --allIf Gemfile.lock changes, be sure to commit the changes.
We generate previews of the spec website whenever a Pull Request modifies the docs/ directory. These previews are uploaded to https://preview.seshrs.ml/previews/eecs280staff/<repo-name>/<PR-number>/ using a marketplace GitHub Action (upload-to-primer-spec-preview). Check out the workflow definition for implementation details.
The documents in this repository are licensed under a Creative Commons Attribution-NonCommercial 4.0 License. You’re free to copy and share this document, but not to sell it. You may not share source code provided with the documents in this repository.