repository: improve docs