From e1f56b06d59da4bcc33225384c2b7217bdbcaeda Mon Sep 17 00:00:00 2001
From: monabot <monabot@monada.co>
Date: Mon, 3 Jul 2023 19:46:15 +0000
Subject: [PATCH] feat(docs): update docs

Updates the Wing docs. See details in [workflow run].

[Workflow Run]: https://github.com/winglang/docsite/actions/runs/5448037751

------

*Automatically created via the "update-docs" workflow*

Signed-off-by: monabot <monabot@monada.co>
---
 .../02-maintainers/050-operations.md          |  4 +-
 .../version-latest/03-stories/story-04.md     |  6 +-
 .../version-latest/03-stories/story-06.md     |  2 +-
 .../999-rfcs/2022-05-28-winglang-reqs.md      |  2 +-
 .../999-rfcs/2023-04-16-website-resource.md   |  2 +-
 .../999-rfcs/2023-06-12-language-spec.md      |  4 +-
 .../version-latest/999-rfcs/overview.md       |  2 +-
 .../01-start-here/01-getting-started.md       |  2 +-
 .../01-start-here/06-learn-more.md            |  2 +-
 .../03-language-guide/90-reference.md         |  4 +-
 .../04-standard-library/01-cloud/api.md       | 92 ++++++++++++++++++-
 .../04-standard-library/01-cloud/function.md  | 36 +++++++-
 .../04-standard-library/01-cloud/queue.md     | 57 +++++++++++-
 .../03-http/api-reference.md                  | 16 ++++
 .../999-faq/005-why-a-language.md             |  2 +-
 .../version-latest/999-faq/010-good-fit.md    | 20 ++--
 .../999-faq/012-can-we-abstract-the-cloud.md  |  2 +-
 .../021-supported-clouds.md                   |  6 +-
 .../022-supported-services.md                 |  4 +-
 .../023-supported-provisioning-engines.md     |  4 +-
 .../025-kubernetes-support.md                 |  2 +-
 .../040-alternatives/041-terraform-vs-wing.md |  4 +-
 .../040-alternatives/042-pulumi-vs-wing.md    |  4 +-
 .../040-alternatives/043-awscdk-vs-wing.md    |  4 +-
 .../040-alternatives/044-cdktf-vs-wing.md     |  2 +-
 .../version-latest/999-faq/093-secrets.md     |  2 +-
 26 files changed, 236 insertions(+), 51 deletions(-)

