Relish is unusable for hosting documentation - find a replacement

[honzajavorek]

Relish has several flaws:

• Publishing has to be manual, because the relish gem prompts for credentials interactively (maybe workaround exists?).
• HTML rendered from correct Markdown often contains erroneous output (list items squashed, incorrect formatting of code as a link label, ...).
• The generated ToC is sorted alphabetically instead of according to the contents of .nav. There is no way to sort them in a way useful for a reader.
• There is no way to get a nice name for pure markdown files in ToC - e.g. add-implementation.md is displayed as Add-implementation in the ToC and on the page itself and there's no way to override it.

For that reason, if anyone knows how to efficiently document something together with gherkin scenarios e.g. in Sphinx, please let us know. We will gladly replace Relish with something else.

[honzajavorek]

Sphinx ideas:

• behave should have a tool (or formatter) that generates Sphinx-based documentation behave/behave#166
• Sphinx steps formater how to pass destdir behave/behave#494
• https://behave.readthedocs.io/en/latest/formatters.html?highlight=sphinx