Recipes
Recipes
This article base contains “recipes” of procedures and code snippets for handling day-to-da processes that may otherwise present obstacles to students in ESaaS.
This article uses Jekyll and GitHub Pages to maintain a publicly accessible site at [saasbook.github.io/courseware].
Contributing
-
Make sure you have Jekyll installed
-
Fork the repo
github.com/saasbook/courseware -
Change to the
gh-pagesbranch -
Create a new Markdown (
.md) file in the_postssubdirectory containing your recipe. The frontmatter (first 6 lines) must look like this:
---
layout: page
title: "Name of your recipe"
category: rails
---
For category you should use whichever existing category on the
Recipes page is most appropriate. Contact the repo owner if you feel
a new category must be created.
-
If the post refers to other posts, be sure you follow Jekyll’s instructions for creating internal links – don’t hardcode absolute URLs.
-
As instructed here, run
jekyll serveorjekyll buildto rebuild the site and ensure your content renders properly. -
Commit your changes on a branch other than
gh-pagesand then do a pull request to thegh-pagesbranch on the upstream repo.