docs: add Homebrew install instructions and improve examples (#251)

Signed-off-by: Ignasi Barrera <ignasi@tetrate.io>

Author: nacx

cli/cmd/genconfig_help.md

@@ -15,7 +15,7 @@ Local extensions use `file://` URLs pointing to the locally cached binaries.
 
 ## Examples
 
-Generate a complete Envoy configuration with the `example-lua` extension:
+Generate a complete Envoy configuration for the desired extensions:
 
     ```shell
     boe gen-config --extension ip-restriction
@@ -56,5 +56,5 @@ Generate configuration from a specific version hosted in a custom OCI registry:
     export BOE_REGISTRY_USERNAME=username
     export BOE_REGISTRY_PASSWORD=password
 
-    boe gen-config --extension example-lua:1.0.0
+    boe gen-config --extension example-go:0.3.0
     ```

cli/cmd/list_help.md

@@ -17,6 +17,7 @@ The output shows a table with the extension name, version, type, and a brief des
 
     ```
     NAME          VERSION  TYPE  DESCRIPTION
-    example-lua   1.0.0    lua   A simple Lua extension that adds a custom header
-    cors          1.0.0    lua   Cross-Origin Resource Sharing (CORS) support
+    chat-completions-decoder  0.3.0    go    Decodes OpenAI Chat Completion requests and responses and...
+    example-lua               1.0.0    lua   Comprehensive example demonstrating Envoy Lua HTTP filter...
+    ip-restriction            0.1.1    rust  IP-based access control using allowlists or denylists
     ```

website/src/components/Hero.astro

@@ -8,7 +8,7 @@ const highlighter = await createHighlighter({
 });
 
 const installCmd = `curl -sL ${WEBSITE}/install.sh | sh`;
-const runCmd = `${CLI_NAME} run --extension example-go --extension example-lua`;
+const runCmd = `${CLI_NAME} run --extension example-go --local ./my-extension`;
 
 const installHtml = highlighter.codeToHtml(installCmd, { lang: 'bash', theme: 'github-dark' });
 const runHtml = highlighter.codeToHtml(runCmd, { lang: 'bash', theme: 'github-dark' });

website/src/pages/docs/cli/gen-config.mdx

@@ -23,7 +23,7 @@ Local extensions use `file://` URLs pointing to the locally cached binaries.
 
 ## Examples
 
-Generate a complete Envoy configuration with the `example-lua` extension:
+Generate a complete Envoy configuration for the desired extensions:
 
     ```shell
     boe gen-config --extension ip-restriction
@@ -64,7 +64,7 @@ Generate configuration from a specific version hosted in a custom OCI registry:
     export BOE_REGISTRY_USERNAME=username
     export BOE_REGISTRY_PASSWORD=password
 
-    boe gen-config --extension example-lua:1.0.0
+    boe gen-config --extension example-go:0.3.0
     ```
 
 

website/src/pages/docs/cli/list.mdx

@@ -25,8 +25,9 @@ The output shows a table with the extension name, version, type, and a brief des
 
     ```
     NAME          VERSION  TYPE  DESCRIPTION
-    example-lua   1.0.0    lua   A simple Lua extension that adds a custom header
-    cors          1.0.0    lua   Cross-Origin Resource Sharing (CORS) support
+    chat-completions-decoder  0.3.0    go    Decodes OpenAI Chat Completion requests and responses and...
+    example-lua               1.0.0    lua   Comprehensive example demonstrating Envoy Lua HTTP filter...
+    ip-restriction            0.1.1    rust  IP-based access control using allowlists or denylists
     ```
 
 

website/src/pages/docs/custom-registry.mdx

@@ -51,7 +51,7 @@ export BOE_REGISTRY_INSECURE=true
 Or with the `--insecure` flag:
 
 ```bash
-boe run --registry localhost:5000/extensions --insecure --extension example-lua
+boe run --registry localhost:5000/extensions --insecure --extension example-go
 ```
 
 ## Publishing extensions to a custom registry

website/src/pages/docs/getting-started.mdx

@@ -18,6 +18,13 @@ Choose your preferred installation method:
 curl -sL https://builtonenvoy.io/install.sh | sh
 ```
 
+### Homebrew
+
+```bash
+brew tap tetratelabs/boe
+brew install boe
+```
+
 ### Build from source
 
 ```bash
@@ -45,7 +52,7 @@ system and architecture, and start it preconfigured with the requested extension
 upstream:
 
 ```shell
-boe run --extension example-lua --extension cache
+boe run --extension example-go --extension chat-completions-decoder
 ```
 
 Or run extensions directly from a local directory:
@@ -59,7 +66,7 @@ boe run --local ./my-extension
 Inspect the Envoy configuration so that you can replicate it in your environment:
 
 ```shell
-boe gen-config --extension example-lua --local ./my-extension >envoy.yaml
+boe gen-config --extension example-go --local ./my-extension --output /tmp/config-export
 ```
 
 ## Next steps