Added some documentation to try to clarify the responsibilities of this type, see #80.