Improve the API reference

autodoc can't handle some of the constructs, such as the LockState enum, and some of the type hinting for properties. Let's see if we can improve that through manual markup.

https://flufllock.readthedocs.io/en/stable/docs/apiref.html