This document explains why we made certain decisions about the behavior of the command. This is too detailed for users, but could be useful in the future if we want to discuss further improvements.
We're piggybacking on our existing integration test framework to record demos that we can include in our docs