BUG fixed (#100, #102)

[AlbertMietus]

Fix for #100 and #102

Also some docs

Note: The work was done earlier, see the discusion. But due a holiday, i forgot the pull request

[nyergler]

There's a lot here, so it's going to take a bit for me to comb through it. Most of my comments from the previous diff stand, I think.

Some thoughts skimming through it:

• There are several stylistic changes in here that make it harder to understand exactly what's changed.
• The src/TDD_slides bit needs to be integrated with the test suite.
• It looks like there are a bunch of comments to yourself left behind?
• You've ripped out hieroglyph.writer.depart_title, but I think hieroglyph.html still has a reference to it; we need to double check that can really go.

Thanks for opening this; I'll try to review more thoroughly over the weekend.

[nyergler]

It also looks like the tests are pretty screwed up. (You can ignore the CircleCI stuff, I've removed it, but the Travis suite should pass.)