updated document that describes how to handle the repository