diff --git a/lib/oauth2.hoon b/lib/oauth2.hoon
index 49809a505d..4540f94cfd 100644
--- a/lib/oauth2.hoon
+++ b/lib/oauth2.hoon
@@ -1,3 +1,6 @@
+::
+::::  /hoon/oauth2/lib
+  ::
 |%
 ++  fass                                                ::  rewrite quay
   |=  a/quay
diff --git a/sec/com/facebook/graph.hoon b/sec/com/facebook/graph.hoon
index f46df6ce2a..eb7cb13964 100644
--- a/sec/com/facebook/graph.hoon
+++ b/sec/com/facebook/graph.hoon
@@ -1,3 +1,7 @@
+::  Test url +https://graph.facebook.com/v2.5/me
+::
+::::  /hoon/graph/facebook/com/sec
+  ::
 /+    oauth2
 ::
 ::::
diff --git a/sec/com/github/api.hoon b/sec/com/github/api.hoon
index f2ee8869c5..700035bbfb 100644
--- a/sec/com/github/api.hoon
+++ b/sec/com/github/api.hoon
@@ -1,3 +1,7 @@
+::  Test url +https://api.github.com/user
+::
+::::  /hoon/api/github/com/sec
+  ::
 /+    basic-auth
 !:
 |_  {bal/(bale keys:basic-auth) $~}
diff --git a/sec/com/googleapis/www.hoon b/sec/com/googleapis/www.hoon
index b0a0f2d421..14fe7de991 100644
--- a/sec/com/googleapis/www.hoon
+++ b/sec/com/googleapis/www.hoon
@@ -1,3 +1,7 @@
+::  Test url +https://www.googleapis.com/oauth2/v1/userinfo
+::
+::::  /hoon/www/googleapis/com/sec
+  ::
 /+    oauth2
 ::
 ::::
diff --git a/sec/com/slack.hoon b/sec/com/slack.hoon
index 0c5edd8f31..53aa5aa68b 100644
--- a/sec/com/slack.hoon
+++ b/sec/com/slack.hoon
@@ -1,3 +1,7 @@
+::  Test url +https://slack.com/api/auth.test
+::
+::::  /hoon/slack/com/sec
+  ::
 /+    oauth2
 ::
 ::::