diff --git a/site/config.toml b/site/config.toml index 91e93eabab..b9a620e62e 100644 --- a/site/config.toml +++ b/site/config.toml @@ -22,20 +22,10 @@ googleAnalytics = "G-LG7LD9G4ZB" name = "Examples" weight = 2 [[languages.en.menu.main]] + url = "/community/" identifier = "community" name = "Community" weight = 3 - [[languages.en.menu.main]] - parent = "community" - url = "https://github.com/tetratelabs/wazero" - name = "GitHub" - weight = 1 - [[languages.en.menu.main]] - parent = "community" - url = "/history/" - identifier = "history" - name = "History" - weight = 2 [[languages.en.menu.main]] url = "/languages/" identifier = "languages" diff --git a/site/content/community/_index.md b/site/content/community/_index.md new file mode 100644 index 0000000000..6b61c52466 --- /dev/null +++ b/site/content/community/_index.md @@ -0,0 +1,48 @@ ++++ +title = "Community" +layout = "single" ++++ + +wazero is the only zero dependency WebAssembly runtime written in Go. It is +used as a library dependency, allowing Go applications to embed or execute code +written in other languages. It is also used as a CLI, to invoke WebAssembly +binaries, a.k.a. wasm files. + +### wazero community + +[tetratelabs/wazero][1] holds the Apache licensed, open source code and tests +that ensure the project. A team of full-time staff at [Tetrate](https://tetrate.io/) +steward the wazero, and you can read [history](history) for how everything +began! + +Today, wazero is a vibrant community of dozens of community members, +leveraged by many open source projects and commercial products. Please have a +look at our [users](users) page, as you may find something you need! + +### Keeping up to date + +wazero writes detailed release notes. Click Watch, Custom then Releases on the +[tetratelabs/wazero][1] repository to automatically get notifications. You can +also watch for the tag #wazero on various social media. + +We also have a [gophers slack](https://gophers.slack.com/) `#wazero` channel +for support, updates and conversation! Note: You may need an [invite][2] to +join gophers. + +Regardless, if you like what we are doing, please [star][3] our repo as folks +appreciate it. + +### How change works in wazero + +Most wazero efforts start as localized experiments, then progressively build +traction before becoming a feature. Before you start a large effort, be it docs or +a test framework or a feature, check with one of the above channels. Someone may +already have worked on this in the past and might join your effort. Sometimes, +features are intentionally absent, usually with rationale documented in an issue. +Regardless, the best advice is to join the community before proposing change, and +read one of our [CONTRIBUTING](https://github.com/tetratelabs/wazero/blob/main/CONTRIBUTING.md) files +which explains technical aspects of change culture. + +[1]: https://github.com/tetratelabs/wazero +[2]: https://invite.slack.golangbridge.org/ +[3]: https://github.com/tetratelabs/wazero/stargazers diff --git a/site/content/history.md b/site/content/community/history.md similarity index 100% rename from site/content/history.md rename to site/content/community/history.md diff --git a/site/content/community/users.md b/site/content/community/users.md new file mode 100644 index 0000000000..f236b98466 --- /dev/null +++ b/site/content/community/users.md @@ -0,0 +1,35 @@ ++++ +title = "Who is using wazero" ++++ + +## Who is using wazero? + +Below are an incomplete list of projects that use wazero strategically as a +part of their open source or commercial work. Please support our community by +considering their efforts before starting your own! + +### General purpose plugins + +| Name | Description | +|:---------------|----------------------------------------| +| [go-plugin][2] | use gRPC to define WebAssembly plugins | + +### HTTP + +| Name | Description | +|:-----------------------|----------------------------------------------------| +| [http-wasm-host-go][3] | Serves HTTP handlers implemented in [http-wasm][4] | + +## Updating this list + +This is a community maintained list. It may have an inaccurate or outdated +entries, or missing something entirely. Changes to the [source][1] are +welcome, but please be conscious that not all projects desire to be on lists. +To ensure we promote community members, please do not add works that don't use +wazero to this list. Please keep descriptions short for a better table +experience. + +[1]: https://github.com/tetratelabs/wazero/tree/main/site/content/community/users.md +[2]: https://github.com/knqyf263/go-plugin +[3]: https://github.com/http-wasm/http-wasm-host-go +[4]: https://http-wasm.io