This is a documentation site for Cascalog.org hosted and auto-generated directly from this repository. It uses Jekyll site generator with Markdown as the article markup language. Any changes made to the gh-pages branch here will be live immediately.
Guides and articles are in the /articles directory. You can clone this repository and then add or edit articles there, then send a pull request.
For quick editing of the content, you can edit files in the /articles directory using Github web interface. Github would then take care of forking and sending pull request automatically for you.
For major changes, it is recommended to setup a local environment with Jekyll if you want to view your changes as a web site locally.
With Ruby Bundler:
bundle install --binstubs
./bin/jekyll serve -w --trace
then navigate to localhost:4000
./bin/jekyll build
This step isn't needed to publish the site because Github can render a Jekyll repo directly.