templates/hero.md

+# Template `hero.html`
+
+This template inherits from `base.html` and extends the `body` block.
+
+It provides you with a simple [bulma](http://bulma.io/documentation/layout/hero/) hero-nav-section layout. It has a
+default sized [bulma-hero](http://bulma.io/documentation/layout/hero/) on the top with top-left and top-right link
+navigation as well as an hero title and subtitle.
+
+In addition it defines a [bulma-section](http://bulma.io/documentation/layout/section/) which contains the
+[bulma-containers](http://bulma.io/documentation/layout/container/). It also comes with a pre-filled footer and some
+general links and informations, which can be overwritten.
+
+[Django-messages](https://docs.djangoproject.com/en/dev/ref/contrib/messages/) are also supported and will be rendered
+on top of the default section and containers.
+
+## available blocks
+
+Please note that this templates inherits from the [base template](/Templates/base)  and
+contains therefore all blocks which are defined there.
+
+| Block name | Description |
+|---|---|
+| **hero stuff** ||
+| `hero-head` | Overwrite the whole bulma hero head |
+| `nav-left` | Add / Overwrite links in the top-left navigation |
+| `brand-icon` | Overwrite the brand icon |
+| `brand-name` | Overwrite the brand name |
+| `nav-right` | Add / Overwrite links in the top-right navigation |
+| `hero-body` | Overwrite title / subtitle in the hero body |
+| `hero-foot` | Add content in the hero-foot |
+| **section stuff** ||
+| `pre-section` | Add more sections / content __before__ the main section |
+| `section` | Overwrite the main section |
+| `notifications` | Overwrite the rendering of [django-messages](https://docs.djangoproject.com/en/dev/ref/contrib/messages/) notifications |
+| `post-section` | Add more sections / content __after__ the main section |
+| `footer` | Overwrite the whole footer content |
\ No newline at end of file