Skip to content

Commit bddfd09

Browse files
ericgregoryclaude
authored andcommitted
docs(examples): update READMEs for all examples
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Signed-off-by: Eric Gregory <eric@cosmonic.com>
1 parent a178054 commit bddfd09

6 files changed

Lines changed: 32 additions & 38 deletions

File tree

examples/components/bundled-esbuild/README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
# Typescript component bundled with esbuild
22

3-
This repository contains a custom wasm component, written in [Typescript][ts].
3+
This repository contains a custom wasm component, written in [TypeScript][ts].
44

55
This component:
66

7-
- Uses [Typescript][ts] for it's implementation
7+
- Uses [TypeScript][ts] for it's implementation
88
- Bundles with [esbuild][esbuild]
99

1010
[ts]: https://www.typescriptlang.org/
@@ -23,11 +23,11 @@ Building this project relies on the following software:
2323

2424
| Name | Description |
2525
| ------ | ----------------------------------------------------------------------------------------------------------- |
26-
| `wash` | [Wasmcloud Shell][wash] controls your [wasmcloud][wasmcloud] host instances and enables building components |
26+
| `wash` | [Wasm Shell][wash] controls your [wasmcloud][wasmcloud] host instances and enables building components |
2727
| `npm` | [Node Package Manager (NPM)][npm] which manages packages for for the NodeJS ecosystem |
2828
| `node` | [NodeJS runtime][nodejs] (see `.nvmrc` for version) |
2929

30-
[wash]: https://github.com/wasmCloud/wasmCloud/tree/main/crates/wash-cli
30+
[wash]: https://wasmcloud.com/docs/installation/#install-wash
3131
[node]: https://nodejs.org
3232
[npm]: https://github.com/npm/cli
3333

@@ -49,7 +49,7 @@ The main entry point is the `start` script (i.e. `npm start`) which performs the
4949

5050
- `npm install` to download all dependencies
5151
- building the component
52-
- transpiling the component so it can be called from javascript
52+
- transpiling the component so it can be called from JavaScript
5353
- running the demo.js script
5454

5555
## Bundling

examples/components/bundled-rsbuild/README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
# Typescript component bundled with rslib/rsbuild
22

3-
This repository contains a hello world HTTP component, written in [Typescript][ts].
3+
This repository contains a hello world HTTP component, written in [TypeScript][ts].
44

55
This component:
66

7-
- Uses [Typescript][ts] for it's implementation
7+
- Uses [TypeScript][ts] for its implementation
88
- Bundles with [rslib][rslib]
99

1010
[ts]: https://www.typescriptlang.org/
@@ -23,11 +23,11 @@ Building this project relies on the following software:
2323

2424
| Name | Description |
2525
| ------ | ----------------------------------------------------------------------------------------------------------- |
26-
| `wash` | [Wasmcloud Shell][wash] controls your [wasmcloud][wasmcloud] host instances and enables building components |
26+
| `wash` | [Wasm Shell][wash] controls your [wasmCloud][wasmcloud] host instances and enables building components |
2727
| `npm` | [Node Package Manager (NPM)][npm] which manages packages for for the NodeJS ecosystem |
2828
| `node` | [NodeJS runtime][nodejs] (see `.nvmrc` for version) |
2929

30-
[wash]: https://github.com/wasmCloud/wasmCloud/tree/main/crates/wash-cli
30+
[wash]: https://wasmcloud.com/docs/installation/#install-wash
3131
[node]: https://nodejs.org
3232
[npm]: https://github.com/npm/cli
3333

@@ -52,4 +52,4 @@ See package.json for the exact commands being run. But what `npm start` does is:
5252

5353
## Bundling
5454

