Skip to content
Yak shaving sucks. So let's save ourselves from the yak.
Branch: master
Clone or download
Pull request Compare This branch is 17 commits ahead, 9 commits behind killtheyak:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
killtheyak-pages @ 0920595




A yak friendly redesign of KillTheYak, a wonderful website created by Steven Loria

You see, yak shaving is what you are doing when you're doing some stupid, fiddly little task that bears no obvious relationship to what you're supposed to be working on, but yet a chain of twelve causal relations links what you're doing to the original meta-task.

- Jeremy H. Brown

Save The Yak is a website with guides that will reduce the time you spend yak shaving.

Contribute content

If you are interested in contributing content, see the [killtheyak-pages][] repo.


Save The Yak is a small Flask app that uses Flask-FlatPages and Frozen-Flask to build the static content. The app itself lives in the savetheyak/ directory. Feel free to use, modify, or just browse around.

Setting up

Clone the repo

$ git clone --recursive

The --recursive option clones the killtheyak-pages submodule.

Install the necessary Python packages (requires Python 2.7 or 3.4.n with pip):

# After activating your virtualenv
$ pip install -r requirements.txt

Building the site

To run the local development server

$ python runserver

You can browse to http://localhost:5000/ to view the site.

To build the static version of the site:

$ python build

This will build the static site to the build/ directory.


To deploy to GitHub Pages:

$ python deploy

This will build the site, commit to the master branch, and push to GitHub.


Copyrights to the guides are owned by their original authors and are licensed under the [Creative Commons Attribution-Share-Alike license][CC-SA]. The website is licensed under the [MIT License][].

SaveTheYak [KillTheYak]: [killtheyak-pages]: [MIT License]: [CC-SA]:

You can’t perform that action at this time.