diff --git a/packages/feeds/README.md b/packages/feeds/README.md
new file mode 100644
index 0000000..b7682dc
--- /dev/null
+++ b/packages/feeds/README.md
@@ -0,0 +1,33 @@
+# @coracle.social/feeds
+
+A custom feed compiler and loader for nostr.
+
+# Example
+
+```javascript
+// Configure the feed loader so it can access your app's context and make requests
+const loader = new FeedLoader({
+  request,
+  requestDvm,
+  getPubkeysForScope,
+  getPubkeysForWotRange,
+})
+
+// Define a feed using set operations
+const feed = intersection(
+  union(
+    dvm({kind: 5300, pubkey: '19b78ccfa7c5e31e6bacbb3f2a1703f64b62017702e584440bf29a7e16263e8c'}),
+    list("10003:19ba654f26afd4930fd3d51baf4e26f1413b7aeec7190cd6c0cdf4d2f14cec6b:"),
+  )
+  filter({
+    min_wot: 0.1,
+    scopes: ["global"],
+  }),
+)
+
+// Load notes using the feed
+loader.compiler.getLoader(feed, {
+  onEvent: event => console.log("Event", event),
+  onExhausted: () =>  console.log("Exhausted"),
+})
+```
diff --git a/packages/feeds/core.ts b/packages/feeds/core.ts
index 91ab9f8..087070e 100644
--- a/packages/feeds/core.ts
+++ b/packages/feeds/core.ts
@@ -17,6 +17,7 @@ export enum FeedType {
 
 export enum Scope {
   Self = "self",
+  Global = "global",
   Follows = "follows",
   Followers = "followers",
 }