diff --git a/README.md b/README.md
index 41a0d73..bd22eb8 100644
--- a/README.md
+++ b/README.md
@@ -28,13 +28,13 @@ import possum/did
 import possum/handle
 import possum
 
-let assert Ok(handle) = handle.parse("gleam.run")
-
-// Resolve an atproto handle (hostname) to a DID.
-//
 // You can consult your identifier by sending a request directly to your PDS,
 // or you can use projects like [Slingshot](https://slingshot.microcosm.blue)
 // for easy access to cached data when resolving a handle.
+
+// Handle validation
+let assert Ok(handle) = handle.parse("gleam.run")
+
 request.new()
 |> request.set_host("slingshot.microcosm.blue")
 |> possum.resolve_handle(handle)
@@ -54,8 +54,7 @@ import possum
 let assert Ok(did) = did.parse("did:plc:ewvi7nxzyoun6zhxrhs64oiz")
 let assert Ok(collection) = nsid.parse("sh.tangled.repo")
 
-// Reading public data from repositories.
-// No authorization needed.
+// Reading public data from repositories, no Authorization needed.
 request.new()
 |> request.set_host("personal.data-server.pds")
 |> possum.list_records(
@@ -87,12 +86,12 @@ request.new()
   auth_factor_token: option.None
 )
 
-// Include a authorization Header for requests that require authentication.
+// Include header for authorized requests.
 request.new()
 |> request.set_host("personal.data-server.pds")
 |> possum.authorized("access-token")
 
-// Refreshing an authorized Session
+// Refreshing an authorized Session.
 request.new()
 |> request.set_host("personal.data-server.pds")
 |> possum.refresh_session("refresh-token")