Move docs under astro (#4928)

Current setup makes it very hard to iterate and see output in website as you have to always `pnpm copy` after a change last item for #2564
microsoft · Oct 31, 2024 · 67a0680 · 67a0680
1 parent 151be7f
commit 67a0680
Show file tree

Hide file tree

Showing 164 changed files with 48 additions and 100 deletions.
diff --git a/.chronus/changes/move-docs-2024-9-31-18-4-2.md b/.chronus/changes/move-docs-2024-9-31-18-4-2.md
@@ -0,0 +1,16 @@
+---
+# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking
+changeKind: internal
+packages:
+  - "@typespec/events"
+  - "@typespec/http"
+  - "@typespec/json-schema"
+  - "@typespec/openapi"
+  - "@typespec/openapi3"
+  - "@typespec/protobuf"
+  - "@typespec/rest"
+  - "@typespec/sse"
+  - "@typespec/streams"
+  - "@typespec/versioning"
+  - "@typespec/xml"
+---
diff --git a/.gitignore b/.gitignore
@@ -208,8 +208,7 @@ vite.config.ts.timestamp-*
 
 # Api extractor
 packages/*/etc/
-docs/**/js-api/
-website/src/content/docs/current/**/js-api/
+**/docs/**/js-api/
 
 # VS Code test web temp files
 .vscode-test-web/

diff --git a/.prettierignore b/.prettierignore
@@ -29,22 +29,15 @@ packages/compiler/test/formatter/**/*.tsp
 
 # That is an example with error and can't be formatted
 packages/samples/specs/local-typespec/test.tsp
-packages/website/build/
-packages/website/versioned_sidebars/
-packages/website/versions.json
 
 spec.emu.html
 
 # Auto generated reference docs.
-docs/**/reference/
-docs/standard-library/built-in-decorators.md
-docs/standard-library/built-in-data-types.md
-packages/website/versioned_docs/**/reference/
-packages/website/versioned_docs/**/standard-library/built-in-decorators.md
-packages/website/versioned_docs/**/standard-library/built-in-data-types.md
+website/src/content/docs/docs/**/reference/
+website/src/content/docs/docs/standard-library/built-in-decorators.md
+website/src/content/docs/docs/standard-library/built-in-data-types.md
 
 # Auto generated version list
-packages/website/playground-versions.json
 website/playground-versions.json
 
 # Auto generated built-in template list

diff --git a/docs/readme.md b/docs/readme.md
@@ -0,0 +1,13 @@
+## Docs moved
+
+Docs have moved into the website folder [../website/src/content/docs/docs](../website/src/content/docs/docs)
+
+### For reference
+
+This is an unfortunate current limitation of astro starlight. If things change in the future this is the current limitations:
+
+- content folder MUST be under the astro website package(default src/content)
+- astro allows symlink but it MUST be the whole collection(e.g. `src/content/docs`)
+- starlight only way to put docs under a `docs/` path is to have another `docs/` folder under the collection one `src/content/docs` (resulting in `src/content/docs/docs`)
+
+If any of the issues above is improve we could potentially move the docs back here or reduce at least some nesting
diff --git a/eng/common/scripts/check-docs.js b/eng/common/scripts/check-docs.js
diff --git a/eng/tsp-core/pipelines/jobs/build-and-test.yml b/eng/tsp-core/pipelines/jobs/build-and-test.yml
@@ -22,10 +22,6 @@ steps:
   - script: node eng/common/scripts/check-for-changed-files.js
     displayName: Check Git Status For Changed Files
 
-  - script: node eng/common/scripts/check-docs.js
-    displayName: Check docs
-    condition: ne(variables['Agent.OS'], 'Windows_NT')
-
   # Unlink node_modules folders to significantly improve performance of subsequent tasks
   # which need to walk the directory tree (and are hardcoded to follow symlinks).
   - script: pnpm run purge

diff --git a/packages/events/package.json b/packages/events/package.json
@@ -45,7 +45,7 @@
     "test-official": "vitest run --coverage --reporter=junit --reporter=default --no-file-parallelism",
     "lint": "eslint . --ext .ts --max-warnings=0",
     "lint:fix": "eslint . --fix --ext .ts",
-    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../docs/libraries/events/reference"
+    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../website/src/content/docs/docs/libraries/events/reference"
   },
   "files": [
     "lib/*.tsp",

diff --git a/packages/http/package.json b/packages/http/package.json
@@ -51,7 +51,7 @@
     "test:ci": "vitest run --coverage --reporter=junit --reporter=default",
     "lint": "eslint . --max-warnings=0",
     "lint:fix": "eslint . --fix",
-    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../docs/libraries/http/reference"
+    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../website/src/content/docs/docs/libraries/http/reference"
   },
   "files": [
     "lib/**/*.tsp",

diff --git a/packages/json-schema/package.json b/packages/json-schema/package.json
@@ -45,7 +45,7 @@
     "test:ci": "vitest run --coverage --reporter=junit --reporter=default",
     "lint": "eslint . --max-warnings=0",
     "lint:fix": "eslint . --fix",
-    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../docs/emitters/json-schema/reference",
+    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../website/src/content/docs/docs/emitters/json-schema/reference",
     "api-extractor": "api-extractor run --local --verbose"
   },
   "files": [

diff --git a/packages/openapi/package.json b/packages/openapi/package.json
@@ -45,7 +45,7 @@
     "test:ci": "vitest run --coverage --reporter=junit --reporter=default",
     "lint": "eslint . --max-warnings=0",
     "lint:fix": "eslint . --fix",
-    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../docs/libraries/openapi/reference",
+    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../website/src/content/docs/docs/libraries/openapi/reference",
     "api-extractor": "api-extractor run --local --verbose"
   },
   "files": [

diff --git a/packages/openapi3/package.json b/packages/openapi3/package.json
@@ -48,7 +48,7 @@
     "test:ci": "vitest run --coverage --reporter=junit --reporter=default",
     "lint": "eslint . --max-warnings=0",
     "lint:fix": "eslint . --fix",
-    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../docs/emitters/openapi3/reference",
+    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../website/src/content/docs/docs/emitters/openapi3/reference",
     "regen-specs": "cross-env RECORD=true vitest run",
     "gen-version": "node scripts/generate-version.js"
   },

