We've had a lot of great feedback, issue reports, ideas, etc. in #284. It would be great to incorporate those contributions into the documentation