/introspection

Documentation to help us make sure we're doing the right thing