diff --git a/gen/ask/admins.hoon b/gen/ask/admins.hoon
index 84c41aa878..4e857d042f 100644
--- a/gen/ask/admins.hoon
+++ b/gen/ask/admins.hoon
@@ -1,5 +1,6 @@
+::  Set admin users
 ::
-::::  /hoon/release/hood/gen
+::::  /hoon/admins/ask/gen
   ::
 /?    310
 ::
diff --git a/gen/cat/pretty.hoon b/gen/cat/pretty.hoon
index d5a2f02566..edb4919b29 100644
--- a/gen/cat/pretty.hoon
+++ b/gen/cat/pretty.hoon
@@ -1,3 +1,4 @@
+::  Pretty-printing util, should be in lib/
 ::
 ::::  /hoon/pretty/cat/gen
   ::
diff --git a/gen/code.hoon b/gen/code.hoon
index d4b549aeca..db505cc2c9 100644
--- a/gen/code.hoon
+++ b/gen/code.hoon
@@ -1,3 +1,4 @@
+::  Login code for web UI
 ::
 ::::  /hoon/code/gen
   ::
diff --git a/gen/curl-hiss.hoon b/gen/curl-hiss.hoon
index 7b9b4c3aff..f3aa63132c 100644
--- a/gen/curl-hiss.hoon
+++ b/gen/curl-hiss.hoon
@@ -1,3 +1,4 @@
+::  Make HTTP request(get only)
 ::
 ::::  /hoon/curl-hiss/gen
   ::
diff --git a/gen/curl.hoon b/gen/curl.hoon
index 7cd15555aa..1214a62907 100644
--- a/gen/curl.hoon
+++ b/gen/curl.hoon
@@ -1,3 +1,4 @@
+::  Fetch contents at url
 ::
 ::::  /hoon/curl/gen
   ::
diff --git a/gen/curl/url.hoon b/gen/curl/url.hoon
index d5bc522131..14509afa8a 100644
--- a/gen/curl/url.hoon
+++ b/gen/curl/url.hoon
@@ -1,3 +1,4 @@
+::  Direct :curl to fetch contents at url
 ::
 ::::  /hoon/url/curl/gen
   ::
diff --git a/gen/gmail/list.hoon b/gen/gmail/list.hoon
index 428a0b3bf9..1be7ce9e1d 100644
--- a/gen/gmail/list.hoon
+++ b/gen/gmail/list.hoon
@@ -1,3 +1,4 @@
+::  List [number] inbox messages  XX may be broken
 ::
 ::::  /hoon/list/gmail/gen
   ::
diff --git a/gen/gmail/send.hoon b/gen/gmail/send.hoon
index 125f21b29a..94e1f6ef49 100644
--- a/gen/gmail/send.hoon
+++ b/gen/gmail/send.hoon
@@ -1,3 +1,4 @@
+::  Send e-mail via gmail API
 ::
 ::::  /hoon/send/gmail/gen
   ::
diff --git a/gen/hello.hoon b/gen/hello.hoon
index 74d7b3dc94..0bb333dee0 100644
--- a/gen/hello.hoon
+++ b/gen/hello.hoon
@@ -1,3 +1,4 @@
+::  "Hello world" sample generator
 ::
 ::::  /hoon/hello/gen
   ::