55-
It uses rslib to bundling the javascript together with the dependencies. See the [`rslib.config.rs`](https://github.com/wasmCloud/typescript/blob/main/examples/components/bundled-rsbuild/rslib.config.ts) file in the example folder for more details.
55+
It uses rslib to bundling the JavaScript together with the dependencies. See the [`rslib.config.rs`](https://github.com/wasmCloud/typescript/blob/main/examples/components/bundled-rsbuild/rslib.config.ts) file in the example folder for more details.

examples/components/http-axios/README.md

Lines changed: 8 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Typescript Axios example CLI
1+
# TypeScript Axios example CLI
22

33
This repository contains a WebAssembly Component written in [Typescript][ts], which:
44

@@ -12,8 +12,8 @@ the widely used HTTP request library `axios`.
1212

1313
[axios]: https://www.npmjs.com/package/axios
1414
[ts]: https://www.typescriptlang.org/
15-
[wasi-cli]: clis://github.com/WebAssembly/wasi-cli
16-
[wasmcloud]: https://wasmcloud.com/docs/intro
15+
[wasi-cli]: https://wasmcloud.com/docs/installation/#install-wash
16+
[wasmcloud]: https://wasmcloud.com/docs/
1717
[wasmtime]: https://wasmtime.dev
1818
[jco]: https://github.com/bytecodealliance/jco
1919

@@ -35,7 +35,7 @@ Building this project relies on the following installed software:
3535
| `node` | [NodeJS runtime][nodejs] (see `.nvmrc` for version) |
3636
| `wkg` | (optional) [wasm-pkg-tools][wasm-pkg-tools] project that makes it easy to pull down WIT definitions |
3737

38-
[wash]: https://github.com/wasmCloud/wasmCloud/tree/main/crates/wash-cli
38+
[wash]: https://wasmcloud.com/docs/installation/#install-wash
3939
[node]: https://nodejs.org
4040
[npm]: https://github.com/npm/cli
4141
[wasm-pkg-tools]: https://github.com/bytecodealliance/wasm-pkg-tools
@@ -55,20 +55,14 @@ To get into a rapid development loop, clone the repo and run `wash dev`:
5555
```console
5656
wash dev
5757
```
58-
5958
`wash dev` does many things for you:
6059

6160
- Starts the [wasmCloud host][wasmcloud-host] that can run your WebAssembly component
6261
- Builds this project (including necessary `npm` script targets)
63-
- Builds a declarative WADM manifest consisting of:
64-
- Your locally built component
65-
- A [HTTP server provider][http-client-provider] which will peform outgoing requests on your component's behalf
66-
- Necessary links between providers and your component so your component can make requests
67-
- Deploys the built manifest (i.e all dependencies to run this application) locally
68-
- Watches your code for changes and re-deploys when necessary.
62+
- Deploys an HTTP server on port 8000 and links it to your component
63+
- Watches your code for changes and re-deploys when necessary
6964

70-
[wasmcloud-host]: https://wasmcloud.com/docs/concepts/hosts
71-
[httpclient-provider]: https://github.com/wasmCloud/wasmCloud/tree/main/crates/providers-http-client
65+
[wasmcloud-host]: https://wasmcloud.com/docs/overview/hosts
7266

7367
## With `jco`
7468

@@ -141,4 +135,4 @@ wash call wasmcloud:examples/invoke.call
141135

142136
## Adding Capabilities
143137

144-
To learn how to extend this example with additional capabilities, see the [Adding Capabilities](https://wasmcloud.com/docs/tour/adding-capabilities?lang=typescript) section of the wasmCloud documentation.
138+
To learn how to extend this example with additional capabilities, see the [TypeScript Language Guide](https://wasmcloud.com/docs/wash/developer-guide/language-support/typescript/) in the wasmCloud documentation.

examples/components/http-hello-world/README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -28,13 +28,13 @@ Building this project relies on the following software:
2828
| `npm` | [Node Package Manager (NPM)][npm] manages packages for the NodeJS ecosystem |
2929
| `node` | [NodeJS runtime][nodejs] (see `.nvmrc` for version) |
3030

31-
[wash]: https://github.com/wasmCloud/wash
31+
[wash]: https://wasmcloud.com/docs/installation/#install-wash
3232
[node]: https://nodejs.org
3333
[npm]: https://github.com/npm/cli
3434

3535
# Quickstart
3636

37-
To get started developing this repository quickly, clone the repo and run `wash dev`:
37+
To get started developing this project quickly, clone the repo and run `wash dev` in this directory:
3838

3939
```console
4040
wash dev
@@ -56,4 +56,4 @@ curl localhost:8000
5656

5757
## Adding Capabilities
5858

59-
To learn how to extend this example with additional capabilities, see the [Adding Capabilities](https://wasmcloud.com/docs/tour/adding-capabilities?lang=typescript) section of the wasmCloud documentation.
59+
To learn how to extend this example with additional capabilities, see the [TypeScript Language Guide](https://wasmcloud.com/docs/wash/developer-guide/language-support/typescript/) in the wasmCloud documentation.

examples/components/http-password-checker/README.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Typescript HTTP Password Checker
22

3-
This repository contains a WebAssembly Component written in [Typescript][ts], which:
3+
This repository contains a WebAssembly Component written in [TypeScript][ts], which:
44

55
- Implements a [`wasi:http`][wasi-http]-compliant HTTP handler
66
- Provides an API for checking password strength
@@ -13,7 +13,7 @@ This example also demonstrates using JS ecosystem packages in a Wasm component,
1313

1414
[ts]: https://www.typescriptlang.org/
1515
[wasi-http]: https://github.com/WebAssembly/wasi-http
16-
[wasmcloud]: https://wasmcloud.com/docs/intro
16+
[wasmcloud]: https://wasmcloud.com/docs/
1717
[zod]: https://github.com/colinhacks/zod
1818
[valibot]: https://github.com/fabian-hiller/valibot
1919
[npm-check-password-strength]: https://www.npmjs.com/package/check-password-strength
@@ -31,11 +31,11 @@ Building this project relies on the following installed software:
3131

3232
| Name | Description |
3333
| ------ | ---------------------------------------------------------------------------------------------------- |
34-
| `wash` | [Wasmcloud Shell][wash] controls your [wasmcloud][wasmcloud] host instances and enables building components (version >= 2.0) |
34+
| `wash` | [Wasm Shell][wash] controls your [wasmCloud][wasmcloud] host instances and enables building components (version >= 2.0) |
3535
| `npm` | [Node Package Manager (NPM)][npm] which manages packages for the NodeJS ecosystem |
3636
| `node` | [NodeJS runtime][nodejs] (see `.nvmrc` for version) |
3737

38-
[wash]: https://github.com/wasmCloud/wasmCloud/tree/main/crates/wash-cli
38+
[wash]: https://wasmcloud.com/docs/installation/#install-wash
3939
[node]: https://nodejs.org
4040
[npm]: https://github.com/npm/cli
4141

@@ -54,7 +54,7 @@ wash dev
5454
- Deploys an HTTP server on port 8000 and links it to your component
5555
- Watches your code for changes and re-deploys when necessary
5656

57-
[wasmcloud-host]: https://wasmcloud.com/docs/concepts/hosts
57+
[wasmcloud-host]: https://wasmcloud.com/docs/overview/hosts/
5858

5959
## Send a request to the running component
6060

@@ -79,7 +79,7 @@ You should see a JSON response like:
7979

8080
## Adding Capabilities
8181

82-
To learn how to extend this example with additional capabilities, see the [Adding Capabilities](https://wasmcloud.com/docs/tour/adding-capabilities?lang=typescript) section of the wasmCloud documentation.
82+
To learn how to extend this example with additional capabilities, see the [TypeScript Language Guide](https://wasmcloud.com/docs/wash/developer-guide/language-support/typescript/) in the wasmCloud documentation.
8383

8484
# Issues / FAQ
8585

examples/components/http-streaming/README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Typescript HTTP Streaming
22

3-
This repository contains an HTTP component that performs a streaming response using WASI I/O and HTTP primitives, written in [Typescript][ts].
3+
This repository contains an HTTP component that performs a streaming response using WASI I/O and HTTP primitives, written in [TypeScript][ts].
44

55
This component:
66

@@ -25,11 +25,11 @@ Building this project relies on the following software:
2525

2626
| Name | Description |
2727
| ------ | ---------------------------------------------------------------------------------------------------------------------------------- |
28-
| `wash` | [Wasmcloud Shell][wash] controls your [wasmcloud][wasmcloud] host instances and enables building components (version >= 2.0) |
28+
| `wash` | [Wasm Shell][wash] controls your [wasmCloud][wasmcloud] host instances and enables building components (version >= 2.0) |
2929
| `npm` | [Node Package Manager (NPM)][npm] which manages packages for the NodeJS ecosystem |
3030
| `node` | [NodeJS runtime][nodejs] (see `.nvmrc` for version) |
3131

32-
[wash]: https://github.com/wasmCloud/wasmCloud/tree/main/crates/wash-cli
32+
[wash]: https://wasmcloud.com/docs/installation/#install-wash
3333
[node]: https://nodejs.org
3434
[npm]: https://github.com/npm/cli
3535

@@ -48,7 +48,7 @@ wash dev
4848
- Deploys an HTTP server on port 8000 and links it to your component
4949
- Watches your code for changes and re-deploys when necessary
5050

51-
[wasmcloud-host]: https://wasmcloud.com/docs/concepts/hosts
51+
[wasmcloud-host]: https://wasmcloud.com/docs/overview/hosts
5252

5353
## Send a request to the running component
5454

@@ -60,4 +60,4 @@ curl localhost:8000
6060

6161
## Adding Capabilities
6262

63-
To learn how to extend this example with additional capabilities, see the [Adding Capabilities](https://wasmcloud.com/docs/tour/adding-capabilities?lang=typescript) section of the wasmCloud documentation.
63+
To learn how to extend this example with additional capabilities, see the [TypeScript Language Guide](https://wasmcloud.com/docs/wash/developer-guide/language-support/typescript/) in the wasmCloud documentation.

0 commit comments

Comments
 (0)