diff --git a/packages/orchestration/README.md b/packages/orchestration/README.md
index 19d382cd9c23..8369097ddde4 100644
--- a/packages/orchestration/README.md
+++ b/packages/orchestration/README.md
@@ -1,4 +1,5 @@
 # Orchestration
 
-
 Interface for Cosmos Interchain Accounts [(ICS-27)](https://github.com/cosmos/ibc/blob/main/spec/app/ics-027-interchain-accounts/README.md).
+
+Usage examples can be found in the [test/examples](https://github.com/Agoric/agoric-sdk/tree/master/packages/orchestration/test/examples) directory.
diff --git a/packages/orchestration/typedoc.json b/packages/orchestration/typedoc.json
index 3d381684efd6..866c621516ef 100644
--- a/packages/orchestration/typedoc.json
+++ b/packages/orchestration/typedoc.json
@@ -2,5 +2,7 @@
   "extends": [
     "../../typedoc.base.json"
   ],
-  "entryPoints": []
+  "entryPoints": [
+    "index.js",
+  ]
 }