We welcome contributions from anyone! Contributions to the docs can be done in two ways:

1. Fork and Clone this repository, and send your changes in via pull request. Read and follow the docs guidelines here.
2. You can use the Edit on GitHub link on each page of the live docs, this will take you to an edit mode version of the page here on GitHub. If you don't have commit rights for this repo, Github will allow you to make an ad hoc pull request right there.

The live site will be built & redeployed whenever a change is made to the master branch of this repository.

This usually takes a few minutes, as we use a free build server.

Follow the instructions on this page to install Node.

> npm install -g grunt-cli

> git clone https://github.com/<your name here>/getakka.net.git getakkanet
> cd getakkanet

> npm install -d

# from within your local fork of the repo
> grunt

Once the site is generated, a browser will be opened, displaying the result.

When running the site locally, the grunt script will be watching the /src/ folder for changes.

If any changes are detected, this will trigger a regeneration of the content and your browser will be live reloaded.

Our custom styling is all done via SCSS.

Edit the appropriate "underscored" file in the /_scss. These SCSS files then get compiled automatically by grunt-contrib-compass into the screen.css file, which is then copied by grunt into /web.

To add sitewide data that can be used in any template/page, you can add it to src/_data/site.yml and it will then be accessible via Handlebars in all templates. For example, site.yml defines url, which is then accessed in the templates like so: {{site.url}}.

For more details / advanced usage, read the docs on options.data.

We use Marked.JS for markdown rendering. Thus, any editor based on this will give you the best preview/edit experience, such as Atom or StackEdit.

This site is built with Assemble.io static site generator, which uses the following tools to do its work:

• Node.JS to power everything
• Handlebars as the templating engine
• Grunt for build/task automation