Cleanup readmes

Co-authored-by: Till Schneidereit <[email protected]>

Author: karthik2804

README.md

@@ -65,7 +65,9 @@ To learn more about the JS SDK checkout the [documentation](https://developer.fe
 
 ## Structure of this repository
 
-This repository contains multiple packages under the [`packages/`](./packages/) directory. Each pacakge contains that contains a `spin-` prefix hosts modules that can be used to enable access to the various Spin interfaces. There are other kind of packages as well, namely triggers and `build-tools`. 
+This repository contains multiple packages under the [`packages/`](./packages/) directory. Packages whose names start with `spin-` host provide access to Spin-specific interfaces, whereas the `http-trigger` package can be used for creating runtime-agnostic components that just rely on `wasi:[email protected]`.
+
+The `build-tools` package provides the tools for componentizing JavaScript/TypeScript source code, regardless of the interfaces used.
 
 The `examples` directory contains various examples of common patterns and using popular SDKs.
 

packages/build-tools/README.md

@@ -19,7 +19,7 @@ Options:
   -d, --debug    Enable JavaScript debugging                           [boolean]
 ```
 
-**Note:** The input source should be Javascript. 
+**Note:** The input source must be JavaScript. Use `tsc` or a bundler to first translate source code in TypeScript or other languages.
 
 #### `wit-tools` crate
 

packages/build-tools/crates/wit-tools/README.md

@@ -12,7 +12,7 @@ The `wit` world that the library implements is defined in the [`wit` directory](
 
 ### Building
 
-The component can be build by running 
+The component can be built by running 
 
 ```bash
 cargo build --release

packages/http-trigger/README.md

@@ -1,3 +1,3 @@
 # Wasi HTTP Proxy
 
-This package enables adding the `wasi:http` trigger export to apps built using the `@spinframework/build-tools`. This repository does not contain any code, it just contains the `wit` files describing the `wasi/http` world.
+This package enables adding the `wasi:http` trigger export to apps built using the `@spinframework/build-tools`. This repository does not contain any code, it just contains the `wit` files describing the `wasi:http` package.

packages/spin-kv/README.md

@@ -1,3 +1,3 @@
 # Spin KV
 
-This package provides bindings that enables using the Spin Key Value interface in apps built using the `@spinframework/build-tools`.
+This package provides bindings that enable using the Spin Key-Value interface in apps built using the `@spinframework/build-tools`.

packages/spin-llm/README.md

@@ -1,3 +1,3 @@
 # Spin LLM
 
-This package provides bindings that enables using the Spin LLM interface in apps built using the `@spinframework/build-tools`.
+This package provides bindings that enable using the Spin LLM interface in apps built using the `@spinframework/build-tools`.

packages/spin-mqtt/README.md

@@ -1,3 +1,3 @@
 # Spin MQTT
 
-This package provides bindings that enables using the Spin MQTT interface in apps built using the `@spinframework/build-tools`.
+This package provides bindings that enable using the Spin MQTT interface in apps built using the `@spinframework/build-tools`.

packages/spin-mysql/README.md

@@ -1,3 +1,3 @@
-# Spin Mysql
+# Spin MySQL
 
-This package provides bindings that enables using the Spin Mysql interface in apps built using the `@spinframework/build-tools`.
+This package provides bindings that enable using the Spin MySQL interface in apps built using the `@spinframework/build-tools`.

packages/spin-postgres/README.md

@@ -1,3 +1,3 @@
 # Spin Postgres
 
-This package provides bindings that enables using the Spin Postgres interface in apps built using the `@spinframework/build-tools`.
+This package provides bindings that enable using the Spin Postgres interface in apps built using the `@spinframework/build-tools`.

packages/spin-postgres3/README.md

@@ -1,3 +1,3 @@
 # Spin Postgres v3
 
-This package provides bindings that enables using the Spin Postgres v3 interface in apps built using the `@spinframework/build-tools`.
+This package provides bindings that enable using the Spin Postgres v3 interface in apps built using the `@spinframework/build-tools`.