Suggested repo API

Added a document suggesting a more consistent API for the repository classes.