Example for User-Agent (#2678)
* Example for User-Agent
diff --git a/doc/repository-spec-v2.md b/doc/repository-spec-v2.md
index e346339..ef35d7a 100644
--- a/doc/repository-spec-v2.md
+++ b/doc/repository-spec-v2.md
@@ -27,7 +27,9 @@
* `X-Pub-Session-ID: <UUID>`
* `X-Pub-Reason: direct | dev`
* `X-Pub-Environment: ...`
-* `User-Agent: ...`
+* `User-Agent: my-pub-bot/1.2.3 (+https://github.com/organization/<repository)`
+
+Adding a custom `User-Agent` that allows _pub repository operators_ to identify calls from a specific client, and a URL allowing operators to reach owner of the client is always good practice.
### List all versions of a package
