diff --git a/packages/form/README.md b/packages/form/README.md
index 54233d8..5d45738 100644
--- a/packages/form/README.md
+++ b/packages/form/README.md
@@ -33,4 +33,4 @@ if (result?.data) {
 </form>
 ```
 
-📚 Visit [the docs](https://simple-stack-docs.vercel.app/packages/form) for more information
+📚 Visit [the docs](https://simple-stack-docs.vercel.app/form) for more information and usage examples.
diff --git a/packages/partial/README.md b/packages/partial/README.md
new file mode 100644
index 0000000..c5b57fa
--- /dev/null
+++ b/packages/partial/README.md
@@ -0,0 +1,7 @@
+# ⏳ Simple Partial
+
+> Re-render just the parts that change in your Astro app.
+
+Package coming soon! Here's a sneak peak at the APIs we're exploring.
+
+<video controls width="100%" style="aspect-ratio:1.33/1" src="../../www/public/assets/astro-partial-rendering-demo.mp4"></video>
diff --git a/packages/scope/README.md b/packages/scope/README.md
index c7f84bc..f751d48 100644
--- a/packages/scope/README.md
+++ b/packages/scope/README.md
@@ -24,4 +24,4 @@ Output:
 */
 ```
 
-📚 Visit [the docs](https://simple-stack-docs.vercel.app/packages/scope) for more information
+📚 Visit [the docs](https://simple-stack-docs.vercel.app/scope) for more information and usage examples.
diff --git a/packages/stream/README.md b/packages/stream/README.md
index 5df2dd6..92c195e 100644
--- a/packages/stream/README.md
+++ b/packages/stream/README.md
@@ -24,4 +24,5 @@ import { Suspense, ResolveSuspended } from 'simple-stack-stream/components';
 <ResolveSuspended />
 ```
 
-📚 Visit [the docs](https://simple-stack-docs.vercel.app/packages/stream) for more information
+
+📚 Visit [the docs](https://simple-stack-docs.vercel.app/stream) for more information and usage examples.
diff --git a/www/src/content/docs/packages/form.md b/www/src/content/docs/form.md
similarity index 100%
rename from www/src/content/docs/packages/form.md
rename to www/src/content/docs/form.md
diff --git a/www/src/content/docs/packages/partial.md b/www/src/content/docs/partial.md
similarity index 100%
rename from www/src/content/docs/packages/partial.md
rename to www/src/content/docs/partial.md
diff --git a/www/src/content/docs/packages/scope.md b/www/src/content/docs/scope.md
similarity index 100%
rename from www/src/content/docs/packages/scope.md
rename to www/src/content/docs/scope.md
diff --git a/www/src/content/docs/packages/stream.md b/www/src/content/docs/stream.md
similarity index 100%
rename from www/src/content/docs/packages/stream.md
rename to www/src/content/docs/stream.md