winglang · mergify · Jul 8, 2024 · Jul 1, 2024 · Jul 2, 2024 · Jul 2, 2024
diff --git a/api_versioned_docs/version-latest/01-api.md b/api_versioned_docs/version-latest/01-api.md
@@ -0,0 +1,20 @@
+---
+title: "API"
+id: api
+slug: /
+sidebar_label: Introduction
+description: API documentation for Wing
+keywords: [Wing language, api]
+---
+
+
+## Quick links
+
+- [CLI User Manual](/docs/api/cli)
+    - Learn and explore the Wing Cli
+- [Wing Language](/docs/api/language/variable-declaration)
+    - Dive deeper into the Wing Language, learn how to [declare variables](/docs/api/language/variable-declaration), [functions](/docs/api/language/functions-example), [structs](/docs/api/language/structs) and much more.
+- [Standard Library](/docs/api/standard-library)
+    - API references for the Wing standard library and supported modules 
+- [Language Reference](/docs/api/language-reference)
+    - The Wing programming language reference
diff --git a/...ed_docs/version-latest/06-tools/01-cli.md → ...docs/version-latest/02-cli-user-manual.md b/...ed_docs/version-latest/06-tools/01-cli.md → ...docs/version-latest/02-cli-user-manual.md
@@ -1,11 +1,14 @@
 ---
-title: "CLI User Manual: Compile, Test, and Run Wing Programs"
+title: "CLI User Manual"
 id: cli
+slug: /cli
 sidebar_label: CLI User Manual
 description: Wing CLI reference
 keywords: [Wing reference, Wing language, language, Wing language spec, Wing programming language, cli]
 ---
 
+## Compile, Test, and Run Wing Programs
+
 The Wing CLI is a command line interface for Wing. It is used to compile, test, and run Wing
 programs in your terminal, and we hope it will become your best friend.
 
@@ -75,11 +78,11 @@ is `sim`.
 
 You can use one of the built-in platform providers:
 
-* [Wing Cloud Simulator](../055-platforms/sim.md) - `sim`
-* [Terraform/AWS](../055-platforms/tf-aws.md) - `tf-aws`
-* [Terraform/Azure](../055-platforms/tf-azure.md) - `tf-azure`
-* [Terraform/GCP](../055-platforms/tf-gcp.md) - `tf-gcp`
-* [AWS CDK](../055-platforms/awscdk.md) - `@winglang/platform-awscdk`
+* [Wing Cloud Simulator](/docs/platforms/sim) - `sim`
+* [Terraform/AWS](/docs/platforms/AWS/tf-aws) - `tf-aws`
+* [Terraform/Azure](/docs/platforms/microsoft-azure/tf-azure) - `tf-azure`
+* [Terraform/GCP](/docs/platforms/google-cloud/tf-gcp) - `tf-gcp`
+* [AWS CDK](/docs/platforms/AWS/awscdk) - `@winglang/platform-awscdk`
 
 ## Test: `wing test`
 
