Per discussion on #30, I'd like to use this issue to both
- collect cases that deserve more up-front documentation
- propose solutions for how to show those cases to users
Simply, we can add an extra page in the sphinx docs and reference it from the home page?