updated documentation and stopped exposing internal plumbing