chore: more docs tweaks

Author: bholmesdev

README.md

@@ -8,10 +8,10 @@ Simple stack is a suite of tools built for [Astro](https://astro.build) to simpl
 
 Simple stack offers a growing collection of packages:
 
-- **[🧘‍♂️ Simple form](https://simple-stack.dev/form):** A full stack solution to validate forms with your client framework of choice.
-- **[🔎 Simple scope](https://simple-stack.dev/scope):** Get a scoped ID for any file you're in. Perfect for form label IDs and query selectors.
-- **[🌊 Simple stream](https://simple-stack.dev/stream):** Suspend Astro components with fallback content.
-- **[⏳ WIP: Simple partial](https://simple-stack.dev/partial):** Re-render just the parts that change in your Astro app.
+- **[🔎 Simple query](/query):** The simplest way to query elements from your Astro component.
+- **[🌊 Simple stream](/stream):** Suspend Astro components with fallback content.
+- **[🧘‍♂️ Simple form](/form):** A full stack solution to validate forms with your client framework of choice.
+- **[🔎 Simple scope](/scope):** A scoped ID generator for any file you're in. Perfect for form label IDs and query selectors.
 
 ## Get involved
 

packages/query/README.md

@@ -35,7 +35,7 @@ Selectors should be applied to the `data-target` attribute. All selectors are sc
 <!--data-target="btn-4SzN_OBB"-->
 ```
 
-From your client script, the query result will be a plain HTML element. No, it's not a JQuery object. But who doesn't like a little nostalgia?
+Then, use the same `$()` function from your client script to select that element. The query result will be a plain [`HTMLElement`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement). No, it's not a JQuery object. We just used `$` for the nostalgia 😉
 
 ```ts
 $('btn').addEventListener(() => { /* ... */ });
@@ -69,7 +69,7 @@ ready(() => {
 
 ### `$.all()` selector
 
-You may want to select multiple targets with the same name. You can use `$.all()` to query for an array of results:
+You may want to select multiple targets with the same name. Use `$.all()` to query for an array of results:
 
 ```astro
 ---
@@ -87,7 +87,7 @@ ready(() => {
 </script>
 ```
 
-### `$.ready()` function
+## `$.ready()` function
 
 All `$` queries must be nested in a `$.ready()` block. This opts in to using the global `$` from client scripts. `$.ready()` also ensures your code reruns on every page [when view transitions are enabled.](https://docs.astro.build/en/guides/view-transitions/)
 

www/src/content/docs/query.md

@@ -38,7 +38,7 @@ Selectors should be applied to the `data-target` attribute. All selectors are sc
 <!--data-target="btn-4SzN_OBB"-->
 ```
 
-From your client script, the query result will be a plain HTML element. No, it's not a JQuery object. But who doesn't like a little nostalgia?
+Then, use the same `$()` function from your client script to select that element. The query result will be a plain [`HTMLElement`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement). No, it's not a JQuery object. We just used `$` for the nostalgia 😉
 
 ```ts
 $('btn').addEventListener(() => { /* ... */ });
@@ -72,7 +72,7 @@ ready(() => {
 
 ### `$.all()` selector
 
-You may want to select multiple targets with the same name. You can use `$.all()` to query for an array of results:
+You may want to select multiple targets with the same name. Use `$.all()` to query for an array of results:
 
 ```astro
 ---