diff --git a/docs/repository.rst b/docs/repository.rst
index c2bd0c2..1ce6191 100644
--- a/docs/repository.rst
+++ b/docs/repository.rst
@@ -33,6 +33,11 @@ Functions
 
 .. autofunction:: pygit2.discover_repository
 
+   Example::
+
+     >>> current_working_directory = os.getcwd()
+     >>> repository_path = discover_repository(current_working_directory)
+     >>> repo = Repository(repository_path)
 
 
 The Repository class