An idiot’s guide to Python documentation with Sphinx and ReadTheDocs
This is the third occasion that I’ve come to set up a Python package’s documentation. It is also the third occasion where I’ve spent many hours and commits trying to work out how I made everything work last time. So for my future sanity and possibly yours, here’s a quick guide on setting up Sphinx-based, ReadTheDocs-hosted Python documentation.
When `True` is not `True`
Today, whilst continuing development on Goldilocks, I discovered a minor oddity that left me a little confused and bemused before lunch: True did not appear to be True… Part of Goldilocks‘ functionality allows for the filtering of results; users may specify a dictionary of criteria whose keys map to functions to be applied to result […]