In-depth documentation topic list

[MagiMaster]

We should have more in-depth documentation on how to best use this library. This issue is to track which features/situations/edge cases are currently missing or under-explained. (If you haven't seen it, https://documentation.divio.com/ is a good reference for writing documentation in general.)

[MagiMaster]

The lifecycle hooks need to be added to the API reference, but they may also be worth a separate document as they may need more explanation of how best to use them than would be appropriate for a reference.

[MagiMaster]

A description of how spec-style tests are meant to be written (no real code in describe blocks), why that is, and how that applies specifically to Lua and TestEZ would be worthwhile. Might could be combined with the detailed explanation of the lifecycle hooks.

[MagiMaster]

The new context API needs to be documented. This would also tie in to the lifecycle hooks as that's a primary use case.

[benbrimeyer]

I've documented some of this in #143 within the api reference.

We do still need a best practice guide for spec-style tests.

Lifecycle hooks are documented in the api reference, but not much beyond that.

[benbrimeyer]

We should also add documentation on how to mock more complex game orientated topics, like the passage of time.