diff --git a/contributing_versioned_docs/version-latest/02-maintainers/050-operations.md b/contributing_versioned_docs/version-latest/02-maintainers/050-operations.md
index 4893c0e27..1796e8533 100644
--- a/contributing_versioned_docs/version-latest/02-maintainers/050-operations.md
+++ b/contributing_versioned_docs/version-latest/02-maintainers/050-operations.md
@@ -12,13 +12,13 @@ Both are important to the health of Wing however users should be prioritized ove
 User-facing projects and their supporting contributor pieces:
 
 - [Homepage](https://winglang.io)
-- [Documentation](https://docs.winglang.io)
+- [Documentation](https://www.winglang.io/docs/)
   - https://github.com/winglang/docsite
   - https://github.com/winglang/wing/tree/main/docs
 - Wing CLI
   - https://github.com/winglang/wing
 - Wing Console
-  - https://docs.winglang.io/core-concepts/simulator
+  - https://www.winglang.io/docs/concepts/simulator
 - [Playground](https://play.winglang.io)
 - [NPM Packages](https://www.npmjs.com/~monabot) (https://www.npmjs.com/package/winglang and https://www.npmjs.com/package/@winglang/sdk)
 - [VSCode Extension](https://marketplace.visualstudio.com/items?itemName=Monada.vscode-wing)
diff --git a/contributing_versioned_docs/version-latest/03-stories/story-04.md b/contributing_versioned_docs/version-latest/03-stories/story-04.md
index 3e67ee57b..225931044 100644
--- a/contributing_versioned_docs/version-latest/03-stories/story-04.md
+++ b/contributing_versioned_docs/version-latest/03-stories/story-04.md
@@ -177,8 +177,8 @@ the log message `Hello, cloud!`.
 Now that you've written your first Wing program, what's next? Here are some
 resources to help you get started:
 
-- [Wing Language Specification](https://docs.winglang.io/contributing/rfcs/language-spec)
-- [Wing SDK Reference](https://docs.winglang.io/contributing/rfcs/2023-01-20-wingsdk-spec)
+- [Wing Language Specification](https://www.winglang.io/contributing/rfcs/language-spec)
+- [Wing SDK Reference](https://www.winglang.io/contributing/rfcs/2023-01-20-wingsdk-spec)
 
 ## Staying up to date
 
@@ -222,7 +222,7 @@ As such, our focus for this sprint is:
 - Consolidate everything related to Wing into the [monadahq/winglang](https://github.com/monadahq/winglang/) GitHub repo. This includes:
   - The [Wing SDK](https://github.com/monadahq/wingsdk)
   - The [language spec](https://github.com/monadahq/winglang-spec) - should go under `docs/winglang-spec.md`
-  - The [language requirements RFC](https://docs.winglang.io/contributing/rfcs/2022-05-28-winglang-reqs) - 
+  - The [language requirements RFC](https://www.winglang.io/contributing/rfcs/2022-05-28-winglang-reqs) - 
     should go under `rfcs/winglang-reqs.md`
   - All issues should also be transfered into this repository.
 - Updating the main README file to match this RFC as close as possible.
diff --git a/contributing_versioned_docs/version-latest/03-stories/story-06.md b/contributing_versioned_docs/version-latest/03-stories/story-06.md
index 8a6a71375..f74421568 100644
--- a/contributing_versioned_docs/version-latest/03-stories/story-06.md
+++ b/contributing_versioned_docs/version-latest/03-stories/story-06.md
@@ -22,7 +22,7 @@ The winglang.io webpage is simple & clean (see [Figma](https://www.figma.com/fil
 
 It says below "Sign up for early access". She can't wait... Puts her email and clicks "submit". A message pops up saying that she should be expecting an email from us on how you can register, she goes into her inbox and sees she got an email from Elad that welcomes and asks her to fill in a short form so we can learn more about her before giving her access. She clicks the link. Her web browser takes her to a short form that asks her questions about her job (devops/developer/both/other), how she heard about wing, etc, and also her github username. She submits the form and gets a message, “thank you for submitting the form, please expect a github invitation to github.com/winglang/wing repo in your email”, she goes back to her email where an invite email is awaiting her. Wow these guys are quick! She clicks the link, approves the invite and goes to grab coffee.
 
-She lands in https://githug.com/winglang/wing and starts skimming through the README.md. It is clear to her that this project is in a very early stage, both because of the amount of stars and because of the first commit time. The big disclaimer at the top of the README.md also provides a hint. She starts reading the README and is excited to see the quick screencasts of what it looks like to write and compile wing software. She is psyched to take wing for a spin. She follows the instructions in the README (Mona Lisa told her about that already from Sprint 4), downloads the toolchain, writes the little "Hello World" and it works, sweet! The README points to a https://docs.winglang.io, to learn more about the language and its capabilities. She clicks on the link, where she reads about why we need a language like wing, and what is currently supported, she learns about inflights, resources, and Polymorphism. She reads through the language reference, and the roadmap and browses through the Wing SDK documentation. She feels like this might be a beginning of something big!
+She lands in https://githug.com/winglang/wing and starts skimming through the README.md. It is clear to her that this project is in a very early stage, both because of the amount of stars and because of the first commit time. The big disclaimer at the top of the README.md also provides a hint. She starts reading the README and is excited to see the quick screencasts of what it looks like to write and compile wing software. She is psyched to take wing for a spin. She follows the instructions in the README (Mona Lisa told her about that already from Sprint 4), downloads the toolchain, writes the little "Hello World" and it works, sweet! The README points to a https://www.winglang.io/docs/, to learn more about the language and its capabilities. She clicks on the link, where she reads about why we need a language like wing, and what is currently supported, she learns about inflights, resources, and Polymorphism. She reads through the language reference, and the roadmap and browses through the Wing SDK documentation. She feels like this might be a beginning of something big!
 
 Maria starts playing with the language, she wants to take this to the next level, and see how it is to build something with this, F$#!#! the disclaimer... She compiles a very simple program and gets a compiler error with the following message “'for' loops are not yet supported, please +1 https://winglang/wing/issues/119". She goes to GitHub and clicks the 👍 to indicate this is a feature she is after. A couple of minutes later she gets a notification from github with a reply from a guy named Mark. He comments on the issue:
 
diff --git a/contributing_versioned_docs/version-latest/999-rfcs/2022-05-28-winglang-reqs.md b/contributing_versioned_docs/version-latest/999-rfcs/2022-05-28-winglang-reqs.md
index 9afc26a5e..cfc6a7e83 100644
--- a/contributing_versioned_docs/version-latest/999-rfcs/2022-05-28-winglang-reqs.md
+++ b/contributing_versioned_docs/version-latest/999-rfcs/2022-05-28-winglang-reqs.md
@@ -6,7 +6,7 @@ description: The original requirements documents for the wing language experienc
 - **Author(s):**: @eladb
 - **Submission Date**: {2022-05-28}
 - **Stage**: Approved
-- **Implementation**: [Language Specification](https://docs.winglang.io/contributing/rfcs/language-spec)
+- **Implementation**: [Language Specification](https://www.winglang.io/contributing/rfcs/language-spec)
 
 ## About this Document
 
diff --git a/contributing_versioned_docs/version-latest/999-rfcs/2023-04-16-website-resource.md b/contributing_versioned_docs/version-latest/999-rfcs/2023-04-16-website-resource.md
index 6991f7d20..bffdc2daa 100644
--- a/contributing_versioned_docs/version-latest/999-rfcs/2023-04-16-website-resource.md
+++ b/contributing_versioned_docs/version-latest/999-rfcs/2023-04-16-website-resource.md
@@ -19,7 +19,7 @@ Stage: Fill in with current stage in the RFC lifecycle
 Stage Date: Fill in with date of last stage change
 -->
 
-> Implementing the website resource following the [SDK spec](https://docs.winglang.io/contributing/rfcs/2023-01-20-wingsdk-spec#website).
+> Implementing the website resource following the [SDK spec](https://www.winglang.io/contributing/rfcs/2023-01-20-wingsdk-spec#website).
 
 <!--
 This RFC has 3 sections: Requirements -> Design -> Implementation. We intentionally start with *Design* since it
diff --git a/contributing_versioned_docs/version-latest/999-rfcs/2023-06-12-language-spec.md b/contributing_versioned_docs/version-latest/999-rfcs/2023-06-12-language-spec.md
index fab738977..89fc32b38 100644
--- a/contributing_versioned_docs/version-latest/999-rfcs/2023-06-12-language-spec.md
+++ b/contributing_versioned_docs/version-latest/999-rfcs/2023-06-12-language-spec.md
@@ -2304,7 +2304,7 @@ test "can add objects" {
 
 The behavior of running tests with `wing test` CLI command is determined by the `cloud.TestRunner` resource in the Wing SDK, which can be implemented for any compiler target.
 
-See the [CLI User Manual](https://docs.winglang.io/reference/cli#test-wing-test) for more details on running tests.
+See the [CLI User Manual](https://www.winglang.io/docs/tools/cli#test-wing-test) for more details on running tests.
 
 [`▲ top`][top]
 
@@ -2461,7 +2461,7 @@ If [frozen](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Gl
 
 ### 6.1 Strings
 
-String reference doc is available [here](https://docs.winglang.io/standard-library/sdk#string-).
+String reference doc is available [here](https://www.winglang.io/docs/standard-library/std/api-reference#string-).
 Type of string is UTF-16 internally.  
 All string declaration variants are multi-line.  
 
diff --git a/contributing_versioned_docs/version-latest/999-rfcs/overview.md b/contributing_versioned_docs/version-latest/999-rfcs/overview.md
index 59623e199..7bbdf04ad 100644
--- a/contributing_versioned_docs/version-latest/999-rfcs/overview.md
+++ b/contributing_versioned_docs/version-latest/999-rfcs/overview.md
@@ -7,7 +7,7 @@ keywords: [rfcs, rfc, overview, process]
 An RFC is short for "request for comments". It's a document that describes a new feature or change
 to Wing. It's a way to propose, gather feedback, and reach consensus for a change from maintainers,
 contributors, and users before writing any code. For an example of an RFC, check out:
-https://docs.winglang.io/contributing/rfcs/2022-06-14-polycons
+https://www.winglang.io/contributing/rfcs/2022-06-14-polycons
 
 Usually, an RFC is a common practice for major features or complex changes that require that extra
 vetting. However, the process is designed to be as lightweight as needed and can be used to request
diff --git a/versioned_docs/version-latest/01-start-here/01-getting-started.md b/versioned_docs/version-latest/01-start-here/01-getting-started.md
index 09f5bf12e..592dfeb12 100644
--- a/versioned_docs/version-latest/01-start-here/01-getting-started.md
+++ b/versioned_docs/version-latest/01-start-here/01-getting-started.md
@@ -19,7 +19,7 @@ Please don't hesitate to ping us on [Slack](https://t.winglang.io/slack) or
 [file an issue](https://github.com/winglang/wing). We promise to do our best to
 respond quickly and help out.
 
-Our <a href="https://docs.winglang.io/status">Project Status</a> page includes
+Our <a href="https://www.winglang.io/contributing/status">Project Status</a> page includes
 more information about stability and roadmap 👷‍♀️ 
 
 :::
diff --git a/versioned_docs/version-latest/01-start-here/06-learn-more.md b/versioned_docs/version-latest/01-start-here/06-learn-more.md
index d20afb87a..6b2f891df 100644
--- a/versioned_docs/version-latest/01-start-here/06-learn-more.md
+++ b/versioned_docs/version-latest/01-start-here/06-learn-more.md
@@ -7,7 +7,7 @@ keywords: [Wing]
 
 To learn more, check out the rest of our docs where we cover all the basics with Wing, or check out our [examples repository](https://github.com/winglang/examples) to see some samples of Wing applications.
 
-We also have a [YouTube channel](https://www.youtube.com/@winglangio) where we share clips of demos and guest interviews on our [Twitch show](https://www.twitch.tv/winglangio), and a [blog](https://docs.winglang.io/blog).
+We also have a [YouTube channel](https://www.youtube.com/@winglangio) where we share clips of demos and guest interviews on our [Twitch show](https://www.twitch.tv/winglangio), and a [blog](https://www.winglang.io/blog).
 
 Finally, we encourage you to join our [Wing Slack](http://t.winglang.io/slack).
 We're here to help each other, answer questions, and share our cloud adventures.
diff --git a/versioned_docs/version-latest/03-language-guide/90-reference.md b/versioned_docs/version-latest/03-language-guide/90-reference.md
index 80777cb30..374600ccc 100644
--- a/versioned_docs/version-latest/03-language-guide/90-reference.md
+++ b/versioned_docs/version-latest/03-language-guide/90-reference.md
@@ -1819,7 +1819,7 @@ test "can add objects" {
 
 The behavior of running tests with `wing test` CLI command is determined by the `cloud.TestRunner` resource in the Wing SDK, which can be implemented for any compiler target.
 
-See the [CLI User Manual](https://docs.winglang.io/reference/cli#test-wing-test) for more details on running tests.
+See the [Test Concenpt Doc](https://www.winglang.io/docs/concepts/tests) for more details on running tests.
 
 ### 3.10 Roadmap
 
@@ -1962,7 +1962,7 @@ If [frozen](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Gl
 
 ### 6.1 Strings
 
-String reference doc is available [here](https://docs.winglang.io/standard-library/sdk#string-).
+String reference doc is available [here](https://www.winglang.io/docs/language-guide/language-reference#61-strings).
 Type of string is UTF-16 internally.  
 All string declaration variants are multi-line.  
 
diff --git a/versioned_docs/version-latest/04-standard-library/01-cloud/api.md b/versioned_docs/version-latest/04-standard-library/01-cloud/api.md
index 65adc282f..a90a0b4fc 100644
--- a/versioned_docs/version-latest/04-standard-library/01-cloud/api.md
+++ b/versioned_docs/version-latest/04-standard-library/01-cloud/api.md
@@ -25,12 +25,98 @@ When a client invokes a route, the corresponding event handler function executes
 
 ## Usage
 
-TODO
+### REST API
+
+The following example shows a complete REST API implemetnation using `cloud.Api`, `cloud.Table` & `cloud.Counter`
+```ts playground
+bring cloud;
+
+let api = new cloud.Api();
+// Used for generating unique id
+let counter = new cloud.Counter();
+// our employee database
+let db = new cloud.Table(
+  name: "employees",
+  primaryKey: "id",
+  columns: {
+    "name" => cloud.ColumnType.STRING
+  }
+);
+
+api.get("/employees", inflight (request: cloud.ApiRequest): cloud.ApiResponse => {
+  let result = MutJson [];
+  let var i = 0;
+  for employee in db.list() {
+    result.setAt(i, employee);
+    i = i + 1;
+  }
+  return cloud.ApiResponse {
+    status: 200,
+    body: Json.stringify(result)
+  };
+});
+
+
+api.get("/employees/{id}", inflight (request: cloud.ApiRequest): cloud.ApiResponse => {
+  let employee = db.get(request.vars.get("id"));
+  return cloud.ApiResponse {
+    status: 200,
+    body: Json.stringify(employee)
+  };
+});
+
+api.post("/employees", inflight (request: cloud.ApiRequest): cloud.ApiResponse => {
+   if let body = request.body {
+    let employeeData = Json.parse(body);
+    let id = "${counter.inc()}";
+    db.insert(id, employeeData);
+    return cloud.ApiResponse {
+      status: 201,
+      body: id
+    };
+   }
+});
+
+api.put("/employees/{id}", inflight (request: cloud.ApiRequest): cloud.ApiResponse => {
+  if let body = request.body {
+    let employeeData = Json.parse(body);
+    let id = request.vars.get("id");
+    db.update(id, employeeData);
+    return cloud.ApiResponse {
+      status: 200,
+      body: Json.stringify(employeeData)
+    };
+  }
+});
+
+api.delete("/employees/{id}", inflight (request: cloud.ApiRequest): cloud.ApiResponse => {
+  let id = request.vars.get("id");
+  db.delete(id);
+  return cloud.ApiResponse {
+    status: 204
+  };
+}); 
+```
 
 ## Target-specific details
 
-TODO
+### Simulator (`sim`)
+
+The sim implementation of `cloud.Api` uses [nodejs express]([url](https://expressjs.com/)).
+
+### AWS (`tf-aws` and `awscdk`)
+
+The AWS implementation of `cloud.Api` uses [Amazon API Gateway](https://aws.amazon.com/api-gateway/).
+
+### Azure (`tf-azure`)
+
+🚧 Not supported yet (tracking issue: [#625](https://github.com/winglang/wing/issues/625))
+
+### GCP (`tf-gcp`)
+
+🚧 Not supported yet (tracking issue: [#624](https://github.com/winglang/wing/issues/624))
+
 
 ## API Reference
 
-The full list of APIs for `cloud.Api` is available in the [API Reference](../api-reference).
+The full list of APIs for `cloud.Api` is available in the [API Reference](../api-reference).
\ No newline at end of file
diff --git a/versioned_docs/version-latest/04-standard-library/01-cloud/function.md b/versioned_docs/version-latest/04-standard-library/01-cloud/function.md
index 71d5c0634..51d9cb909 100644
--- a/versioned_docs/version-latest/04-standard-library/01-cloud/function.md
+++ b/versioned_docs/version-latest/04-standard-library/01-cloud/function.md
@@ -25,12 +25,42 @@ For performance reasons, most cloud providers impose a timeout on functions, aft
 
 ## Usage
 
-TODO
+```ts playground
+bring cloud;
+
+// defining a cloud.Function resource
+let countWords = new cloud.Function(inflight (s: str): str => {
+  return "${s.split(" ").length}";
+}) as "countWords";
+
+new cloud.Function(inflight () => {
+  let sentence = "I am a sentence with 7 words";
+  // invoking cloud.Function from inflight context
+  let wordsCount = countWords.invoke(sentence);
+  log("'${sentence}' has ${wordsCount} words");
+}) as "Invoke Me";
+```
 
 ## Target-specific details
 
-TODO
+### Simulator (`sim`)
+
+The sim implementation of `cloud.Function` uses JavaScript's function
+
+### AWS (`tf-aws` and `awscdk`)
+
+The AWS implementation of `cloud.Function` uses [Amazon Lambda](https://aws.amazon.com/lambda/).
+
+### Azure (`tf-azure`)
+
+The Azure implementation of `cloud.Function` uses [Azure Function](https://azure.microsoft.com/en-us/products/function).
+
+🚧 `invoke` API is not supported yet (tracking issue: [#1371](https://github.com/winglang/wing/issues/1371))
+
+### GCP (`tf-gcp`)
+
+🚧 Not supported yet (tracking issue: [#614](https://github.com/winglang/wing/issues/614))
 
 ## API Reference
 
-The full list of APIs for `cloud.Function` is available in the [API Reference](../api-reference).
+The full list of APIs for `cloud.Function` is available in the [API Reference](../api-reference).
\ No newline at end of file
diff --git a/versioned_docs/version-latest/04-standard-library/01-cloud/queue.md b/versioned_docs/version-latest/04-standard-library/01-cloud/queue.md
index 08c84b151..86bb045e4 100644
--- a/versioned_docs/version-latest/04-standard-library/01-cloud/queue.md
+++ b/versioned_docs/version-latest/04-standard-library/01-cloud/queue.md
@@ -23,12 +23,63 @@ Queues are typically used to decouple producers of data and the consumers of sai
 
 ## Usage
 
-TODO
+### Setting a Queue Consumer 
+
+```ts playground
+bring cloud;
+
+let q = new cloud.Queue();
+
+q.setConsumer(inflight (m: str) => {
+  log("messgae ${m} consumed")
+});
+
+new cloud.Function(inflight () => {
+  q.push("message a");
+  q.push("message b");
+});
+```
+
+### Using Queue inflight api
+
+Pusing messages, popping them, and purge
+```ts playground
+bring cloud;
+
+let q = new cloud.Queue();
+
+new cloud.Function(inflight () => {
+  q.push("message a");
+  q.push("message b");
+  q.push("message c");
+  q.push("message d");
+  log("approxSize is ${q.approxSize()}");
+  log("popping message ${q.pop()}");
+  log("popping message ${q.pop()}");
+  log("approxSize is ${q.approxSize()}");
+  q.purge();
+  log("approxSize is ${q.approxSize()}");
+});
+```
 
 ## Target-specific details
 
-TODO
+### Simulator (`sim`)
+
+The sim implementation of `cloud.Queue` uses JavaScript's `Array`
+
+### AWS (`tf-aws` and `awscdk`)
+
+The AWS implementation of `cloud.Queue` uses [Amazon Simple Queue Service](https://aws.amazon.com/sqs/).
+
+### Azure (`tf-azure`)
+
+🚧 Not supported yet (tracking issue: [#617](https://github.com/winglang/wing/issues/617))
+
+### GCP (`tf-gcp`)
+
+🚧 Not supported yet (tracking issue: [#616](https://github.com/winglang/wing/issues/616))
 
 ## API Reference
 
-The full list of APIs for `cloud.Queue` is available in the [API Reference](../api-reference).
+The full list of APIs for `cloud.Queue` is available in the [API Reference](../api-reference).
\ No newline at end of file
diff --git a/versioned_docs/version-latest/04-standard-library/03-http/api-reference.md b/versioned_docs/version-latest/04-standard-library/03-http/api-reference.md
index c12bdab29..a41cb512b 100644
--- a/versioned_docs/version-latest/04-standard-library/03-http/api-reference.md
+++ b/versioned_docs/version-latest/04-standard-library/03-http/api-reference.md
@@ -403,6 +403,8 @@ The request's method.
 | <code><a href="#@winglang/sdk.http.HttpMethod.DELETE">DELETE</a></code> | DELETE. |
 | <code><a href="#@winglang/sdk.http.HttpMethod.PATCH">PATCH</a></code> | PATCH. |
 | <code><a href="#@winglang/sdk.http.HttpMethod.POST">POST</a></code> | POST. |
+| <code><a href="#@winglang/sdk.http.HttpMethod.OPTIONS">OPTIONS</a></code> | OPTIONS. |
+| <code><a href="#@winglang/sdk.http.HttpMethod.HEAD">HEAD</a></code> | HEAD. |
 
 ---
 
@@ -441,6 +443,20 @@ POST.
 ---
 
 
+##### `OPTIONS` <a name="OPTIONS" id="@winglang/sdk.http.HttpMethod.OPTIONS"></a>
+
+OPTIONS.
+
+---
+
+
+##### `HEAD` <a name="HEAD" id="@winglang/sdk.http.HttpMethod.HEAD"></a>
+
+HEAD.
+
+---
+
+
 ### RequestCache <a name="RequestCache" id="@winglang/sdk.http.RequestCache"></a>
 
 The cache mode of the request.
diff --git a/versioned_docs/version-latest/999-faq/005-why-a-language.md b/versioned_docs/version-latest/999-faq/005-why-a-language.md
index 434c0c07d..0a2acf87c 100644
--- a/versioned_docs/version-latest/999-faq/005-why-a-language.md
+++ b/versioned_docs/version-latest/999-faq/005-why-a-language.md
@@ -74,7 +74,7 @@ import CodeComparison from '../src/components/CodeComparison';
 | Testing                      | Same tests run on local simulator and cloud, without mocks | Need mocks for local testing | Need mocks for local testing | Need mocks for local testing |
 
 ## Anything else?
-Creating a new language that is tailored to the cloud from the ground up also allows us to assemble a variety of features (some of which exist in other languages, of course) that, when put together, offer a delightful cloud development experience. You can read more about what these features are [here](https://docs.winglang.io/faq/good-fit).
+Creating a new language that is tailored to the cloud from the ground up also allows us to assemble a variety of features (some of which exist in other languages, of course) that, when put together, offer a delightful cloud development experience. You can read more about what these features are [here](https://www.winglang.io/docs/faq/good-fit).
 
 
 
diff --git a/versioned_docs/version-latest/999-faq/010-good-fit.md b/versioned_docs/version-latest/999-faq/010-good-fit.md
index 3a8eb8291..c958105ac 100644
--- a/versioned_docs/version-latest/999-faq/010-good-fit.md
+++ b/versioned_docs/version-latest/999-faq/010-good-fit.md
@@ -8,15 +8,17 @@ keywords: [faq, main features, winglang, Wing programming language, Wing languag
 Wing was built from the ground up to make it an ideal choice for building applications on any cloud.
 It includes an assembly of different features that serve that purpose:
 
-* [Cloud services](https://docs.winglang.io/concepts/resources) as first-class citizens, with [phase modifiers](https://docs.winglang.io/contributing/rfcs/language-spec#13-phase-modifiers) for config or runtime (`preflight` and `inflight`).
-* Higher level of cloud abstraction with a [standard library](https://docs.winglang.io/contributing/rfcs/2023-01-20-wingsdk-spec).
-* [Distributed computing primitives](https://docs.winglang.io/concepts/inflights).
-* [Compiler plugins](https://docs.winglang.io/reference/compiler-plugins) that can be used to customize the compilation output, such as infrastructure definitions.
-* [JavaScript interoperability](https://docs.winglang.io/contributing/rfcs/language-spec#5-interoperability).
+* [Cloud services](https://www.winglang.io/docs/faq/supported-clouds-services-and-engines/supported-services) as first-class citizens, with [phase modifiers](https://www.winglang.io/contributing/rfcs/language-spec#13-phase-modifiers) for config or runtime ([`preflight` and `inflight`](https://www.winglang.io/contributing/rfcs/2023-01-20-wingsdk-spec)).
+* Higher level of cloud abstraction with a [standard library](https://www.winglang.io/contributing/rfcs/2023-01-20-wingsdk-spec) of cloud resources that lets you write cloud portable code.
+* [Compiler plugins](https://www.winglang.io/docs/tools/compiler-plugins) that keep you in control by allowing you to customize the compilation output, such as infrastructure definitions.
+* Use any resource in the Terraform ecosystem as first-class citizen in your app.
+* [JavaScript interoperability](https://www.winglang.io/contributing/rfcs/language-spec#5-interoperability).
+* [Distributed computing primitives](https://www.winglang.io/docs/concepts/inflights).
 * Automatic generation of IAM policies and other cloud mechanics based on intent.
-* [Native JSON](https://docs.winglang.io/contributing/rfcs/language-spec#114-json-type) and schema validation support.
-* [Default immutability](https://docs.winglang.io/blog/2023/02/02/good-cognitive-friction#immutable-by-default).
-* [Implicit async](https://docs.winglang.io/contributing/rfcs/language-spec#113-asynchronous-model), explicit defer.
+* Local functional simulator with a visualization and interaction [console](https://www.winglang.io/docs/start-here/installation#wing-console) - used for testing and debugging with instant hot-reloading.
+* [Native JSON](https://www.winglang.io/contributing/rfcs/language-spec#114-json-type) and schema validation support.
+* [Default immutability](https://www.winglang.io/blog/2023/02/02/good-cognitive-friction#immutable-by-default).
+* [Implicit async](https://www.winglang.io/contributing/rfcs/language-spec#113-asynchronous-model), explicit defer.
 
-For a more in-depth look at Wing's features and benefits, check out our [documentation](https://docs.winglang.io/).
+For a more in-depth look at Wing's features and benefits, check out our [documentation](https://www.winglang.io/docs/).
 
diff --git a/versioned_docs/version-latest/999-faq/012-can-we-abstract-the-cloud.md b/versioned_docs/version-latest/999-faq/012-can-we-abstract-the-cloud.md
index b34344e2c..983bc69a4 100644
--- a/versioned_docs/version-latest/999-faq/012-can-we-abstract-the-cloud.md
+++ b/versioned_docs/version-latest/999-faq/012-can-we-abstract-the-cloud.md
@@ -18,7 +18,7 @@ We understand your concerns and acknowledge the challenges in achieving a higher
 
 Recall the days when developers had to write code for specific file systems or operating systems to save a file to disk. Today, programming languages and frameworks have successfully abstracted these components, a result of a long, gradual process. We envision a future where targeting specific cloud storage solutions or manually setting up IAM policies becomes unnecessary, as policies can be deduced from application code.
 
-While this process takes time, we've implemented [compiler plugins](https://docs.winglang.io/blog/2023/02/17/plugins) in Wing to allow customization of Terraform output, providing more control over finer details in the meantime.
+While this process takes time, we've implemented [compiler plugins](https://www.winglang.io/blog/2023/02/17/plugins) in Wing to allow customization of Terraform output, providing more control over finer details in the meantime.
 
 ## Why use Wing abstraction and compiler plugins?
 
diff --git a/versioned_docs/version-latest/999-faq/020-supported-clouds-services-and-engines/021-supported-clouds.md b/versioned_docs/version-latest/999-faq/020-supported-clouds-services-and-engines/021-supported-clouds.md
index 698939de5..6a864af9e 100644
--- a/versioned_docs/version-latest/999-faq/020-supported-clouds-services-and-engines/021-supported-clouds.md
+++ b/versioned_docs/version-latest/999-faq/020-supported-clouds-services-and-engines/021-supported-clouds.md
@@ -13,14 +13,14 @@ Since Wing is in early stages of development, the Wing SDK supports each cloud w
 * GCP - Partial support. Not all Wing code that compiles for the simulator will compile for GCP. 
 * Azure - Partial support. Not all Wing code that compiles for the simulator will compile for Azure. 
 
-We are working hard on filling the support gap between the different clouds -- check out our [roadmap](https://docs.winglang.io/status#roadmap) for more details. If there are other clouds you would like supported, please let us know through our GitHub or Slack!
+We are working hard on filling the support gap between the different clouds -- check out our [roadmap](https://www.winglang.io/contributing/status) for more details. If there are other clouds you would like supported, please let us know through our GitHub or Slack!
 
 Beyond the common set of cloud resources in the SDK, you can create resources for any other possible cloud by importing a [CDKTF](https://github.com/hashicorp/terraform-cdk) library corresponding to any given Terraform provider.
 
 ## How to check specific service support for each cloud
-Check out our [compatibility matrix](https://docs.winglang.io/reference/compatibility-matrix) to see which services are supported now on different clouds.
+Check out our [compatibility matrix](https://www.winglang.io/docs/standard-library/compatibility-matrix) to see which services are supported now on different clouds.
 
 ## How to deploy on the different clouds
-Check out our [CLI reference](https://docs.winglang.io/reference/cli) for instructions on how to deploy your wing code on the different clouds.
+Check out our [CLI reference](https://www.winglang.io/docs/tools/cli) for instructions on how to deploy your wing code on the different clouds.
 In the future, compiling for the different clouds could be supported through the GUI of the Wing Console as well (you can track progress in this [issue](https://github.com/winglang/wing/issues/2051)).
 
diff --git a/versioned_docs/version-latest/999-faq/020-supported-clouds-services-and-engines/022-supported-services.md b/versioned_docs/version-latest/999-faq/020-supported-clouds-services-and-engines/022-supported-services.md
index 02e1a6876..f6edd6550 100644
--- a/versioned_docs/version-latest/999-faq/020-supported-clouds-services-and-engines/022-supported-services.md
+++ b/versioned_docs/version-latest/999-faq/020-supported-clouds-services-and-engines/022-supported-services.md
@@ -11,10 +11,10 @@ Winglang was built from the ground up to make it an ideal choice for building ap
 Since Wing is in early stages of development, the Wing SDK supports each service with different levels of maturity.
 
 ## Compatibility Matrix
-We are working hard on filling the support gap between the different services -- check out our [compatibility matrix](https://docs.winglang.io/reference/compatibility-matrix) which parts of every service are supported on the different clouds and provisioning engines.
+We are working hard on filling the support gap between the different services -- check out our [compatibility matrix](https://www.winglang.io/docs/standard-library/compatibility-matrix) which parts of every service are supported on the different clouds and provisioning engines.
 
 ## Future plans
-You can also check out our [roadmap](https://docs.winglang.io/status#roadmap) for future plans.
+You can also check out our [roadmap](https://www.winglang.io/contributing/status) for future plans.
 
 If there are other services you would like to see supported, please let us know through our GitHub or Slack!
 
diff --git a/versioned_docs/version-latest/999-faq/020-supported-clouds-services-and-engines/023-supported-provisioning-engines.md b/versioned_docs/version-latest/999-faq/020-supported-clouds-services-and-engines/023-supported-provisioning-engines.md
index 897e8818e..9f0290aec 100644
--- a/versioned_docs/version-latest/999-faq/020-supported-clouds-services-and-engines/023-supported-provisioning-engines.md
+++ b/versioned_docs/version-latest/999-faq/020-supported-clouds-services-and-engines/023-supported-provisioning-engines.md
@@ -11,9 +11,9 @@ Since Wing is in early stages of development, it officially only supports the Te
 Have other provisioning engines you would like to use with Wing? Let us know by leaving a comment [here](https://github.com/winglang/wing/issues/2066)!
 
 ## How to check specific service support for each provisioning engine
-Check out our [compatibility matrix](https://docs.winglang.io/reference/compatibility-matrix) to see which services are supported now on which provisioning engines, and when they are expected to be supported if they aren't supported now.
+Check out our [compatibility matrix](https://www.winglang.io/docs/standard-library/compatibility-matrix) to see which services are supported now on which provisioning engines, and when they are expected to be supported if they aren't supported now.
 
 ## How to compile to different provisioning engines
-Check out our [CLI reference](https://docs.winglang.io/reference/cli) for instructions on how to compile your wing code for the different provisioning engines.
+Check out our [CLI reference](https://www.winglang.io/docs/tools/cli) for instructions on how to compile your wing code for the different provisioning engines.
 In the future, compiling for the different provisioning engines could be supported through the GUI of the Wing Console as well (you can track progress in this [issue](https://github.com/winglang/wing/issues/2051)).
 
diff --git a/versioned_docs/version-latest/999-faq/020-supported-clouds-services-and-engines/025-kubernetes-support.md b/versioned_docs/version-latest/999-faq/020-supported-clouds-services-and-engines/025-kubernetes-support.md
index 99be364a2..9e3aad77e 100644
--- a/versioned_docs/version-latest/999-faq/020-supported-clouds-services-and-engines/025-kubernetes-support.md
+++ b/versioned_docs/version-latest/999-faq/020-supported-clouds-services-and-engines/025-kubernetes-support.md
@@ -7,7 +7,7 @@ keywords: [faq, supported provisioning engines, Winglang, Wing programming langu
 
 ## Short answer
 We don't support Kubernetes yet, but we will in the future. 
-Our roadmap is [here](https://docs.winglang.io/status#roadmap).
+Our roadmap is [here](https://www.winglang.io/contributing/status).
 
 ## Long answer
 There are a different kinds of Kubernetes support with varying levels of maturity in Wing:
diff --git a/versioned_docs/version-latest/999-faq/040-alternatives/041-terraform-vs-wing.md b/versioned_docs/version-latest/999-faq/040-alternatives/041-terraform-vs-wing.md
index d633dd0f1..da0080fd7 100644
--- a/versioned_docs/version-latest/999-faq/040-alternatives/041-terraform-vs-wing.md
+++ b/versioned_docs/version-latest/999-faq/040-alternatives/041-terraform-vs-wing.md
@@ -10,8 +10,8 @@ These are the main differences between the two:
 
 1. Wing code is cloud-portable, so you can write the code once and then compile to any cloud. Terraform is not cloud-portable. Although it supports all clouds, you need to write specific code for each one.
 2. Since the Wing compiler sees both the infra and application code, it can automatically generate much of the infrastructure definitions that you have to manually define in Terraform (IAM policies, network topologies, etc).
-3. Wing compiles to Javascript and Terraform. You can use our [compiler plugins](https://docs.winglang.io/blog/2023/02/17/plugins) to customize the Terraform output directly.
-4. Wing provides local simulation and visualization [tools](https://docs.winglang.io/start-here/local) that let you develop locally with instant hot reloading. With Terraform, you must deploy to the cloud in order to interact with your application, which can take several minutes.
+3. Wing compiles to Javascript and Terraform. You can use our [compiler plugins](https://www.winglang.io/blog/2023/02/17/plugins) to customize the Terraform output directly.
+4. Wing provides local simulation and visualization [tools](https://www.winglang.io/docs/start-here/local) that let you develop locally with instant hot reloading. With Terraform, you must deploy to the cloud in order to interact with your application, which can take several minutes.
 
 ## Code samples
 
diff --git a/versioned_docs/version-latest/999-faq/040-alternatives/042-pulumi-vs-wing.md b/versioned_docs/version-latest/999-faq/040-alternatives/042-pulumi-vs-wing.md
index bbd58f561..926816f29 100644
--- a/versioned_docs/version-latest/999-faq/040-alternatives/042-pulumi-vs-wing.md
+++ b/versioned_docs/version-latest/999-faq/040-alternatives/042-pulumi-vs-wing.md
@@ -9,8 +9,8 @@ Wing is a general purpose programming language, designed to develop entire cloud
 The main differences between them are:
 1. Wing code is cloud-portable, so you can write the code once and then compile to any cloud. Pulumi is not cloud-portable. Although it supports all clouds, you need to write specific code for each one.
 2. Since the Wing compiler sees both the infra and application code, it can automatically generate much of the infrastructure definitions that you have to manually define in Pulumi (IAM policies, network topologies, etc).
-3. You will be able to compile Wing to Javascript and Pulumi in the future (roadmap is [here](https://docs.winglang.io/status#roadmap)). You will be able to use our [compiler plugins](https://docs.winglang.io/blog/2023/02/17/plugins) to customize the Pulumi output directly.
-4. Wing provides local simulation and visualization [tools](https://docs.winglang.io/start-here/local) that let you develop locally with instant hot reloading. With Pulumi, you must deploy to the cloud in order to interact with your application, which can take several minutes.
+3. You will be able to compile Wing to Javascript and Pulumi in the future (roadmap is [here](https://www.winglang.io/contributing/status)). You will be able to use our [compiler plugins](https://www.winglang.io/blog/2023/02/17/plugins) to customize the Pulumi output directly.
+4. Wing provides local simulation and visualization [tools](https://www.winglang.io/docs/start-here/local) that let you develop locally with instant hot reloading. With Pulumi, you must deploy to the cloud in order to interact with your application, which can take several minutes.
 
 ## Code samples
 
diff --git a/versioned_docs/version-latest/999-faq/040-alternatives/043-awscdk-vs-wing.md b/versioned_docs/version-latest/999-faq/040-alternatives/043-awscdk-vs-wing.md
index 18ee2ad4e..0ebf8606f 100644
--- a/versioned_docs/version-latest/999-faq/040-alternatives/043-awscdk-vs-wing.md
+++ b/versioned_docs/version-latest/999-faq/040-alternatives/043-awscdk-vs-wing.md
@@ -11,8 +11,8 @@ These are the main differences between the two:
 
 1. Wing code is cloud-portable, so you can write the code once and then compile to any cloud. The CDK is not cloud-portable. Although it supports all clouds, you need to write specific code for each one.
 2. Since the Wing compiler sees both the infra and application code, it can automatically generate much of the infrastructure definitions that you have to manually define in the CDK (IAM policies, network topologies, etc).
-3. Wing compiles to Javascript and ASW-CDK. You can use our [compiler plugins](https://docs.winglang.io/blog/2023/02/17/plugins) to customize the output directly.
-4. Wing provides local simulation and visualization [tools](https://docs.winglang.io/start-here/local) that let you develop locally with instant hot reloading. With the CDK, you must deploy to the cloud in order to interact with your application, which can take several minutes.
+3. Wing compiles to Javascript and ASW-CDK. You can use our [compiler plugins](https://www.winglang.io/blog/2023/02/17/plugins) to customize the output directly.
+4. Wing provides local simulation and visualization [tools](https://www.winglang.io/docs/start-here/local) that let you develop locally with instant hot reloading. With the CDK, you must deploy to the cloud in order to interact with your application, which can take several minutes.
 
 ## Code samples
 
diff --git a/versioned_docs/version-latest/999-faq/040-alternatives/044-cdktf-vs-wing.md b/versioned_docs/version-latest/999-faq/040-alternatives/044-cdktf-vs-wing.md
index 0ae0769fc..f9c21ffdf 100644
--- a/versioned_docs/version-latest/999-faq/040-alternatives/044-cdktf-vs-wing.md
+++ b/versioned_docs/version-latest/999-faq/040-alternatives/044-cdktf-vs-wing.md
@@ -10,7 +10,7 @@ Wing is a general purpose programming language, designed to develop entire cloud
 The main differences between the two are:
 1. Wing code is cloud-portable, so you can write the code once and then compile to any cloud. CDKTF is not cloud-portable. Although it supports all clouds, you need to write specific code for each one.
 2. Since the Wing compiler sees both the infra and application code, it can automatically generate much of the infrastructure definitions that you have to define manually in CDKTF (IAM policies, network topologies, etc).
-3. Wing provides local simulation and visualization [tools](https://docs.winglang.io/start-here/local) that let you develop locally with instant hot reloading. With the CDKTF, you must deploy to the cloud in order to interact with your application, which can take several minutes.
+3. Wing provides local simulation and visualization [tools](https://www.winglang.io/docs/start-here/local) that let you develop locally with instant hot reloading. With the CDKTF, you must deploy to the cloud in order to interact with your application, which can take several minutes.
 
 ## Code samples
 
diff --git a/versioned_docs/version-latest/999-faq/093-secrets.md b/versioned_docs/version-latest/999-faq/093-secrets.md
index 0c6031cef..867c68946 100644
--- a/versioned_docs/version-latest/999-faq/093-secrets.md
+++ b/versioned_docs/version-latest/999-faq/093-secrets.md
@@ -13,4 +13,4 @@ When the Secret resource is compiled to a cloud provider, it is provisioned usin
 
 In the future, Wing may include support for secret rotation.
 
-You can find more info in the [SDK spec](https://docs.winglang.io/contributing/rfcs/2023-01-20-wingsdk-spec#secret). 
\ No newline at end of file
+You can find more info in the [SDK spec](https://www.winglang.io/contributing/rfcs/2023-01-20-wingsdk-spec#secret).