diff --git a/gen/help.hoon b/gen/help.hoon
new file mode 100644
index 0000000000..e813886a06
--- /dev/null
+++ b/gen/help.hoon
@@ -0,0 +1,64 @@
+::  List available comands
+::  
+::::  /hoon/help/gen
+  ::
+/?    310
+!:
+::::
+  ::
+|%
+++  path-heps
+  |=  a/path  ^-  tape
+  ?~  a  ""
+  |-  ^-  tape
+  %+  welp  (trip i.a)
+  ?~  t.a  ""
+  ['-' $(a t.a)]
+::
+++  rend
+  |=  {a/@thoon b/path}  ^-  tank
+  =;  c/(pair tape tape)
+    =/  tab  (sub 10 (mod (lent "{p.c}  ") 10))
+    [%palm ["  {(reap tab ' ')}" ``~] leaf+p.c leaf+q.c ~]
+  :-  ?-  b
+        $~  "/"  :: XX !! maybe?
+        {$hood ^}  "|{(path-heps t.b)}"
+        ^          "+{(path-heps b)}"  :: XX deal with :talk|foo
+      ==
+  =/  c  (lore a)
+  ?~  c  "~"
+  ?.  =('::  ' (end 3 4 i.c))
+    "<undocumented>"
+  (trip i.c)
+::
+++  read-at
+  |=  {len/@u pax/path}
+  |=  {nam/@t ark/arch}  ^-  (unit {@t path})
+  ?.  (~(has by dir.ark) %hoon)  ~
+  %+  bind  (file (welp pax /[nam]/hoon))
+  |=  a/*  ^-  {cord path}
+  [;;(@t a) (welp (slag len pax) /[nam])]  
+--
+::
+:-  %say
+|=  {{now/time @ our/ship ^} typ/$@($~ {p/term $~}) $~}
+=/  pax/path  /(scot %p our)/home/(scot %da now)/gen  :: XX hardcoded
+=+  len=(lent pax)
+=.  pax  ?~(typ pax (welp pax /[p.typ]))
+:-  %tang  %-  flop  ^-  tang
+=+  ark=.^(arch cy+pax)
+%+  welp
+  ?~  typ  ~
+  =/  red  ((read-at len (scag len pax)) p.typ ark) :: XX ugly
+  (drop (bind red rend))
+|-  ^-  tang
+=+  =<  arl=(~(tap by (~(urn by dir.ark) .)))
+    |=({a/@t $~} .^(arch cy+(welp pax /[a])))
+%+  welp
+  =/  dir/(list {@ path})
+    (murn arl (read-at len pax))
+  `tang`(turn (sort dir aor) rend)
+%-  zing  ^-  (list tang)
+%+  turn  (sort arl aor)
+|=  {a/@t b/arch}
+^$(pax (welp pax /[a]), ark b)
diff --git a/gen/hood/ask.hoon b/gen/hood/ask.hoon
index 73d8566f0e..1ccd3097c9 100644
--- a/gen/hood/ask.hoon
+++ b/gen/hood/ask.hoon
@@ -1,3 +1,4 @@
+::  Request a planet from Tlon Inc.
 ::
 ::::  /hoon/ask/hood/gen
   ::
diff --git a/gen/hood/autoload.hoon b/gen/hood/autoload.hoon
index e1ad31785a..7b5c6b8535 100644
--- a/gen/hood/autoload.hoon
+++ b/gen/hood/autoload.hoon
@@ -1,3 +1,4 @@
+::  Helm: Disable/enable/toggle auto-reload of kernel components
 ::
 ::::  /hoon/autoload/hood/gen
   ::
diff --git a/gen/hood/begin.hoon b/gen/hood/begin.hoon
index f401b311a9..997079c64b 100644
--- a/gen/hood/begin.hoon
+++ b/gen/hood/begin.hoon
@@ -1,3 +1,4 @@
+::  Redeem ticket to replace current urbit with full one  XX DEPRECATED
 ::
 ::::  /hoon/begin/hood/gen
   ::
diff --git a/gen/hood/bonus.hoon b/gen/hood/bonus.hoon
index f734d31441..a9234a7dec 100644
--- a/gen/hood/bonus.hoon
+++ b/gen/hood/bonus.hoon
@@ -1,5 +1,6 @@
+::  Womb: add planets/stars to balance
 ::
-::::  /hoon/reinvite/hood/gen
+::::  /hoon/bonus/hood/gen
   ::
 /?    310
 ::
diff --git a/gen/hood/breload.hoon b/gen/hood/breload.hoon
index a5a02b5e1d..887b489bf0 100644
--- a/gen/hood/breload.hoon
+++ b/gen/hood/breload.hoon
@@ -1,3 +1,4 @@
+::  Helm: Reload vane/s from /=base=
 ::
 ::::  /hoon/breload/hood/gen
   ::
diff --git a/gen/hood/cancel.hoon b/gen/hood/cancel.hoon
index 2b25f0db69..2ab6cb3ad5 100644
--- a/gen/hood/cancel.hoon
+++ b/gen/hood/cancel.hoon
@@ -1,3 +1,4 @@
+::  Kiln: cancel pending merge
 ::
 ::::  /hoon/cancel/hood/gen
   ::
diff --git a/gen/hood/claim.hoon b/gen/hood/claim.hoon
index c97b601372..7eab1c6aa1 100644
--- a/gen/hood/claim.hoon
+++ b/gen/hood/claim.hoon
@@ -1,3 +1,4 @@
+::  Womb: use passcode to claim ship
 ::
 ::::  /hoon/claim/hood/gen
   ::
diff --git a/gen/hood/cp.hoon b/gen/hood/cp.hoon
index 8bf774934e..67203f0874 100644
--- a/gen/hood/cp.hoon
+++ b/gen/hood/cp.hoon
@@ -1,3 +1,4 @@
+::  Kiln: copy file in clay
 ::
 ::::  /hoon/cp/hood/gen
   ::
diff --git a/gen/hood/deset.hoon b/gen/hood/deset.hoon
index 87e0a45d55..9da8f2f03e 100644
--- a/gen/hood/deset.hoon
+++ b/gen/hood/deset.hoon
@@ -1,3 +1,4 @@
+::  Helm: break arvo somehow?? XX unknown
 ::
 ::::  /hoon/deset/hood/gen
   ::
diff --git a/gen/hood/exit.hoon b/gen/hood/exit.hoon
index 544c488693..9861b9367b 100644
--- a/gen/hood/exit.hoon
+++ b/gen/hood/exit.hoon
@@ -1,3 +1,4 @@
+::  Drum: ^D, quit urbit process
 ::
 ::::  /hoon/exit/hood/gen
   ::
diff --git a/gen/hood/hi.hoon b/gen/hood/hi.hoon
index eb9099a98c..21e8a19c08 100644
--- a/gen/hood/hi.hoon
+++ b/gen/hood/hi.hoon
@@ -1,3 +1,4 @@
+::  Helm: send message to an urbit
 ::
 ::::  /hoon/hi/hood/gen
   ::
diff --git a/gen/hood/init-auth-basic.hoon b/gen/hood/init-auth-basic.hoon
index 1d9ecdc11e..3fa8d97826 100644
--- a/gen/hood/init-auth-basic.hoon
+++ b/gen/hood/init-auth-basic.hoon
@@ -1,3 +1,4 @@
+::  API: input basic auth credentials for domain
 ::
 ::::  /hoon/init-auth-basic/hood/gen
   ::
diff --git a/gen/hood/init-oauth1.hoon b/gen/hood/init-oauth1.hoon
index 552290ce55..af6fa47593 100644
--- a/gen/hood/init-oauth1.hoon
+++ b/gen/hood/init-oauth1.hoon
@@ -1,3 +1,4 @@
+::  API: input oauth1 application credentials for domain
 ::
 ::::  /hoon/init-oauth1/hood/gen
   ::
diff --git a/gen/hood/init-oauth2.hoon b/gen/hood/init-oauth2.hoon
index 04d9797a7a..a2a9bd6191 100644
--- a/gen/hood/init-oauth2.hoon
+++ b/gen/hood/init-oauth2.hoon
@@ -1,3 +1,4 @@
+::  API: input oauth2 application credentials for domain
 ::
 ::::  /hoon/init-oauth2/hood/gen
   ::
diff --git a/gen/hood/init-oauth2/google.hoon b/gen/hood/init-oauth2/google.hoon
index 3cf3dd4c66..3af0b202da 100644
--- a/gen/hood/init-oauth2/google.hoon
+++ b/gen/hood/init-oauth2/google.hoon
@@ -1,3 +1,4 @@
+::  API: input auth2 client_secret_*.json for .googleapis.com
 ::
 ::::  /hoon/google/init-oauth2/hood/gen
   ::
diff --git a/gen/hood/invite.hoon b/gen/hood/invite.hoon
index b89f938660..cc239a0c62 100644
--- a/gen/hood/invite.hoon
+++ b/gen/hood/invite.hoon
@@ -1,3 +1,4 @@
+::  Womb: allocate urbits to the holder of an email
 ::
 ::::  /hoon/invite/hood/gen
   ::
diff --git a/gen/hood/label.hoon b/gen/hood/label.hoon
index 03778b9ff3..e6ce218cdc 100644
--- a/gen/hood/label.hoon
+++ b/gen/hood/label.hoon
@@ -1,3 +1,4 @@
+::  Kiln: add label to current revision of desk
 ::
 ::::  /hoon/label/hood/gen
   ::
diff --git a/gen/hood/link.hoon b/gen/hood/link.hoon
index f748df95b9..a284f3da50 100644
--- a/gen/hood/link.hoon
+++ b/gen/hood/link.hoon
@@ -1,3 +1,4 @@
+::  Drum: Connect to a console-enabled app
 ::
 ::::  /hoon/link/hood/gen
   ::
diff --git a/gen/hood/load.hoon b/gen/hood/load.hoon
index 1ecd308599..bb05b5deec 100644
--- a/gen/hood/load.hoon
+++ b/gen/hood/load.hoon
@@ -1,3 +1,4 @@
+::  Hood, generic: load named hood component's state from backup
 ::
 ::::  /hoon/load/hood/gen
   ::
diff --git a/gen/hood/manage-old-key.hoon b/gen/hood/manage-old-key.hoon
index 92c75eb6d9..6a1f58db88 100644
--- a/gen/hood/manage-old-key.hoon
+++ b/gen/hood/manage-old-key.hoon
@@ -1,3 +1,4 @@
+::  Womb: use old-@p private key to distribute recycled invites
 ::
 ::::  /hoon/manage-old-key/hood/gen
   ::
diff --git a/gen/hood/manage.hoon b/gen/hood/manage.hoon
index 038a634ac3..9febc67235 100644
--- a/gen/hood/manage.hoon
+++ b/gen/hood/manage.hoon
@@ -1,3 +1,4 @@
+::  Womb: claim other ships' children  XX remove in cc-release
 ::
 ::::  /hoon/manage/hood/gen
   ::
diff --git a/gen/hood/mass.hoon b/gen/hood/mass.hoon
index e09ef26e68..43ff64fdc2 100644
--- a/gen/hood/mass.hoon
+++ b/gen/hood/mass.hoon
@@ -1,3 +1,4 @@
+::  Helm: show memory usage by vane
 ::
 ::::  /hoon/mass/hood/gen
   ::
diff --git a/gen/hood/merge.hoon b/gen/hood/merge.hoon
index 71ed24e9fd..84f0b5833b 100644
--- a/gen/hood/merge.hoon
+++ b/gen/hood/merge.hoon
@@ -1,3 +1,4 @@
+::  Kiln: Merge local desk from (optionally-)foreign one
 ::
 ::::  /hoon/merge/hood/gen
   ::
diff --git a/gen/hood/mount.hoon b/gen/hood/mount.hoon
index c8c4e17c81..5b28a06259 100644
--- a/gen/hood/mount.hoon
+++ b/gen/hood/mount.hoon
@@ -1,3 +1,4 @@
+::  Kiln: Mount path to unix
 ::
 ::::  /hoon/mount/hood/gen
   ::
diff --git a/gen/hood/mv.hoon b/gen/hood/mv.hoon
index 6a0199b7be..36c200f080 100644
--- a/gen/hood/mv.hoon
+++ b/gen/hood/mv.hoon
@@ -1,3 +1,4 @@
+::  Kiln: Move file in clay
 ::
 ::::  /hoon/mv/hood/gen
   ::
diff --git a/gen/hood/overload.hoon b/gen/hood/overload.hoon
index 70be6cfdb8..dd60033a15 100644
--- a/gen/hood/overload.hoon
+++ b/gen/hood/overload.hoon
@@ -1,3 +1,4 @@
+::  Kiln: regularly clear %ford cache  XX find relevant leak
 ::
 ::::  /hoon/overload/hood/gen
   ::
diff --git a/gen/hood/rc.hoon b/gen/hood/rc.hoon
index 5cd208bd77..6b2d889afa 100644
--- a/gen/hood/rc.hoon
+++ b/gen/hood/rc.hoon
@@ -1,3 +1,4 @@
+::  Helm: Reload %clay
 ::
 ::::  /hoon/rc/hood/gen
   ::
diff --git a/gen/hood/reboot.hoon b/gen/hood/reboot.hoon
index dbd8944d3b..421a4482b2 100644
--- a/gen/hood/reboot.hoon
+++ b/gen/hood/reboot.hoon
@@ -1,3 +1,4 @@
+::  Helm: Reload %zuse and all vanes
 ::
 ::::  /hoon/reboot/hood/gen
   ::
diff --git a/gen/hood/reinvite.hoon b/gen/hood/reinvite.hoon
index cf29a256d6..336e2f6001 100644
--- a/gen/hood/reinvite.hoon
+++ b/gen/hood/reinvite.hoon
@@ -1,3 +1,4 @@
+::  Womb: Transfer urbits from existing invite XX add parameters
 ::
 ::::  /hoon/reinvite/hood/gen
   ::
diff --git a/gen/hood/rekey.hoon b/gen/hood/rekey.hoon
index 958667106a..7adb2e9ee9 100644
--- a/gen/hood/rekey.hoon
+++ b/gen/hood/rekey.hoon
@@ -1,3 +1,4 @@
+::  Womb: cycle private key XX unimplemented
 ::
 ::::  /hoon/rekey/hood/gen
   ::
diff --git a/gen/hood/release-ships.hoon b/gen/hood/release-ships.hoon
index 1c0e95ed5b..7cc789182b 100644
--- a/gen/hood/release-ships.hoon
+++ b/gen/hood/release-ships.hoon
@@ -1,3 +1,4 @@
+::  Womb: release specific ships for public claiming
 ::
 ::::  /hoon/release/hood/gen
   ::
diff --git a/gen/hood/release.hoon b/gen/hood/release.hoon
index 9a26eb3702..23df973c47 100644
--- a/gen/hood/release.hoon
+++ b/gen/hood/release.hoon
@@ -1,3 +1,4 @@
+::  Womb: release a nuber of ships for public claiming
 ::
 ::::  /hoon/release/hood/gen
   ::
diff --git a/gen/hood/reload-desk.hoon b/gen/hood/reload-desk.hoon
index 1864654126..a8d5f7f02b 100644
--- a/gen/hood/reload-desk.hoon
+++ b/gen/hood/reload-desk.hoon
@@ -1,3 +1,4 @@
+::  Helm: Reload vane/s from desk
 ::
 ::::  /hoon/reload-desk/hood/gen
   ::
diff --git a/gen/hood/reload.hoon b/gen/hood/reload.hoon
index d6bd2187e5..24298f2fbc 100644
--- a/gen/hood/reload.hoon
+++ b/gen/hood/reload.hoon
@@ -1,3 +1,4 @@
+::  Helm: Reload vane/s
 ::
 ::::  /hoon/reload/hood/gen
   ::
diff --git a/gen/hood/replay-womb-log.hoon b/gen/hood/replay-womb-log.hoon
index 6d6cdbd100..9c256fd96d 100644
--- a/gen/hood/replay-womb-log.hoon
+++ b/gen/hood/replay-womb-log.hoon
@@ -1,5 +1,6 @@
+::  Womb: replay events from a future lost XX move to jael
 ::
-::::  /hoon/reinvite/hood/gen
+::::  /hoon/replay-womb-log/hood/gen
   ::
 /?    310
 /+    womb
diff --git a/gen/hood/reset.hoon b/gen/hood/reset.hoon
index 5cd90af814..639ac1a82a 100644
--- a/gen/hood/reset.hoon
+++ b/gen/hood/reset.hoon
@@ -1,3 +1,4 @@
+::  Helm: Reload hoon/hoon and all vanes
 ::
 ::::  /hoon/reset/hood/gen
   ::
diff --git a/gen/hood/rf.hoon b/gen/hood/rf.hoon
index 9b7b3ca0f1..e469b8de82 100644
--- a/gen/hood/rf.hoon
+++ b/gen/hood/rf.hoon
@@ -1,3 +1,4 @@
+::  Helm: Reload %ford
 ::
 ::::  /hoon/rf/hood/gen
   ::
diff --git a/gen/hood/rm.hoon b/gen/hood/rm.hoon
index 3a3e494dfe..5ada6c0ca4 100644
--- a/gen/hood/rm.hoon
+++ b/gen/hood/rm.hoon
@@ -1,3 +1,4 @@
+::  Kiln: Remove file from clay
 ::
 ::::  /hoon/rm/hood/gen
   ::
diff --git a/gen/hood/save.hoon b/gen/hood/save.hoon
index 2f0916cc5c..480e86b13a 100644
--- a/gen/hood/save.hoon
+++ b/gen/hood/save.hoon
@@ -1,3 +1,4 @@
+::  Hood, generic: save named hood component's state
 ::
 ::::  /hoon/save/hood/gen
   ::
diff --git a/gen/hood/schedule.hoon b/gen/hood/schedule.hoon
index 17aed3a38c..c399fe36de 100644
--- a/gen/hood/schedule.hoon
+++ b/gen/hood/schedule.hoon
@@ -1,3 +1,4 @@
+::  Kiln: add entry to a .sched  XX belongs in Write
 ::
 ::::  /hoon/schedule/hood/gen
   ::
diff --git a/gen/hood/serve.hoon b/gen/hood/serve.hoon
index 684e92412d..48af1e805d 100644
--- a/gen/hood/serve.hoon
+++ b/gen/hood/serve.hoon
@@ -1,3 +1,4 @@
+::  Eyre: set web root
 ::
 ::::  /hoon/serve/hood/gen
   ::
diff --git a/gen/hood/start.hoon b/gen/hood/start.hoon
index a361d3467a..15a93d3e45 100644
--- a/gen/hood/start.hoon
+++ b/gen/hood/start.hoon
@@ -1,3 +1,4 @@
+::  Drum: boot unstarted app
 ::
 ::::  /hoon/start/hood/gen
   ::
diff --git a/gen/hood/sync.hoon b/gen/hood/sync.hoon
index 17d39a1ba0..b128d5498a 100644
--- a/gen/hood/sync.hoon
+++ b/gen/hood/sync.hoon
@@ -1,3 +1,4 @@
+::  Kiln: Continuously merge local desk from (optionally-)foreign one
 ::
 ::::  /hoon/sync/hood/gen
   ::
diff --git a/gen/hood/syncs.hoon b/gen/hood/syncs.hoon
index 5aa5439998..6f761c4e0c 100644
--- a/gen/hood/syncs.hoon
+++ b/gen/hood/syncs.hoon
@@ -1,3 +1,4 @@
+::  Kiln: List active syncs
 ::
 ::::  /hoon/syncs/hood/gen
   ::
diff --git a/gen/hood/track.hoon b/gen/hood/track.hoon
index 4c44eea67d..d328c625ed 100644
--- a/gen/hood/track.hoon
+++ b/gen/hood/track.hoon
@@ -1,3 +1,4 @@
+::  Kiln: merge each version of remote desk? XX clarify
 ::
 ::::  /hoon/track/hood/gen
   ::
diff --git a/gen/hood/transfer.hoon b/gen/hood/transfer.hoon
index 6468cb2e26..431506c350 100644
--- a/gen/hood/transfer.hoon
+++ b/gen/hood/transfer.hoon
@@ -1,3 +1,4 @@
+::  Womb: move all contents of invite to new email
 ::
 ::::  /hoon/transfer/hood/gen
   ::
diff --git a/gen/hood/unlink.hoon b/gen/hood/unlink.hoon
index 15e7188be8..a0473e4ebf 100644
--- a/gen/hood/unlink.hoon
+++ b/gen/hood/unlink.hoon
@@ -1,3 +1,4 @@
+::  Drum: disconnect from console app
 ::
 ::::  /hoon/unlink/hood/gen
   ::
diff --git a/gen/hood/unmount.hoon b/gen/hood/unmount.hoon
index 4cfedaf013..a47feadddc 100644
--- a/gen/hood/unmount.hoon
+++ b/gen/hood/unmount.hoon
@@ -1,3 +1,4 @@
+::  Kiln: Remove unix mount
 ::
 ::::  /hoon/unmount/hood/gen
   ::
diff --git a/gen/hood/unsync.hoon b/gen/hood/unsync.hoon
index 36db12c6c8..de61cfec3b 100644
--- a/gen/hood/unsync.hoon
+++ b/gen/hood/unsync.hoon
@@ -1,3 +1,4 @@
+::  Kiln: Remove a sync
 ::
 ::::  /hoon/unsync/hood/gen
   ::
diff --git a/gen/hood/verb.hoon b/gen/hood/verb.hoon
index 40bfd8b351..e3421f04d0 100644
--- a/gen/hood/verb.hoon
+++ b/gen/hood/verb.hoon
@@ -1,3 +1,4 @@
+::  Arvo: toggle "verbose mode" internal event tracing
 ::
 ::::  /hoon/verb/hood/gen
   ::
diff --git a/gen/ls/subdir.hoon b/gen/ls/subdir.hoon
index c565c437fb..48c07f4973 100644
--- a/gen/ls/subdir.hoon
+++ b/gen/ls/subdir.hoon
@@ -1,3 +1,4 @@
+::  Filesystem iterator XX move to lib/
 ::
 ::::  /hoon/subdir/ls/gen
   ::
diff --git a/gen/moon.hoon b/gen/moon.hoon
index 017cccc552..2e26b875b9 100644
--- a/gen/moon.hoon
+++ b/gen/moon.hoon
@@ -1,3 +1,4 @@
+::  Generate random moon and corresponding ticket
 ::
 ::::  /hoon/moon/gen
   ::
diff --git a/gen/pope.hoon b/gen/pope.hoon
index eab5c1abbe..93d637e435 100644
--- a/gen/pope.hoon
+++ b/gen/pope.hoon
@@ -1,3 +1,4 @@
+::  Create a galactic generator and ames-ready fingerprint
 ::
 ::::  /hoon/pope/gen
   ::
diff --git a/gen/solid.hoon b/gen/solid.hoon
index 39e3ef5e5d..a0281f0f0d 100644
--- a/gen/solid.hoon
+++ b/gen/solid.hoon
@@ -1,3 +1,4 @@
+::  Compile arvo as a pill noun, usage .urbit/pill +solid
 ::
 ::::  /hoon/solid/gen
   ::
diff --git a/gen/talk/federate.hoon b/gen/talk/federate.hoon
index 0bea0b60be..1cb9d42942 100644
--- a/gen/talk/federate.hoon
+++ b/gen/talk/federate.hoon
@@ -1,3 +1,4 @@
+::  Set upstream sources for channel
 ::
 ::::  /hoon/federate/talk/gen
   ::
diff --git a/gen/talk/load.hoon b/gen/talk/load.hoon
index f2a3390554..ca82034d14 100644
--- a/gen/talk/load.hoon
+++ b/gen/talk/load.hoon
@@ -1,3 +1,4 @@
+::  Load channel messages from backup
 ::
 ::::  /hoon/load/talk/gen
   ::
diff --git a/gen/talk/log.hoon b/gen/talk/log.hoon
index ccf3f1148d..a60a207c9f 100644
--- a/gen/talk/log.hoon
+++ b/gen/talk/log.hoon
@@ -1,3 +1,4 @@
+::  Enable channel logging to clay
 ::
 ::::  /hoon/log/talk/gen
   ::
diff --git a/gen/talk/save.hoon b/gen/talk/save.hoon
index 6b430506f2..a9f96c7b1e 100644
--- a/gen/talk/save.hoon
+++ b/gen/talk/save.hoon
@@ -1,3 +1,4 @@
+::  Save channel messages to backup
 ::
 ::::  /hoon/save/talk/gen
   ::
diff --git a/gen/talk/unlog.hoon b/gen/talk/unlog.hoon
index fa8bab19b3..1bc30e7bd6 100644
--- a/gen/talk/unlog.hoon
+++ b/gen/talk/unlog.hoon
@@ -1,3 +1,4 @@
+::  Disable channel logging to clay
 ::
 ::::  /hoon/unlog/talk/gen
   ::
diff --git a/gen/ticket.hoon b/gen/ticket.hoon
index d985bbcfef..da86fc6c46 100644
--- a/gen/ticket.hoon
+++ b/gen/ticket.hoon
@@ -1,3 +1,4 @@
+::  generate secret for starting a ship XX |ticket in cc-release
 ::
 ::::  /hoon/ticket/gen
   ::
diff --git a/gen/twit/as.hoon b/gen/twit/as.hoon
index 0130b74654..29d42730f5 100644
--- a/gen/twit/as.hoon
+++ b/gen/twit/as.hoon
@@ -1,3 +1,7 @@
+::  Send tweet from an account
+::
+::::  /hoon/as/twit/gen
+  ::
 /-    twitter
 ::
 ::::
diff --git a/gen/womb/balance.hoon b/gen/womb/balance.hoon
index 4a030d9a9e..00c0cbd5f1 100644
--- a/gen/womb/balance.hoon
+++ b/gen/womb/balance.hoon
@@ -1,3 +1,4 @@
+::  Inspect invite contents
 ::
 ::::  /hoon/balance/womb/gen
   ::
diff --git a/gen/womb/balances.hoon b/gen/womb/balances.hoon
index 6841043d77..03a42f0711 100644
--- a/gen/womb/balances.hoon
+++ b/gen/womb/balances.hoon
@@ -1,3 +1,4 @@
+::  Inspect all invites
 ::
 ::::  /hoon/balance/womb/gen
   ::
diff --git a/gen/womb/shop.hoon b/gen/womb/shop.hoon
index b0dc0a1881..f9138d0e87 100644
--- a/gen/womb/shop.hoon
+++ b/gen/womb/shop.hoon
@@ -1,3 +1,4 @@
+::  Browse random claimable ships
 ::
 ::::  /hoon/shop/womb/gen
   ::