documentation edits and more introspection