Fix navigation drawbacks in docs

[bittner]

The documentation has a substantial drawback when it comes to navigating through content.

Problem example

See the Contributing chapter. How do you get back to the welcome page, for example?

This issue seems to be inherent to the Alabaster theme. Other projects have the same problem, see e.g. the behave docs, but it's less relevant there because the docs have the behave "logo" (the image with the words box) that takes you home. We should probably have something similar.

• Can we fix the scarce navigation via some configuration switch? (Sphinx, Alabaster)
• We should probably come up with a (Pony) logo and add it as a "home link" to the docs.

Logo ideas

• Yet unused Django mascots (Andrew Mirsky)
• Combination of Django and behave. (A Pony and Given-When-Then)

"Given a pony, when I run behave with behave-django, then my project has awesome tests."

[jenisys]

@bittner
Maybe sphinx-bootstrap-theme solves these problems (in addition to using a logo).
The title-bar is always present. Therefore, you always have a link to the master-page.
SEE ALSO: https://github.com/ryan-roemer/sphinx-bootstrap-theme

EXAMPLE:

[bittner]

The Alabaster documentation mentions a few options that may fix the issue (apart from the logo, apparently):

• show_related = True
• extra_nav_links = { ... }

Optionally,

• fixed_sidebar = True may also be nice for the lengthy Usage page.

They need to be added to the html_theme_options dict, IIUC. A code example is available from the Alabaster docs source.

@mixxorz Can you try whether these options help to create a more meaningful navigation in the sidebar?

[bittner]

I've moved the "create logo" part of this issue to a separate issue, so we can close this one as soon as PR #21 is merged and the updated docs are released.

[bittner]

Fixed via #21.