diff --git a/README.md b/README.md
index dd09461..6039cb9 100644
--- a/README.md
+++ b/README.md
@@ -16,19 +16,22 @@ import gleam/http/request
 import possum/did
 import possum/tangled
 
+// Parse the DID from the user or repository that your are targetting.
+let assert Ok(did) = did.parse("did:plc:wibblewobble")
+
 // List every vouch an user received
 request.new()
 |> tangled.list_vouches(did, option.None, option.None)
 
-// List available issues of an repository
+// List available issues of a repository
 request.new()
 |> tangled.list_issues(did, option.None, option.None)
 
-// List available pull requests of an repository
+// List available pull requests of a repository
 request.new()
 |> tangled.list_pull_requests(did, option.None, option.None)
 
-// List repositories created by an user
+// List all repositories created by an user
 request.new()
 |> tangled.list_repositories(did, option.None, option.None)
 ```