diff --git a/packages/protobuf/package.json b/packages/protobuf/package.json
@@ -38,7 +38,7 @@
     "test:ci": "vitest run --coverage --reporter=junit --reporter=default",
     "lint": "eslint . --max-warnings=0",
     "lint:fix": "eslint . --fix",
-    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../docs/emitters/protobuf/reference"
+    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../website/src/content/docs/docs/emitters/protobuf/reference"
   },
   "peerDependencies": {
     "@typespec/compiler": "workspace:~"

diff --git a/packages/rest/package.json b/packages/rest/package.json
@@ -45,7 +45,7 @@
     "test:ci": "vitest run --coverage --reporter=junit --reporter=default",
     "lint": "eslint . --max-warnings=0",
     "lint:fix": "eslint . --fix",
-    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../docs/libraries/rest/reference"
+    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../website/src/content/docs/docs/libraries/rest/reference"
   },
   "files": [
     "lib/*.tsp",

diff --git a/packages/sse/package.json b/packages/sse/package.json
@@ -41,7 +41,7 @@
     "test-official": "vitest run --coverage --reporter=junit --reporter=default --no-file-parallelism",
     "lint": "eslint . --ext .ts --max-warnings=0",
     "lint:fix": "eslint . --fix --ext .ts",
-    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../docs/libraries/sse/reference"
+    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../website/src/content/docs/docs/libraries/sse/reference"
   },
   "files": [
     "lib/*.tsp",

diff --git a/packages/streams/package.json b/packages/streams/package.json
@@ -45,7 +45,7 @@
     "test-official": "vitest run --coverage --reporter=junit --reporter=default --no-file-parallelism",
     "lint": "eslint . --ext .ts --max-warnings=0",
     "lint:fix": "eslint . --fix --ext .ts",
-    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../docs/libraries/streams/reference"
+    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../website/src/content/docs/docs/libraries/streams/reference"
   },
   "files": [
     "lib/*.tsp",

diff --git a/packages/versioning/package.json b/packages/versioning/package.json
@@ -44,7 +44,7 @@
     "test:ci": "vitest run --coverage --reporter=junit --reporter=default",
     "lint": "eslint . --max-warnings=0",
     "lint:fix": "eslint . --fix",
-    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../docs/libraries/versioning/reference"
+    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../website/src/content/docs/docs/libraries/versioning/reference"
   },
   "files": [
     "lib/*.tsp",

diff --git a/packages/xml/package.json b/packages/xml/package.json
@@ -41,7 +41,7 @@
     "test-official": "vitest run --coverage --reporter=junit --reporter=default --no-file-parallelism",
     "lint": "eslint . --ext .ts --max-warnings=0",
     "lint:fix": "eslint . --fix --ext .ts",
-    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../docs/libraries/xml/reference",
+    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../website/src/content/docs/docs/libraries/xml/reference",
     "api-extractor": "api-extractor run --local --verbose"
   },
   "files": [

diff --git a/website/.gitignore b/website/.gitignore
diff --git a/website/.scripts/regen-compiler-docs.ts b/website/.scripts/regen-compiler-docs.ts
@@ -53,7 +53,7 @@ process.exit(exitCode);
 
 async function generateCompilerDocs() {
   const compilerPath = join(repoRoot, "packages/compiler");
-  const outputDir = join(repoRoot, "docs/standard-library");
+  const outputDir = join(repoRoot, "website/src/content/docs/docs/standard-library");
   const results = await resolveLibraryRefDocsBase(compilerPath, {
     namespaces: { include: ["TypeSpec"] },
   });

diff --git a/website/package.json b/website/package.json
@@ -1,20 +1,19 @@
 {
-  "name": "@typespec/website-astro",
+  "name": "@typespec/website",
   "type": "module",
   "private": true,
   "version": "0.0.1",
   "scripts": {
-    "copy": "cp -r ../docs/. ./src/content/docs/docs && cp -r ../blog/. ./src/content/blog",
     "clean": "rimraf ./dist ./temp ./.astro",
     "dev": "astro dev",
     "start": "astro dev",
     "build": "tsx ./.scripts/build.ts",
-    "build:web": "pnpm regen-all-packages-docs && pnpm copy && astro check --minimumFailingSeverity warning && astro build",
+    "build:web": "pnpm regen-all-packages-docs && astro check --minimumFailingSeverity warning && astro build",
     "preview": "astro preview",
     "astro": "astro",
     "update-playground-versions": "tsx ./.scripts/update-playground-versions.ts",
     "regen-docs": "tsx ./.scripts/regen-compiler-docs.ts",
-    "regen-all-packages-docs": "pnpm -w --filter \"@typespec/website-astro...\" --filter \"!@typespec/monorepo\" run regen-docs"
+    "regen-all-packages-docs": "pnpm -w --filter \"@typespec/website...\" --filter \"!@typespec/monorepo\" run regen-docs"
   },
   "imports": {
     "@theme/TabItem": "./src/components/docusaurus/tab-item.ts"

diff --git a/blog/2024-04-25-introducing/blog.md → ...ntent/blog/2024-04-25-introducing/blog.md b/blog/2024-04-25-introducing/blog.md → ...ntent/blog/2024-04-25-introducing/blog.md
diff --git a/blog/2024-04-25-introducing/hero.png → ...tent/blog/2024-04-25-introducing/hero.png b/blog/2024-04-25-introducing/hero.png → ...tent/blog/2024-04-25-introducing/hero.png
diff --git a/blog/2024-04-25-introducing/intro.png → ...ent/blog/2024-04-25-introducing/intro.png b/blog/2024-04-25-introducing/intro.png → ...ent/blog/2024-04-25-introducing/intro.png
diff --git a/docs/emitters/json-schema/guide.md → ...t/docs/docs/emitters/json-schema/guide.md b/docs/emitters/json-schema/guide.md → ...t/docs/docs/emitters/json-schema/guide.md
diff --git a/...tters/json-schema/reference/data-types.md → ...tters/json-schema/reference/data-types.md b/...tters/json-schema/reference/data-types.md → ...tters/json-schema/reference/data-types.md
diff --git a/...tters/json-schema/reference/decorators.md → ...tters/json-schema/reference/decorators.md b/...tters/json-schema/reference/decorators.md → ...tters/json-schema/reference/decorators.md
diff --git a/...emitters/json-schema/reference/emitter.md → ...emitters/json-schema/reference/emitter.md b/...emitters/json-schema/reference/emitter.md → ...emitters/json-schema/reference/emitter.md
diff --git a/.../emitters/json-schema/reference/index.mdx → .../emitters/json-schema/reference/index.mdx b/.../emitters/json-schema/reference/index.mdx → .../emitters/json-schema/reference/index.mdx
diff --git a/docs/emitters/openapi3/cli.md → ...ontent/docs/docs/emitters/openapi3/cli.md b/docs/emitters/openapi3/cli.md → ...ontent/docs/docs/emitters/openapi3/cli.md
diff --git a/docs/emitters/openapi3/diagnostics.md → ...ocs/docs/emitters/openapi3/diagnostics.md b/docs/emitters/openapi3/diagnostics.md → ...ocs/docs/emitters/openapi3/diagnostics.md
diff --git a/docs/emitters/openapi3/openapi.md → ...nt/docs/docs/emitters/openapi3/openapi.md b/docs/emitters/openapi3/openapi.md → ...nt/docs/docs/emitters/openapi3/openapi.md
diff --git a/...emitters/openapi3/reference/decorators.md → ...emitters/openapi3/reference/decorators.md b/...emitters/openapi3/reference/decorators.md → ...emitters/openapi3/reference/decorators.md
diff --git a/docs/emitters/openapi3/reference/emitter.md → ...cs/emitters/openapi3/reference/emitter.md b/docs/emitters/openapi3/reference/emitter.md → ...cs/emitters/openapi3/reference/emitter.md
diff --git a/docs/emitters/openapi3/reference/index.mdx → ...ocs/emitters/openapi3/reference/index.mdx b/docs/emitters/openapi3/reference/index.mdx → ...ocs/emitters/openapi3/reference/index.mdx
diff --git a/docs/emitters/protobuf/guide.md → ...tent/docs/docs/emitters/protobuf/guide.md b/docs/emitters/protobuf/guide.md → ...tent/docs/docs/emitters/protobuf/guide.md
diff --git a/...emitters/protobuf/reference/data-types.md → ...emitters/protobuf/reference/data-types.md b/...emitters/protobuf/reference/data-types.md → ...emitters/protobuf/reference/data-types.md
diff --git a/...emitters/protobuf/reference/decorators.md → ...emitters/protobuf/reference/decorators.md b/...emitters/protobuf/reference/decorators.md → ...emitters/protobuf/reference/decorators.md
diff --git a/docs/emitters/protobuf/reference/emitter.md → ...cs/emitters/protobuf/reference/emitter.md b/docs/emitters/protobuf/reference/emitter.md → ...cs/emitters/protobuf/reference/emitter.md
diff --git a/docs/emitters/protobuf/reference/index.mdx → ...ocs/emitters/protobuf/reference/index.mdx b/docs/emitters/protobuf/reference/index.mdx → ...ocs/emitters/protobuf/reference/index.mdx
diff --git a/docs/extending-typespec/basics.md → ...nt/docs/docs/extending-typespec/basics.md b/docs/extending-typespec/basics.md → ...nt/docs/docs/extending-typespec/basics.md
diff --git a/docs/extending-typespec/codefixes.md → ...docs/docs/extending-typespec/codefixes.md b/docs/extending-typespec/codefixes.md → ...docs/docs/extending-typespec/codefixes.md
diff --git a/docs/extending-typespec/create-decorators.md → ...s/extending-typespec/create-decorators.md b/docs/extending-typespec/create-decorators.md → ...s/extending-typespec/create-decorators.md
diff --git a/docs/extending-typespec/diagnostics.md → ...cs/docs/extending-typespec/diagnostics.md b/docs/extending-typespec/diagnostics.md → ...cs/docs/extending-typespec/diagnostics.md
diff --git a/docs/extending-typespec/emitter-framework.md → ...s/extending-typespec/emitter-framework.md b/docs/extending-typespec/emitter-framework.md → ...s/extending-typespec/emitter-framework.md
diff --git a/...ing-typespec/emitter-metadata-handling.md → ...ing-typespec/emitter-metadata-handling.md b/...ing-typespec/emitter-metadata-handling.md → ...ing-typespec/emitter-metadata-handling.md
diff --git a/docs/extending-typespec/emitters-basics.md → ...ocs/extending-typespec/emitters-basics.md b/docs/extending-typespec/emitters-basics.md → ...ocs/extending-typespec/emitters-basics.md
diff --git a/docs/extending-typespec/linters.md → ...t/docs/docs/extending-typespec/linters.md b/docs/extending-typespec/linters.md → ...t/docs/docs/extending-typespec/linters.md
diff --git a/...-typespec/writing-scaffolding-template.md → ...-typespec/writing-scaffolding-template.md b/...-typespec/writing-scaffolding-template.md → ...-typespec/writing-scaffolding-template.md
diff --git a/...ng-started-rest/01-setup-basic-syntax.mdx → ...ng-started-rest/01-setup-basic-syntax.mdx b/...ng-started-rest/01-setup-basic-syntax.mdx → ...ng-started-rest/01-setup-basic-syntax.mdx
diff --git a/...g-started-rest/02-operations-responses.md → ...g-started-rest/02-operations-responses.md b/...g-started-rest/02-operations-responses.md → ...g-started-rest/02-operations-responses.md
diff --git a/...etting-started-rest/03-handling-errors.md → ...etting-started-rest/03-handling-errors.md b/...etting-started-rest/03-handling-errors.md → ...etting-started-rest/03-handling-errors.md
diff --git a/...ting-started-rest/04-common-parameters.md → ...ting-started-rest/04-common-parameters.md b/...ting-started-rest/04-common-parameters.md → ...ting-started-rest/04-common-parameters.md
diff --git a/...getting-started-rest/05-authentication.md → ...getting-started-rest/05-authentication.md b/...getting-started-rest/05-authentication.md → ...getting-started-rest/05-authentication.md
diff --git a/...ed/getting-started-rest/06-versioning.mdx → ...ed/getting-started-rest/06-versioning.mdx b/...ed/getting-started-rest/06-versioning.mdx → ...ed/getting-started-rest/06-versioning.mdx
diff --git a/...started-rest/07-custom-response-models.md → ...started-rest/07-custom-response-models.md b/...started-rest/07-custom-response-models.md → ...started-rest/07-custom-response-models.md
diff --git a/...ted/getting-started-rest/08-conclusion.md → ...ted/getting-started-rest/08-conclusion.md b/...ted/getting-started-rest/08-conclusion.md → ...ted/getting-started-rest/08-conclusion.md
diff --git a/docs/getting-started/getting-started.md → ...s/docs/getting-started/getting-started.md b/docs/getting-started/getting-started.md → ...s/docs/getting-started/getting-started.md
diff --git a/...tting-started/typespec-for-openapi-dev.md → ...tting-started/typespec-for-openapi-dev.md b/...tting-started/typespec-for-openapi-dev.md → ...tting-started/typespec-for-openapi-dev.md
diff --git a/docs/handbook/cli.md → ...ite/src/content/docs/docs/handbook/cli.md b/docs/handbook/cli.md → ...ite/src/content/docs/docs/handbook/cli.md
diff --git a/docs/handbook/configuration/configuration.md → ...s/handbook/configuration/configuration.md b/docs/handbook/configuration/configuration.md → ...s/handbook/configuration/configuration.md
diff --git a/docs/handbook/configuration/tracing.md → ...cs/docs/handbook/configuration/tracing.md b/docs/handbook/configuration/tracing.md → ...cs/docs/handbook/configuration/tracing.md
diff --git a/docs/handbook/faq.md → ...ite/src/content/docs/docs/handbook/faq.md b/docs/handbook/faq.md → ...ite/src/content/docs/docs/handbook/faq.md
diff --git a/docs/handbook/formatter.md → ...c/content/docs/docs/handbook/formatter.md b/docs/handbook/formatter.md → ...c/content/docs/docs/handbook/formatter.md
diff --git a/docs/handbook/releases.md → ...rc/content/docs/docs/handbook/releases.md b/docs/handbook/releases.md → ...rc/content/docs/docs/handbook/releases.md
diff --git a/docs/handbook/reproducibility.md → ...ent/docs/docs/handbook/reproducibility.md b/docs/handbook/reproducibility.md → ...ent/docs/docs/handbook/reproducibility.md
diff --git a/docs/handbook/style-guide.md → ...content/docs/docs/handbook/style-guide.md b/docs/handbook/style-guide.md → ...content/docs/docs/handbook/style-guide.md
diff --git a/docs/images/vscode.gif → ...e/src/content/docs/docs/images/vscode.gif b/docs/images/vscode.gif → ...e/src/content/docs/docs/images/vscode.gif
diff --git a/docs/introduction/editor/vs.md → ...ntent/docs/docs/introduction/editor/vs.md b/docs/introduction/editor/vs.md → ...ntent/docs/docs/introduction/editor/vs.md
diff --git a/docs/introduction/editor/vscode.md → ...t/docs/docs/introduction/editor/vscode.md b/docs/introduction/editor/vscode.md → ...t/docs/docs/introduction/editor/vscode.md
diff --git a/docs/introduction/installation.mdx → ...t/docs/docs/introduction/installation.mdx b/docs/introduction/installation.mdx → ...t/docs/docs/introduction/installation.mdx
diff --git a/docs/language-basics/alias.md → ...ontent/docs/docs/language-basics/alias.md b/docs/language-basics/alias.md → ...ontent/docs/docs/language-basics/alias.md
diff --git a/docs/language-basics/built-in-types.md → ...cs/docs/language-basics/built-in-types.md b/docs/language-basics/built-in-types.md → ...cs/docs/language-basics/built-in-types.md
diff --git a/docs/language-basics/decorators.md → ...t/docs/docs/language-basics/decorators.md b/docs/language-basics/decorators.md → ...t/docs/docs/language-basics/decorators.md
diff --git a/docs/language-basics/documentation.md → ...ocs/docs/language-basics/documentation.md b/docs/language-basics/documentation.md → ...ocs/docs/language-basics/documentation.md
diff --git a/docs/language-basics/enums.md → ...ontent/docs/docs/language-basics/enums.md b/docs/language-basics/enums.md → ...ontent/docs/docs/language-basics/enums.md
diff --git a/docs/language-basics/identifiers.md → .../docs/docs/language-basics/identifiers.md b/docs/language-basics/identifiers.md → .../docs/docs/language-basics/identifiers.md
diff --git a/docs/language-basics/imports.md → ...tent/docs/docs/language-basics/imports.md b/docs/language-basics/imports.md → ...tent/docs/docs/language-basics/imports.md
diff --git a/docs/language-basics/interfaces.md → ...t/docs/docs/language-basics/interfaces.md b/docs/language-basics/interfaces.md → ...t/docs/docs/language-basics/interfaces.md
diff --git a/docs/language-basics/intersections.md → ...ocs/docs/language-basics/intersections.md b/docs/language-basics/intersections.md → ...ocs/docs/language-basics/intersections.md
diff --git a/docs/language-basics/models.md → ...ntent/docs/docs/language-basics/models.md b/docs/language-basics/models.md → ...ntent/docs/docs/language-basics/models.md
diff --git a/docs/language-basics/namespaces.md → ...t/docs/docs/language-basics/namespaces.md b/docs/language-basics/namespaces.md → ...t/docs/docs/language-basics/namespaces.md
diff --git a/docs/language-basics/operations.md → ...t/docs/docs/language-basics/operations.md b/docs/language-basics/operations.md → ...t/docs/docs/language-basics/operations.md
diff --git a/docs/language-basics/overview.md → ...ent/docs/docs/language-basics/overview.md b/docs/language-basics/overview.md → ...ent/docs/docs/language-basics/overview.md
diff --git a/docs/language-basics/scalars.md → ...tent/docs/docs/language-basics/scalars.md b/docs/language-basics/scalars.md → ...tent/docs/docs/language-basics/scalars.md
diff --git a/docs/language-basics/templates.md → ...nt/docs/docs/language-basics/templates.md b/docs/language-basics/templates.md → ...nt/docs/docs/language-basics/templates.md
diff --git a/docs/language-basics/type-literals.md → ...ocs/docs/language-basics/type-literals.md b/docs/language-basics/type-literals.md → ...ocs/docs/language-basics/type-literals.md
diff --git a/docs/language-basics/type-relations.md → ...cs/docs/language-basics/type-relations.md b/docs/language-basics/type-relations.md → ...cs/docs/language-basics/type-relations.md
diff --git a/docs/language-basics/unions.md → ...ntent/docs/docs/language-basics/unions.md b/docs/language-basics/unions.md → ...ntent/docs/docs/language-basics/unions.md
diff --git a/docs/language-basics/values.md → ...ntent/docs/docs/language-basics/values.md b/docs/language-basics/values.md → ...ntent/docs/docs/language-basics/values.md
diff --git a/.../libraries/events/reference/decorators.md → .../libraries/events/reference/decorators.md b/.../libraries/events/reference/decorators.md → .../libraries/events/reference/decorators.md
diff --git a/docs/libraries/events/reference/index.mdx → ...docs/libraries/events/reference/index.mdx b/docs/libraries/events/reference/index.mdx → ...docs/libraries/events/reference/index.mdx
diff --git a/...tp-server-javascript/reference/emitter.md → ...tp-server-javascript/reference/emitter.md b/...tp-server-javascript/reference/emitter.md → ...tp-server-javascript/reference/emitter.md
diff --git a/...ttp-server-javascript/reference/index.mdx → ...ttp-server-javascript/reference/index.mdx b/...ttp-server-javascript/reference/index.mdx → ...ttp-server-javascript/reference/index.mdx
diff --git a/docs/libraries/http/authentication.md → ...ocs/docs/libraries/http/authentication.md b/docs/libraries/http/authentication.md → ...ocs/docs/libraries/http/authentication.md
diff --git a/docs/libraries/http/cheat-sheet.md → ...t/docs/docs/libraries/http/cheat-sheet.md b/docs/libraries/http/cheat-sheet.md → ...t/docs/docs/libraries/http/cheat-sheet.md
diff --git a/docs/libraries/http/content-types.md → ...docs/docs/libraries/http/content-types.md b/docs/libraries/http/content-types.md → ...docs/docs/libraries/http/content-types.md
diff --git a/docs/libraries/http/encoding.md → ...tent/docs/docs/libraries/http/encoding.md b/docs/libraries/http/encoding.md → ...tent/docs/docs/libraries/http/encoding.md
diff --git a/docs/libraries/http/examples.md → ...tent/docs/docs/libraries/http/examples.md b/docs/libraries/http/examples.md → ...tent/docs/docs/libraries/http/examples.md
diff --git a/docs/libraries/http/multipart.md → ...ent/docs/docs/libraries/http/multipart.md b/docs/libraries/http/multipart.md → ...ent/docs/docs/libraries/http/multipart.md
diff --git a/docs/libraries/http/operations.md → ...nt/docs/docs/libraries/http/operations.md b/docs/libraries/http/operations.md → ...nt/docs/docs/libraries/http/operations.md
diff --git a/docs/libraries/http/reference/data-types.md → ...cs/libraries/http/reference/data-types.md b/docs/libraries/http/reference/data-types.md → ...cs/libraries/http/reference/data-types.md
diff --git a/docs/libraries/http/reference/decorators.md → ...cs/libraries/http/reference/decorators.md b/docs/libraries/http/reference/decorators.md → ...cs/libraries/http/reference/decorators.md
diff --git a/docs/libraries/http/reference/index.mdx → ...s/docs/libraries/http/reference/index.mdx b/docs/libraries/http/reference/index.mdx → ...s/docs/libraries/http/reference/index.mdx
diff --git a/docs/libraries/http/reference/linter.md → ...s/docs/libraries/http/reference/linter.md b/docs/libraries/http/reference/linter.md → ...s/docs/libraries/http/reference/linter.md
diff --git a/...ttp/rules/op-reference-container-route.md → ...ttp/rules/op-reference-container-route.md b/...ttp/rules/op-reference-container-route.md → ...ttp/rules/op-reference-container-route.md
diff --git a/...libraries/openapi/reference/data-types.md → ...libraries/openapi/reference/data-types.md b/...libraries/openapi/reference/data-types.md → ...libraries/openapi/reference/data-types.md
diff --git a/...libraries/openapi/reference/decorators.md → ...libraries/openapi/reference/decorators.md b/...libraries/openapi/reference/decorators.md → ...libraries/openapi/reference/decorators.md
diff --git a/docs/libraries/openapi/reference/index.mdx → ...ocs/libraries/openapi/reference/index.mdx b/docs/libraries/openapi/reference/index.mdx → ...ocs/libraries/openapi/reference/index.mdx
diff --git a/docs/libraries/rest/cheat-sheet.md → ...t/docs/docs/libraries/rest/cheat-sheet.md b/docs/libraries/rest/cheat-sheet.md → ...t/docs/docs/libraries/rest/cheat-sheet.md
diff --git a/docs/libraries/rest/reference/data-types.md → ...cs/libraries/rest/reference/data-types.md b/docs/libraries/rest/reference/data-types.md → ...cs/libraries/rest/reference/data-types.md
diff --git a/docs/libraries/rest/reference/decorators.md → ...cs/libraries/rest/reference/decorators.md b/docs/libraries/rest/reference/decorators.md → ...cs/libraries/rest/reference/decorators.md
diff --git a/docs/libraries/rest/reference/index.mdx → ...s/docs/libraries/rest/reference/index.mdx b/docs/libraries/rest/reference/index.mdx → ...s/docs/libraries/rest/reference/index.mdx
diff --git a/docs/libraries/rest/reference/interfaces.md → ...cs/libraries/rest/reference/interfaces.md b/docs/libraries/rest/reference/interfaces.md → ...cs/libraries/rest/reference/interfaces.md
diff --git a/docs/libraries/rest/resource-routing.md → ...s/docs/libraries/rest/resource-routing.md b/docs/libraries/rest/resource-routing.md → ...s/docs/libraries/rest/resource-routing.md
diff --git a/docs/libraries/sse/reference/data-types.md → ...ocs/libraries/sse/reference/data-types.md b/docs/libraries/sse/reference/data-types.md → ...ocs/libraries/sse/reference/data-types.md
diff --git a/docs/libraries/sse/reference/decorators.md → ...ocs/libraries/sse/reference/decorators.md b/docs/libraries/sse/reference/decorators.md → ...ocs/libraries/sse/reference/decorators.md
diff --git a/docs/libraries/sse/reference/index.mdx → ...cs/docs/libraries/sse/reference/index.mdx b/docs/libraries/sse/reference/index.mdx → ...cs/docs/libraries/sse/reference/index.mdx
diff --git a/.../libraries/stream/reference/data-types.md → .../libraries/stream/reference/data-types.md b/.../libraries/stream/reference/data-types.md → .../libraries/stream/reference/data-types.md
diff --git a/.../libraries/stream/reference/decorators.md → .../libraries/stream/reference/decorators.md b/.../libraries/stream/reference/decorators.md → .../libraries/stream/reference/decorators.md
diff --git a/docs/libraries/stream/reference/index.mdx → ...docs/libraries/stream/reference/index.mdx b/docs/libraries/stream/reference/index.mdx → ...docs/libraries/stream/reference/index.mdx
diff --git a/...libraries/streams/reference/data-types.md → ...libraries/streams/reference/data-types.md b/...libraries/streams/reference/data-types.md → ...libraries/streams/reference/data-types.md
diff --git a/...libraries/streams/reference/decorators.md → ...libraries/streams/reference/decorators.md b/...libraries/streams/reference/decorators.md → ...libraries/streams/reference/decorators.md
diff --git a/docs/libraries/streams/reference/index.mdx → ...ocs/libraries/streams/reference/index.mdx b/docs/libraries/streams/reference/index.mdx → ...ocs/libraries/streams/reference/index.mdx
diff --git a/docs/libraries/versioning/guide.md → ...t/docs/docs/libraries/versioning/guide.md b/docs/libraries/versioning/guide.md → ...t/docs/docs/libraries/versioning/guide.md
diff --git a/...raries/versioning/reference/decorators.md → ...raries/versioning/reference/decorators.md b/...raries/versioning/reference/decorators.md → ...raries/versioning/reference/decorators.md
diff --git a/.../libraries/versioning/reference/index.mdx → .../libraries/versioning/reference/index.mdx b/.../libraries/versioning/reference/index.mdx → .../libraries/versioning/reference/index.mdx
diff --git a/docs/libraries/xml/guide.md → .../content/docs/docs/libraries/xml/guide.md b/docs/libraries/xml/guide.md → .../content/docs/docs/libraries/xml/guide.md
diff --git a/docs/libraries/xml/reference/decorators.md → ...ocs/libraries/xml/reference/decorators.md b/docs/libraries/xml/reference/decorators.md → ...ocs/libraries/xml/reference/decorators.md
diff --git a/docs/libraries/xml/reference/index.mdx → ...cs/docs/libraries/xml/reference/index.mdx b/docs/libraries/xml/reference/index.mdx → ...cs/docs/libraries/xml/reference/index.mdx
diff --git a/.../release-notes/cadl-typespec-migration.md → .../release-notes/cadl-typespec-migration.md b/.../release-notes/cadl-typespec-migration.md → .../release-notes/cadl-typespec-migration.md
diff --git a/docs/release-notes/release-2022-07-08.md → .../docs/release-notes/release-2022-07-08.md b/docs/release-notes/release-2022-07-08.md → .../docs/release-notes/release-2022-07-08.md
diff --git a/docs/release-notes/release-2022-08-10.md → .../docs/release-notes/release-2022-08-10.md b/docs/release-notes/release-2022-08-10.md → .../docs/release-notes/release-2022-08-10.md
diff --git a/docs/release-notes/release-2022-09-07.md → .../docs/release-notes/release-2022-09-07.md b/docs/release-notes/release-2022-09-07.md → .../docs/release-notes/release-2022-09-07.md
diff --git a/docs/release-notes/release-2022-10-12.md → .../docs/release-notes/release-2022-10-12.md b/docs/release-notes/release-2022-10-12.md → .../docs/release-notes/release-2022-10-12.md
diff --git a/docs/release-notes/release-2022-12-07.md → .../docs/release-notes/release-2022-12-07.md b/docs/release-notes/release-2022-12-07.md → .../docs/release-notes/release-2022-12-07.md
diff --git a/docs/release-notes/release-2023-01-12.md → .../docs/release-notes/release-2023-01-12.md b/docs/release-notes/release-2023-01-12.md → .../docs/release-notes/release-2023-01-12.md
diff --git a/docs/release-notes/release-2023-02-07.md → .../docs/release-notes/release-2023-02-07.md b/docs/release-notes/release-2023-02-07.md → .../docs/release-notes/release-2023-02-07.md
diff --git a/docs/release-notes/release-2023-03-13.md → .../docs/release-notes/release-2023-03-13.md b/docs/release-notes/release-2023-03-13.md → .../docs/release-notes/release-2023-03-13.md
diff --git a/docs/release-notes/release-2023-04-11.md → .../docs/release-notes/release-2023-04-11.md b/docs/release-notes/release-2023-04-11.md → .../docs/release-notes/release-2023-04-11.md
diff --git a/docs/release-notes/release-2023-05-10.md → .../docs/release-notes/release-2023-05-10.md b/docs/release-notes/release-2023-05-10.md → .../docs/release-notes/release-2023-05-10.md
diff --git a/docs/release-notes/release-2023-06-06.md → .../docs/release-notes/release-2023-06-06.md b/docs/release-notes/release-2023-06-06.md → .../docs/release-notes/release-2023-06-06.md
diff --git a/docs/release-notes/release-2023-07-11.md → .../docs/release-notes/release-2023-07-11.md b/docs/release-notes/release-2023-07-11.md → .../docs/release-notes/release-2023-07-11.md
diff --git a/docs/release-notes/release-2023-08-08.md → .../docs/release-notes/release-2023-08-08.md b/docs/release-notes/release-2023-08-08.md → .../docs/release-notes/release-2023-08-08.md
diff --git a/docs/release-notes/release-2023-09-12.md → .../docs/release-notes/release-2023-09-12.md b/docs/release-notes/release-2023-09-12.md → .../docs/release-notes/release-2023-09-12.md
diff --git a/docs/release-notes/release-2023-10-11.md → .../docs/release-notes/release-2023-10-11.md b/docs/release-notes/release-2023-10-11.md → .../docs/release-notes/release-2023-10-11.md
diff --git a/docs/release-notes/release-2023-11-07.md → .../docs/release-notes/release-2023-11-07.md b/docs/release-notes/release-2023-11-07.md → .../docs/release-notes/release-2023-11-07.md
diff --git a/docs/release-notes/release-2023-12-06.md → .../docs/release-notes/release-2023-12-06.md b/docs/release-notes/release-2023-12-06.md → .../docs/release-notes/release-2023-12-06.md
diff --git a/docs/release-notes/release-2024-01-23.md → .../docs/release-notes/release-2024-01-23.md b/docs/release-notes/release-2024-01-23.md → .../docs/release-notes/release-2024-01-23.md
diff --git a/docs/release-notes/release-2024-02-06.md → .../docs/release-notes/release-2024-02-06.md b/docs/release-notes/release-2024-02-06.md → .../docs/release-notes/release-2024-02-06.md
diff --git a/docs/release-notes/release-2024-03-05.md → .../docs/release-notes/release-2024-03-05.md b/docs/release-notes/release-2024-03-05.md → .../docs/release-notes/release-2024-03-05.md
diff --git a/docs/release-notes/release-2024-04-02.md → .../docs/release-notes/release-2024-04-02.md b/docs/release-notes/release-2024-04-02.md → .../docs/release-notes/release-2024-04-02.md
diff --git a/docs/release-notes/release-2024-05-07.md → .../docs/release-notes/release-2024-05-07.md b/docs/release-notes/release-2024-05-07.md → .../docs/release-notes/release-2024-05-07.md
diff --git a/docs/release-notes/release-2024-06-10.md → .../docs/release-notes/release-2024-06-10.md b/docs/release-notes/release-2024-06-10.md → .../docs/release-notes/release-2024-06-10.md
diff --git a/docs/release-notes/release-2024-07-16.md → .../docs/release-notes/release-2024-07-16.md b/docs/release-notes/release-2024-07-16.md → .../docs/release-notes/release-2024-07-16.md
diff --git a/docs/release-notes/release-2024-08-06.md → .../docs/release-notes/release-2024-08-06.md b/docs/release-notes/release-2024-08-06.md → .../docs/release-notes/release-2024-08-06.md
diff --git a/docs/release-notes/release-2024-09-10.md → .../docs/release-notes/release-2024-09-10.md b/docs/release-notes/release-2024-09-10.md → .../docs/release-notes/release-2024-09-10.md
diff --git a/docs/release-notes/release-2024-10-09.md → .../docs/release-notes/release-2024-10-09.md b/docs/release-notes/release-2024-10-09.md → .../docs/release-notes/release-2024-10-09.md
diff --git a/docs/release-notes/signature-help.png → ...ocs/docs/release-notes/signature-help.png b/docs/release-notes/signature-help.png → ...ocs/docs/release-notes/signature-help.png
diff --git a/docs/standard-library/built-in-data-types.md → ...s/standard-library/built-in-data-types.md b/docs/standard-library/built-in-data-types.md → ...s/standard-library/built-in-data-types.md
diff --git a/docs/standard-library/built-in-decorators.md → ...s/standard-library/built-in-decorators.md b/docs/standard-library/built-in-decorators.md → ...s/standard-library/built-in-decorators.md
diff --git a/...dard-library/diags/triple-quote-indent.md → ...dard-library/diags/triple-quote-indent.md b/...dard-library/diags/triple-quote-indent.md → ...dard-library/diags/triple-quote-indent.md
diff --git a/docs/standard-library/discriminated-types.md → ...s/standard-library/discriminated-types.md b/docs/standard-library/discriminated-types.md → ...s/standard-library/discriminated-types.md
diff --git a/docs/standard-library/encoded-names.md → ...cs/docs/standard-library/encoded-names.md b/docs/standard-library/encoded-names.md → ...cs/docs/standard-library/encoded-names.md
diff --git a/docs/standard-library/examples.md → ...nt/docs/docs/standard-library/examples.md b/docs/standard-library/examples.md → ...nt/docs/docs/standard-library/examples.md