@@ -237,7 +240,7 @@ $ wing pack
 
 This will compile your current Wing directory, and bundle it as a tarball that can be published to [GitHub packages](https://github.com/features/packages) or [npm](https://www.npmjs.com/).
 
-See [Libraries](../05-libraries.md) for more details on packaging and consuming Wing libraries.
+See [Libraries](/docs/category/wing-libraries-winglibs) for more details on packaging and consuming Wing libraries.
 
 :::
 

diff --git a/...st/07-examples/01-variable-declaration.md → ...st/03-language/01-variable-declaration.md b/...st/07-examples/01-variable-declaration.md → ...st/03-language/01-variable-declaration.md
diff --git a/...rsion-latest/07-examples/02-primitives.md → ...rsion-latest/03-language/02-primitives.md b/...rsion-latest/07-examples/02-primitives.md → ...rsion-latest/03-language/02-primitives.md
diff --git a/...ersion-latest/07-examples/03-functions.md → ...ersion-latest/03-language/03-functions.md b/...ersion-latest/07-examples/03-functions.md → ...ersion-latest/03-language/03-functions.md
diff --git a/...on-latest/07-examples/04-flow-controls.md → ...on-latest/03-language/04-flow-controls.md b/...on-latest/07-examples/04-flow-controls.md → ...on-latest/03-language/04-flow-controls.md
diff --git a/...sion-latest/07-examples/05-optionality.md → ...sion-latest/03-language/05-optionality.md b/...sion-latest/07-examples/05-optionality.md → ...sion-latest/03-language/05-optionality.md
diff --git a/...ocs/version-latest/07-examples/06-json.md → ...ocs/version-latest/03-language/06-json.md b/...ocs/version-latest/07-examples/06-json.md → ...ocs/version-latest/03-language/06-json.md
diff --git a/.../version-latest/07-examples/07-structs.md → .../version-latest/03-language/07-structs.md b/.../version-latest/07-examples/07-structs.md → .../version-latest/03-language/07-structs.md
diff --git a/.../version-latest/07-examples/08-classes.md → .../version-latest/03-language/08-classes.md b/.../version-latest/07-examples/08-classes.md → .../version-latest/03-language/08-classes.md
diff --git a/...latest/07-examples/10-using-javascript.md → ...latest/03-language/10-using-javascript.md b/...latest/07-examples/10-using-javascript.md → ...latest/03-language/10-using-javascript.md
diff --git a/...sion-latest/07-examples/13-api-gateway.md → ...sion-latest/03-language/13-api-gateway.md b/...sion-latest/07-examples/13-api-gateway.md → ...sion-latest/03-language/13-api-gateway.md
diff --git a/...rsion-latest/07-examples/80-singletons.md → ...rsion-latest/03-language/14-singletons.md b/...rsion-latest/07-examples/80-singletons.md → ...rsion-latest/03-language/14-singletons.md
diff --git a/api_versioned_docs/version-latest/03-language/_category_.yml b/api_versioned_docs/version-latest/03-language/_category_.yml
@@ -0,0 +1,7 @@
+label: Wing Language
+collapsible: true
+collapsed: false
+link:
+  type: generated-index
+  slug: language
+  title: Wing Language
diff --git a/...latest/04-standard-library/_category_.yml → ...latest/04-standard-library/_category_.yml b/...latest/04-standard-library/_category_.yml → ...latest/04-standard-library/_category_.yml
@@ -4,3 +4,4 @@ collapsed: true
 link:
   type: generated-index
   title: Wing Standard Library
+  slug: standard-library
diff --git a/...st/04-standard-library/aws/_category_.yml → ...st/04-standard-library/aws/_category_.yml b/...st/04-standard-library/aws/_category_.yml → ...st/04-standard-library/aws/_category_.yml
diff --git a/.../04-standard-library/aws/api-reference.md → .../04-standard-library/aws/api-reference.md b/.../04-standard-library/aws/api-reference.md → .../04-standard-library/aws/api-reference.md
diff --git a/.../04-standard-library/cloud/_category_.yml → .../04-standard-library/cloud/_category_.yml b/.../04-standard-library/cloud/_category_.yml → .../04-standard-library/cloud/_category_.yml
diff --git a/...n-latest/04-standard-library/cloud/api.md → ...n-latest/04-standard-library/cloud/api.md b/...n-latest/04-standard-library/cloud/api.md → ...n-latest/04-standard-library/cloud/api.md
diff --git a/...atest/04-standard-library/cloud/bucket.md → ...atest/04-standard-library/cloud/bucket.md b/...atest/04-standard-library/cloud/bucket.md → ...atest/04-standard-library/cloud/bucket.md
diff --git a/...test/04-standard-library/cloud/counter.md → ...test/04-standard-library/cloud/counter.md b/...test/04-standard-library/cloud/counter.md → ...test/04-standard-library/cloud/counter.md
diff --git a/...atest/04-standard-library/cloud/domain.md → ...atest/04-standard-library/cloud/domain.md b/...atest/04-standard-library/cloud/domain.md → ...atest/04-standard-library/cloud/domain.md
diff --git a/...est/04-standard-library/cloud/endpoint.md → ...est/04-standard-library/cloud/endpoint.md b/...est/04-standard-library/cloud/endpoint.md → ...est/04-standard-library/cloud/endpoint.md
diff --git a/...est/04-standard-library/cloud/function.md → ...est/04-standard-library/cloud/function.md b/...est/04-standard-library/cloud/function.md → ...est/04-standard-library/cloud/function.md
diff --git a/...st/04-standard-library/cloud/on-deploy.md → ...st/04-standard-library/cloud/on-deploy.md b/...st/04-standard-library/cloud/on-deploy.md → ...st/04-standard-library/cloud/on-deploy.md
diff --git a/...latest/04-standard-library/cloud/queue.md → ...latest/04-standard-library/cloud/queue.md b/...latest/04-standard-library/cloud/queue.md → ...latest/04-standard-library/cloud/queue.md
diff --git a/...est/04-standard-library/cloud/schedule.md → ...est/04-standard-library/cloud/schedule.md b/...est/04-standard-library/cloud/schedule.md → ...est/04-standard-library/cloud/schedule.md
diff --git a/...atest/04-standard-library/cloud/secret.md → ...atest/04-standard-library/cloud/secret.md b/...atest/04-standard-library/cloud/secret.md → ...atest/04-standard-library/cloud/secret.md
diff --git a/...test/04-standard-library/cloud/service.md → ...test/04-standard-library/cloud/service.md b/...test/04-standard-library/cloud/service.md → ...test/04-standard-library/cloud/service.md
diff --git a/...latest/04-standard-library/cloud/topic.md → ...latest/04-standard-library/cloud/topic.md b/...latest/04-standard-library/cloud/topic.md → ...latest/04-standard-library/cloud/topic.md
diff --git a/...test/04-standard-library/cloud/website.md → ...test/04-standard-library/cloud/website.md b/...test/04-standard-library/cloud/website.md → ...test/04-standard-library/cloud/website.md
@@ -45,6 +45,40 @@ An extended Web App example including static Website, API Gateway and a Redis da
 
 Review the [Website RFC](https://www.winglang.io/contributing/rfcs/2023-04-16-website-resource) for detailed information.
 
+### Pass variables to the website
+You can pass dynamic variables from the main.w file to the website, and recuperate them by fetching the config.js file.
+// inside main.w
+
+```ts
+bring cloud;
+
+let website = new cloud.Website(path: "./static");
+let api = new cloud.Api();
+
+website.addJson("config.json", { api: api.url });
+```
+
+inside ./static/index.html
+
+```html
+<html lang="en">
+<html>
+<body>
+...
+    <script>
+        // Fetch the config file and get the API URL
+        let ApiUrl;
+        fetch('/config.json')
+            .then(response => response.json())
+            .then(data => {
+                ApiUrl = data.api;
+            });
+    </script>
+</body>
+</html>
+```
+
+
 ### Simulator (`sim`)
 
 sim implementations of `cloud.Website` is using [nodejs express](https://expressjs.com/).

diff --git a/...est/04-standard-library/cloud/workload.md → ...est/04-standard-library/cloud/workload.md b/...est/04-standard-library/cloud/workload.md → ...est/04-standard-library/cloud/workload.md
diff --git a/...dard-library/compatibility/_category_.yml → ...dard-library/compatibility/_category_.yml b/...dard-library/compatibility/_category_.yml → ...dard-library/compatibility/_category_.yml
diff --git a/...ary/compatibility/compatibility-table.jsx → ...ary/compatibility/compatibility-table.jsx b/...ary/compatibility/compatibility-table.jsx → ...ary/compatibility/compatibility-table.jsx
diff --git a/...-library/compatibility/compatibility.json → ...-library/compatibility/compatibility.json b/...-library/compatibility/compatibility.json → ...-library/compatibility/compatibility.json
diff --git a/...-standard-library/compatibility/style.css → ...-standard-library/compatibility/style.css b/...-standard-library/compatibility/style.css → ...-standard-library/compatibility/style.css
diff --git a/...est/04-standard-library/ex/_category_.yml → ...est/04-standard-library/ex/_category_.yml b/...est/04-standard-library/ex/_category_.yml → ...est/04-standard-library/ex/_category_.yml
diff --git a/...atest/04-standard-library/ex/react-app.md → ...atest/04-standard-library/ex/react-app.md b/...atest/04-standard-library/ex/react-app.md → ...atest/04-standard-library/ex/react-app.md
diff --git a/...on-latest/04-standard-library/ex/redis.md → ...on-latest/04-standard-library/ex/redis.md b/...on-latest/04-standard-library/ex/redis.md → ...on-latest/04-standard-library/ex/redis.md
diff --git a/...on-latest/04-standard-library/ex/table.md → ...on-latest/04-standard-library/ex/table.md b/...on-latest/04-standard-library/ex/table.md → ...on-latest/04-standard-library/ex/table.md
diff --git a/...04-standard-library/expect/_category_.yml → ...04-standard-library/expect/_category_.yml b/...04-standard-library/expect/_category_.yml → ...04-standard-library/expect/_category_.yml
diff --git a/...-standard-library/expect/api-reference.md → ...-standard-library/expect/api-reference.md b/...-standard-library/expect/api-reference.md → ...-standard-library/expect/api-reference.md
diff --git a/...est/04-standard-library/fs/_category_.yml → ...est/04-standard-library/fs/_category_.yml b/...est/04-standard-library/fs/_category_.yml → ...est/04-standard-library/fs/_category_.yml
diff --git a/...t/04-standard-library/fs/api-reference.md → ...t/04-standard-library/fs/api-reference.md b/...t/04-standard-library/fs/api-reference.md → ...t/04-standard-library/fs/api-reference.md
diff --git a/...t/04-standard-library/http/_category_.yml → ...t/04-standard-library/http/_category_.yml b/...t/04-standard-library/http/_category_.yml → ...t/04-standard-library/http/_category_.yml
diff --git a/...04-standard-library/http/api-reference.md → ...04-standard-library/http/api-reference.md b/...04-standard-library/http/api-reference.md → ...04-standard-library/http/api-reference.md
diff --git a/...t/04-standard-library/math/_category_.yml → ...t/04-standard-library/math/_category_.yml b/...t/04-standard-library/math/_category_.yml → ...t/04-standard-library/math/_category_.yml
diff --git a/...04-standard-library/math/api-reference.md → ...04-standard-library/math/api-reference.md b/...04-standard-library/math/api-reference.md → ...04-standard-library/math/api-reference.md
diff --git a/...st/04-standard-library/sim/_category_.yml → ...st/04-standard-library/sim/_category_.yml b/...st/04-standard-library/sim/_category_.yml → ...st/04-standard-library/sim/_category_.yml
diff --git a/.../04-standard-library/sim/api-reference.md → .../04-standard-library/sim/api-reference.md b/.../04-standard-library/sim/api-reference.md → .../04-standard-library/sim/api-reference.md
diff --git a/...test/04-standard-library/sim/container.md → ...test/04-standard-library/sim/container.md b/...test/04-standard-library/sim/container.md → ...test/04-standard-library/sim/container.md
diff --git a/...atest/04-standard-library/sim/resource.md → ...atest/04-standard-library/sim/resource.md b/...atest/04-standard-library/sim/resource.md → ...atest/04-standard-library/sim/resource.md
diff --git a/...n-latest/04-standard-library/sim/state.md → ...n-latest/04-standard-library/sim/state.md b/...n-latest/04-standard-library/sim/state.md → ...n-latest/04-standard-library/sim/state.md
diff --git a/...-latest/04-standard-library/std/README.md → ...-latest/04-standard-library/std/README.md b/...-latest/04-standard-library/std/README.md → ...-latest/04-standard-library/std/README.md
diff --git a/...st/04-standard-library/std/_category_.yml → ...st/04-standard-library/std/_category_.yml b/...st/04-standard-library/std/_category_.yml → ...st/04-standard-library/std/_category_.yml
diff --git a/...n-latest/04-standard-library/std/array.md → ...n-latest/04-standard-library/std/array.md b/...n-latest/04-standard-library/std/array.md → ...n-latest/04-standard-library/std/array.md
diff --git a/...on-latest/04-standard-library/std/bool.md → ...on-latest/04-standard-library/std/bool.md b/...on-latest/04-standard-library/std/bool.md → ...on-latest/04-standard-library/std/bool.md
diff --git a/...atest/04-standard-library/std/datetime.md → ...atest/04-standard-library/std/datetime.md b/...atest/04-standard-library/std/datetime.md → ...atest/04-standard-library/std/datetime.md
diff --git a/...atest/04-standard-library/std/duration.md → ...atest/04-standard-library/std/duration.md b/...atest/04-standard-library/std/duration.md → ...atest/04-standard-library/std/duration.md
diff --git a/...on-latest/04-standard-library/std/json.md → ...on-latest/04-standard-library/std/json.md b/...on-latest/04-standard-library/std/json.md → ...on-latest/04-standard-library/std/json.md
diff --git a/...st/04-standard-library/std/json_schema.md → ...st/04-standard-library/std/json_schema.md b/...st/04-standard-library/std/json_schema.md → ...st/04-standard-library/std/json_schema.md
diff --git a/...ion-latest/04-standard-library/std/map.md → ...ion-latest/04-standard-library/std/map.md b/...ion-latest/04-standard-library/std/map.md → ...ion-latest/04-standard-library/std/map.md
diff --git a/...on-latest/04-standard-library/std/node.md → ...on-latest/04-standard-library/std/node.md b/...on-latest/04-standard-library/std/node.md → ...on-latest/04-standard-library/std/node.md
diff --git a/...-latest/04-standard-library/std/number.md → ...-latest/04-standard-library/std/number.md b/...-latest/04-standard-library/std/number.md → ...-latest/04-standard-library/std/number.md
diff --git a/...n-latest/04-standard-library/std/regex.md → ...n-latest/04-standard-library/std/regex.md b/...n-latest/04-standard-library/std/regex.md → ...n-latest/04-standard-library/std/regex.md
diff --git a/...ion-latest/04-standard-library/std/set.md → ...ion-latest/04-standard-library/std/set.md b/...ion-latest/04-standard-library/std/set.md → ...ion-latest/04-standard-library/std/set.md
diff --git a/...-latest/04-standard-library/std/string.md → ...-latest/04-standard-library/std/string.md b/...-latest/04-standard-library/std/string.md → ...-latest/04-standard-library/std/string.md
diff --git a/...-latest/04-standard-library/std/struct.md → ...-latest/04-standard-library/std/struct.md b/...-latest/04-standard-library/std/struct.md → ...-latest/04-standard-library/std/struct.md
diff --git a/...est/04-standard-library/ui/_category_.yml → ...est/04-standard-library/ui/_category_.yml b/...est/04-standard-library/ui/_category_.yml → ...est/04-standard-library/ui/_category_.yml
diff --git a/...t/04-standard-library/ui/api-reference.md → ...t/04-standard-library/ui/api-reference.md b/...t/04-standard-library/ui/api-reference.md → ...t/04-standard-library/ui/api-reference.md
diff --git a/...t/04-standard-library/util/_category_.yml → ...t/04-standard-library/util/_category_.yml b/...t/04-standard-library/util/_category_.yml → ...t/04-standard-library/util/_category_.yml
diff --git a/...04-standard-library/util/api-reference.md → ...04-standard-library/util/api-reference.md b/...04-standard-library/util/api-reference.md → ...04-standard-library/util/api-reference.md
diff --git a/...ard-library/µ-winglang_support_metrix.mdx → ...ard-library/µ-winglang_support_metrix.mdx b/...ard-library/µ-winglang_support_metrix.mdx → ...ard-library/µ-winglang_support_metrix.mdx
diff --git a/...s/version-latest/03-language-reference.md → ...s/version-latest/05-language-reference.md b/...s/version-latest/03-language-reference.md → ...s/version-latest/05-language-reference.md
@@ -593,8 +593,8 @@ the following properties (given an example intrinsic `@x`):
 | `@assert()`     | checks a condition and _throws_ if evaluated to false                                                                     |
 | `@dirname`      | current source directory                                                                                                  |
 | `@unsafeCast()` | cast a value into a different type                                                                                        |
-| `@nodeof()`     | obtain the [tree node](./02-concepts/02-application-tree.md) of a preflight object                                        |
-| `@lift()`       | explicitly qualify a [lift](./02-concepts/01-preflight-and-inflight.md#explicit-lift-qualification) of a preflight object |
+| `@nodeof()`     | obtain the [tree node](/docs/concepts/application-tree) of a preflight object                                        |
+| `@lift()`       | explicitly qualify a [lift](/docs/concepts/inflights) of a preflight object |
 
 > ```TS
 > @log("Hello {name}");

diff --git a/...ioned_docs/version-latest/09-analytics.md → ...ioned_docs/version-latest/06-analytics.md b/...ioned_docs/version-latest/09-analytics.md → ...ioned_docs/version-latest/06-analytics.md
diff --git a/api_versioned_sidebars/version-latest-sidebars.json b/api_versioned_sidebars/version-latest-sidebars.json
@@ -0,0 +1,8 @@
+{
+  "defaultSidebar": [
+    {
+      "type": "autogenerated",
+      "dirName": "."
+    }
+  ]
+}
diff --git a/api_versions.json b/api_versions.json
@@ -0,0 +1,3 @@
+[
+  "latest"
+]
diff --git a/blog/2023-07-18-wing-cloud-launch.md b/blog/2023-07-18-wing-cloud-launch.md
@@ -163,7 +163,7 @@ backends for existing resources based on the needs of their environment.
 
 The WCL is a major project and in its early days. You can see the coverage of resources and targets
 through this [compatibility
-matrix](https://www.winglang.io/docs/standard-library/compatibility-matrix) and make sure to "+1"
+matrix](https://www.winglang.io/docs/api/standard-library/compatibility-matrix) and make sure to "+1"
 the relevant GitHub issue if coverage is missing.
 
 <br/>

diff --git a/blog/2023-12-12-magazine-007.md b/blog/2023-12-12-magazine-007.md
@@ -22,7 +22,7 @@ Winglang combines infrastructure and runtime into a single programming model, ma
 developer to build serverless applications without having to become a DevOps expert.
 
 Winglang compiles to Terraform + JavaScript and can be deployed on AWS, GCP and Azure (see [support
-matrix](https://www.winglang.io/docs/standard-library/compatibility-matrix)).
+matrix](https://www.winglang.io/docs/api/standard-library/compatibility-matrix)).
 
 Winglang is designed to be a familiar and friendly language to learn for developers who come from modern object-oriented background, so it will take you [5 minutes](https://github.com/winglang/workshop-react/blob/main/cheatsheet.md) to learn.
 
@@ -215,7 +215,7 @@ here](https://youtube.com/playlist?list=PL-P8v-FRassZBWsNoSafL_ReO0JO0xJVm&si=tr
 Here are a few segments from the previous shows we thought might be interesting to check out:
 
 - [Containers are finally taking flight](https://youtu.be/3kFcyzKt3MU): In this video from our Wingly Update, Elad and Eyal are playing around with containers in Wing. They show how local simulation works with Docker and how apps can be seamlessly deployed to Kubernetes through Helm. Exciting times!
-- [Creating a FIFO Queue](TBD): [Eyal](https://github.com/ekeren) and [Elad](https://github.com/eladcohen) are walking us through on how to create a *FIfo* Queue!
+- [Creating a FIFO Queue](https://www.youtube.com/watch?v=7jbm0LXulCA): [Eyal](https://github.com/ekeren) and [Elad](https://github.com/eladcohen) are walking us through on how to create a *FIfo* Queue!
 - [Winglang - How to Build Resources](https://youtu.be/wJVT1DaH8lA): In this clip from The Wingly Update #21, Elad walks us through building resources in Winglang. Listen in to get some details on more advanced topics such as sim.State and tokens. 
 
 ### Winglang Workshops

diff --git a/blog/2023-12-21-magazine-006.md b/blog/2023-12-21-magazine-006.md
@@ -20,7 +20,7 @@ We are back with another issue of the **Wing Inflight Magazine** and excited to
 Winglang is an open-source programming language for the cloud. It combines infrastructure and runtime into a single programming model, making it easy for any developer
 to build serverless cloud-native applications without having to become a DevOps expert. 
 
-Winglang code compiles to Terraform + JavaScript and can be deployed on AWS, GCP and Azure (see [support matrix](https://www.winglang.io/docs/standard-library/compatibility-matrix)).
+Winglang code compiles to Terraform + JavaScript and can be deployed on AWS, GCP and Azure (see [support matrix](https://www.winglang.io/docs/api/standard-library/compatibility-matrix)).
 
 Winglang is designed to be a familiar and friendly language to learn for developers who come from modern object-oriented background, so it will take you [5 minutes](https://github.com/winglang/workshop-react/blob/main/cheatsheet.md) to learn.
 

diff --git a/blog/2024-03-13-magazine-008.md b/blog/2024-03-13-magazine-008.md
@@ -26,7 +26,7 @@ We are back with another issue of the **Wing Inflight Magazine** and excited to
 
 Wing is shipped with a **powerful cloud simulator** which allows developers to write and test complete cloud application without having to deploy anything to the cloud.
 
-The language combines cloud infrastructure ***and*** runtime into a single programming model and **compiles to Terraform/CloudFormation and JavaScript** that are ready to deploy to AWS, GCP and Azure (see [support matrix](https://www.winglang.io/docs/standard-library/compatibility-matrix)).
+The language combines cloud infrastructure ***and*** runtime into a single programming model and **compiles to Terraform/CloudFormation and JavaScript** that are ready to deploy to AWS, GCP and Azure (see [support matrix](https://www.winglang.io/docs/api/standard-library/compatibility-matrix)).
 
 We are designing Wing to be **familiar and friendly** for developers who come from modern object-oriented background, so it will take you [5 minutes](https://github.com/winglang/workshop-react/blob/main/cheatsheet.md) to learn.
 

diff --git a/blog/2024-04-19-magazine-009.md b/blog/2024-04-19-magazine-009.md
@@ -46,7 +46,7 @@ about [Cloudflare](https://github.com/winglang/wing/issues/4298),
 [Pulumi](https://github.com/winglang/wing/issues/6272),
 [OpenShift](https://github.com/winglang/wing/issues/6273), [Azure
 Bicep](https://github.com/winglang/wing/issues/6271). Check out the [compatibility
-matrix](https://www.winglang.io/docs/standard-library/compatibility-matrix), add your 👍 to the
+matrix](https://www.winglang.io/docs/api/standard-library/compatibility-matrix), add your 👍 to the
 relevant issue, and share your use case to help us prioritize!
 
 Platform teams can also create their own custom platforms using CDK constructs. This offers central

diff --git a/blog/2024-05-07-in-search-for-winglang-middleware-part-two.md b/blog/2024-05-07-in-search-for-winglang-middleware-part-two.md
@@ -189,7 +189,7 @@ This example is quite detailed, so we will break it down section by section to f
 
 This module, by convention named `middleware.w`, features a [Winglang preflight](https://www.winglang.io/docs/concepts/inflights#preflight-code) class called `ServiceFactory`. This class encapsulates the following public resources and methods, which are crucial for the middleware's operation:
 
-- `api: [cloud.Api](https://www.winglang.io/docs/standard-library/cloud/api)`: resource from the [Winglang Standard Library](https://www.winglang.io/docs/category/cloud)
+- `api: [cloud.Api](https://www.winglang.io/docs/standard-library/cloud/api)`: resource from the [Winglang Standard Library](https://www.winglang.io/docs/api/category/cloud)
 - `logger: logging.Logger`: resource, extending the [Winglang libraries](https://www.winglang.io/docs/libraries), which was discussed previously in terms of its utility and possible implementation implementation [here](https://medium.com/itnext/implementing-production-grade-crud-rest-api-in-winglang-7b8f6917efc2)
 - `makeRequestHandler()`: [Factory Method](https://en.wikipedia.org/wiki/Factory_method_pattern) that applies the [Template Method Design Pattern](https://en.wikipedia.org/wiki/Template_method_pattern) tailored to each request handler
 - `getApiBuilder()`: another [Factory Method](https://en.wikipedia.org/wiki/Factory_method_pattern) this time applying the [Builder Design Pattern](https://en.wikipedia.org/wiki/Builder_pattern) to configure specific resource API calls

diff --git a/contributing_versioned_docs/version-latest/998-archived/01-compile-targets.md b/contributing_versioned_docs/version-latest/998-archived/01-compile-targets.md
@@ -33,7 +33,7 @@ These targets contain a combination of provisioning engine and cloud environment
 
 ## Portability
 
-The [Wing Cloud Library](/docs/category/cloud) has several classes representing abstracted cloud resources, whose APIs are not specific to a single cloud provider.
+The [Wing Cloud Library](/docs/api/category/cloud) has several classes representing abstracted cloud resources, whose APIs are not specific to a single cloud provider.
 This allows you to write code that can be deployed to any supported cloud environment or provisioning engine.
 
 Here's an example of a portable code snippet:
@@ -45,7 +45,7 @@ let bucket = new cloud.Bucket();
 ```
 
 Each resource needs a dedicated implementation to work on a given compiler target.
-A catalog of which resources are supported on each cloud can be found [here](/docs/standard-library/compatibility-matrix).
+A catalog of which resources are supported on each cloud can be found [here](/docs/api/standard-library/compatibility-matrix).
 
 ### Provisioning engines
 

diff --git a/docusaurus.config.js b/docusaurus.config.js
@@ -7,6 +7,9 @@ const NodePolyfillPlugin = require("node-polyfill-webpack-plugin");
 const discordUrl = "https://t.winglang.io/discord";
 
 const winglangOrgUrl = "https://github.com/winglang";
+const redirects = require('./redirects');
+
+// const { crete} = require('@docusaurus/plugin-client-redirects')
 
 const keywords = [
   "Wing language",
@@ -78,12 +81,14 @@ const config = {
     [
       "@docusaurus/plugin-client-redirects",
       {
-        redirects: [
-          {
-            to: "/docs/",
-            from: ["/docs/start-here/installation"],
-          },
-        ],
+        redirects,
+        createRedirects(existingPath) {
+
+          if (existingPath.includes('/docs/api/standard-library')) {
+            return [existingPath.replace('/docs/api/standard-library', '/docs/standard-library')];
+          }
+          return undefined; // Return a falsy value: no redirect created
+        },
       },
     ],
     [
@@ -98,7 +103,21 @@ const config = {
         includeCurrentVersion: false,
         // sidebarPath: require.resolve('./sidebarsCommunity.js'),
         // ... other options
-      },
+      }
+    ],
+    [
+      "@docusaurus/plugin-content-docs",
+      {
+        id: "api",
+        path: "api",
+        routeBasePath: "docs/api",
+        editUrl: (params) =>
+          `${winglangOrgUrl}/wing/tree/main/docs/api/${params.docPath}`,
+        breadcrumbs: true,
+        includeCurrentVersion: false,
+        // sidebarPath: require.resolve('./sidebarsCommunity.js'),
+        // ... other options
+      }
     ],
   ],
   presets: [
@@ -217,16 +236,30 @@ const config = {
             target: "_self",
           },
           {
-            href: "https://www.winglang.io/play/",
+            to: "docs/why-wing",
             position: "left",
-            label: "Playground",
+            label: "Learn",
             className: "header-text-link",
             target: "_self",
           },
           {
-            to: "docs",
+            to: "docs/api",
+            position: "left",
+            label: "API",
+            className: "header-text-link",
+            target: "_self",
+          },
+          {
+            href: "https://github.com/winglang/examples",
             position: "left",
-            label: "Docs",
+            label: "Examples",
+            className: "header-text-link",
+            target: "_blank",
+          },
+          {
+            href: "https://www.winglang.io/play/",
+            position: "left",
+            label: "Playground",
             className: "header-text-link",
             target: "_self",
           },
@@ -303,11 +336,11 @@ const config = {
             items: [
               {
                 label: "Language Specification",
-                to: "/docs/language-reference",
+                to: "/docs/api/language-reference",
               },
               {
                 label: "API Reference",
-                to: "/docs/category/standard-library",
+                to: "/docs/api/standard-library",
               },
             ],
           },