add documentation for retrieval methods