[GitHub Pages](https://pages.github.com) can automatically generate and serve the website for you.

Let's say you have a username/organisation `my-org` and project `my-proj`; if you locate Jekyll source under `docs` folder of master branch in your repo `github.com/my-org/my-proj`, the website will be served on `my-org.github.io/my-proj`.

The good thing about coupling your documentation with the source repo is, whenever you merge features with regarding content to master branch, it will also be published on the webpage instantly.

1. Just [download the source](https://github.com/aksakalli/jekyll-doc-theme/archive/gh-pages.zip) into your repo under `docs` folder.

2. Edit site settings in `_config.yml` file according to your project. !!! `baseurl` should be your website's relative URI like `/my-proj` !!!

3. Replace `favicon.ico` and `img/logonav.png` with your own logo.

Docs are [collections](https://jekyllrb.com/docs/collections/) of pages stored under `_docs` folder. To create a new page:

**1.** Create a new Markdown as `_docs/my-page.md` and write [front matter](https://jekyllrb.com/docs/frontmatter/) & content such as:

**2.** Add the pagename to `_data/docs.yml` file in order to list in docs navigation panel:

Add a new Markdown file such as `2017-05-09-my-post.md` and write the content similar to other post examples.

The homepage is located under `index.html` file. You can change the content or design completely different welcome page for your taste. (You can use [bootstrap components](http://getbootstrap.com/components/))

In order to add a new page, create a new `.html` or `.md` (markdown) file under root directory and link it in `_includes/topnav.html`.