From 2b00e87902148acf82069b423815b1fee5e1e118 Mon Sep 17 00:00:00 2001 From: Timothee Guerin Date: Tue, 5 Nov 2024 09:30:25 -0800 Subject: [PATCH] Move docs under website (#1801) --- .../changes/move-docs-2024-10-4-23-37-28.md | 14 +++++ .gitignore | 2 +- .vscode/launch.json | 2 +- docs/libraries/azure-core/reference/linter.md | 63 ------------------- docs/readme.md | 13 ++++ .../typespec-autorest-canonical/package.json | 2 +- packages/typespec-autorest/package.json | 2 +- packages/typespec-azure-core/package.json | 2 +- .../typespec-azure-portal-core/package.json | 2 +- .../package.json | 2 +- packages/typespec-azure-rulesets/package.json | 2 +- .../package.json | 2 +- packages/typespec-service-csharp/package.json | 2 +- website/.gitignore | 1 - website/package.json | 3 +- .../reference/emitter.md | 0 .../reference/index.mdx | 0 .../docs}/emitters/typespec-autorest/index.md | 0 .../typespec-autorest/reference/decorators.md | 0 .../typespec-autorest/reference/emitter.md | 0 .../typespec-autorest/reference/index.mdx | 0 .../reference/index.mdx | 0 .../reference/linter.md | 0 .../docs}/emitters/typespec-csharp/index.md | 0 .../reference/emitter.md | 0 .../reference/index.mdx | 0 .../docs}/getstarted/azure-core/step01.md | 0 .../docs}/getstarted/azure-core/step02.md | 0 .../docs}/getstarted/azure-core/step03.md | 0 .../docs}/getstarted/azure-core/step04.md | 0 .../docs}/getstarted/azure-core/step05.md | 0 .../docs}/getstarted/azure-core/step06.md | 0 .../docs}/getstarted/azure-core/step07.md | 0 .../docs}/getstarted/azure-core/step08.md | 0 .../docs}/getstarted/azure-core/step09.md | 0 .../docs}/getstarted/azure-core/step10.md | 0 .../docs}/getstarted/azure-core/step11.md | 0 .../docs}/getstarted/azure-core/step12.md | 0 .../azure-resource-manager/step00.md | 0 .../azure-resource-manager/step01.md | 0 .../azure-resource-manager/step02.md | 0 .../azure-resource-manager/step03.md | 0 .../azure-resource-manager/step04.md | 0 .../azure-resource-manager/step05.md | 0 .../docs/docs}/getstarted/createproject.md | 0 .../docs/docs}/getstarted/installation.md | 0 .../docs/docs}/howtos/ARM/arm-rules.md | 0 .../howtos/ARM/change-provider-namespace.md | 0 .../docs}/howtos/ARM/resource-operations.md | 0 .../docs/docs}/howtos/ARM/resource-type.md | 0 .../howtos/Azure Core/content-negotiation.md | 0 .../Azure Core/long-running-operations.md | 0 .../howtos/Client Generation/00howtogen.mdx | 0 .../howtos/Client Generation/01setup.mdx | 0 .../howtos/Client Generation/02client.mdx | 0 .../howtos/Client Generation/03convenient.mdx | 0 .../howtos/Client Generation/04renaming.mdx | 0 .../howtos/Client Generation/05union.mdx | 0 .../howtos/Client Generation/06types.mdx | 0 .../howtos/Client Generation/07tcgcTypes.mdx | 0 .../Client Generation/08methodInputs.mdx | 0 .../howtos/Client Generation/09versioning.mdx | 0 .../10longRunningOperations.mdx | 0 .../docs}/howtos/Client Generation/11etag.mdx | 0 .../howtos/Client Generation/12multipart.mdx | 0 .../Generating with tsp-client/tsp_client.md | 0 .../howtos/rest-api-publish/_category_.json | 0 .../howtos/rest-api-publish/buildpipelines.md | 0 .../checking-in-api-specs-guide.md | 0 .../src/content/docs/docs}/intro.md | 0 .../azure-core/reference/data-types.md | 0 .../azure-core/reference/decorators.md | 0 .../libraries/azure-core/reference/index.mdx | 0 .../azure-core/reference/interfaces.md | 0 .../libraries/azure-core/reference/linter.md | 63 +++++++++++++++++++ .../azure-core/rules/auth-required.md | 0 .../azure-core/rules/bad-record-type.md | 0 .../azure-core/rules/casing-style.md | 0 .../rules/no-closed-literal-union.md | 0 .../libraries/azure-core/rules/no-enum.md | 0 .../azure-core/rules/no-generic-numeric.md | 0 .../rules/no-multiple-discriminator.md | 0 .../libraries/azure-core/rules/no-nullable.md | 0 .../libraries/azure-core/rules/no-openapi.md | 0 .../azure-core/rules/no-private-usage.md | 0 .../azure-core/rules/no-query-explode.md | 0 .../rules/no-string-discriminator.md | 0 .../rules/non-breaking-versioning.md | 0 .../rules/operation-missing-api-version.md | 0 .../azure-core/rules/prevent-format.md | 0 .../azure-core/rules/require-versioned.md | 0 .../rules/spread-discriminated-model.md | 0 .../azure-core/rules/use-standard-names.md | 0 .../rules/use-standard-operations.md | 0 .../azure-portal-core/reference/data-types.md | 0 .../azure-portal-core/reference/decorators.md | 0 .../azure-portal-core/reference/index.mdx | 0 .../reference/data-types.md | 21 ------- .../reference/decorators.md | 0 .../reference/index.mdx | 1 - .../reference/interfaces.md | 0 .../reference/linter.md | 0 .../rules/arm-no-record.md | 0 .../rules/arm-resource-invalid-action-verb.md | 0 .../rules/arm-resource-provisioning-state.md | 0 .../rules/delete-operation-response-codes.md | 0 .../rules/lro-location-header.md | 0 .../rules/missing-x-ms-identifiers.md | 0 .../rules/no-empty-model.md | 0 .../rules/post-operation-response-codes.md | 0 .../rules/put-operation-response-codes.md | 0 .../rules/resource-name-pattern.md | 0 .../rules/unsupported-type.md | 0 .../reference/decorators.md | 0 .../reference/index.mdx | 0 .../docs}/migrate-swagger/01-get-started.md | 0 .../docs}/migrate-swagger/_category_.json | 0 .../checklists/_category_.json | 0 .../checklists/migrate-arm-tips.md | 0 .../checklists/migrate-dp-tips.md | 0 .../docs}/migrate-swagger/faq/_category_.json | 0 .../migrate-swagger/faq/breakingchange.md | 0 .../docs}/migrate-swagger/faq/lintdiff.md | 0 .../migrate-swagger/faq/x-ms-examples.md | 0 .../content/docs/docs}/reference/arm/index.md | 0 .../docs/docs}/reference/azure-style-guide.md | 0 .../docs/docs}/reference/azure.core/index.md | 0 .../release-notes/cadl-typespec-migration.md | 0 .../docs}/release-notes/release-2022-07-08.md | 0 .../docs}/release-notes/release-2022-08-10.md | 0 .../docs}/release-notes/release-2022-09-07.md | 0 .../docs}/release-notes/release-2022-10-12.md | 0 .../docs}/release-notes/release-2022-11-11.md | 0 .../docs}/release-notes/release-2022-12-07.md | 0 .../docs}/release-notes/release-2023-01-12.md | 0 .../docs}/release-notes/release-2023-02-07.md | 0 .../docs}/release-notes/release-2023-03-13.md | 0 .../docs}/release-notes/release-2023-04-11.md | 0 .../docs}/release-notes/release-2023-05-10.md | 0 .../docs}/release-notes/release-2023-06-06.md | 0 .../docs}/release-notes/release-2023-07-11.md | 0 .../docs}/release-notes/release-2023-08-08.md | 0 .../docs}/release-notes/release-2023-09-12.md | 0 .../docs}/release-notes/release-2023-10-11.md | 0 .../docs}/release-notes/release-2023-11-07.md | 0 .../docs}/release-notes/release-2023-12-06.md | 0 .../docs}/release-notes/release-2024-01-23.md | 0 .../docs}/release-notes/release-2024-02-06.md | 0 .../docs}/release-notes/release-2024-03-05.md | 0 .../docs}/release-notes/release-2024-04-02.md | 0 .../docs}/release-notes/release-2024-05-07.md | 0 .../docs}/release-notes/release-2024-06-11.md | 0 .../docs}/release-notes/release-2024-07-16.md | 0 .../docs}/release-notes/release-2024-08-06.md | 0 .../docs}/release-notes/release-2024-09-10.md | 0 .../docs}/release-notes/release-2024-10-09.md | 0 .../arm-proxy-operations-error.md | 0 .../docs}/troubleshoot/enum-not-extensible.md | 0 .../content/docs/docs}/troubleshoot/sdl.md | 0 .../troubleshoot/status-read-only-error.md | 0 .../docs}/troubleshoot/suppresswarnings.md | 0 .../docs}/troubleshoot/troubleshoot_template | 0 .../versioning_operation_template_changes.md | 0 .../docs/docs}/typespec-getting-started.md | 0 164 files changed, 101 insertions(+), 98 deletions(-) create mode 100644 .chronus/changes/move-docs-2024-10-4-23-37-28.md delete mode 100644 docs/libraries/azure-core/reference/linter.md create mode 100644 docs/readme.md delete mode 100644 website/.gitignore rename {docs => website/src/content/docs/docs}/emitters/typespec-autorest-canonical/reference/emitter.md (100%) rename {docs => website/src/content/docs/docs}/emitters/typespec-autorest-canonical/reference/index.mdx (100%) rename {docs => website/src/content/docs/docs}/emitters/typespec-autorest/index.md (100%) rename {docs => website/src/content/docs/docs}/emitters/typespec-autorest/reference/decorators.md (100%) rename {docs => website/src/content/docs/docs}/emitters/typespec-autorest/reference/emitter.md (100%) rename {docs => website/src/content/docs/docs}/emitters/typespec-autorest/reference/index.mdx (100%) rename {docs => website/src/content/docs/docs}/emitters/typespec-azure-rulesets/reference/index.mdx (100%) rename {docs => website/src/content/docs/docs}/emitters/typespec-azure-rulesets/reference/linter.md (100%) rename {docs => website/src/content/docs/docs}/emitters/typespec-csharp/index.md (100%) rename {docs => website/src/content/docs/docs}/emitters/typespec-service-csharp/reference/emitter.md (100%) rename {docs => website/src/content/docs/docs}/emitters/typespec-service-csharp/reference/index.mdx (100%) rename {docs => website/src/content/docs/docs}/getstarted/azure-core/step01.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/azure-core/step02.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/azure-core/step03.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/azure-core/step04.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/azure-core/step05.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/azure-core/step06.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/azure-core/step07.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/azure-core/step08.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/azure-core/step09.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/azure-core/step10.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/azure-core/step11.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/azure-core/step12.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/azure-resource-manager/step00.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/azure-resource-manager/step01.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/azure-resource-manager/step02.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/azure-resource-manager/step03.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/azure-resource-manager/step04.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/azure-resource-manager/step05.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/createproject.md (100%) rename {docs => website/src/content/docs/docs}/getstarted/installation.md (100%) rename {docs => website/src/content/docs/docs}/howtos/ARM/arm-rules.md (100%) rename {docs => website/src/content/docs/docs}/howtos/ARM/change-provider-namespace.md (100%) rename {docs => website/src/content/docs/docs}/howtos/ARM/resource-operations.md (100%) rename {docs => website/src/content/docs/docs}/howtos/ARM/resource-type.md (100%) rename {docs => website/src/content/docs/docs}/howtos/Azure Core/content-negotiation.md (100%) rename {docs => website/src/content/docs/docs}/howtos/Azure Core/long-running-operations.md (100%) rename {docs => website/src/content/docs/docs}/howtos/Client Generation/00howtogen.mdx (100%) rename {docs => website/src/content/docs/docs}/howtos/Client Generation/01setup.mdx (100%) rename {docs => website/src/content/docs/docs}/howtos/Client Generation/02client.mdx (100%) rename {docs => website/src/content/docs/docs}/howtos/Client Generation/03convenient.mdx (100%) rename {docs => website/src/content/docs/docs}/howtos/Client Generation/04renaming.mdx (100%) rename {docs => website/src/content/docs/docs}/howtos/Client Generation/05union.mdx (100%) rename {docs => website/src/content/docs/docs}/howtos/Client Generation/06types.mdx (100%) rename {docs => website/src/content/docs/docs}/howtos/Client Generation/07tcgcTypes.mdx (100%) rename {docs => website/src/content/docs/docs}/howtos/Client Generation/08methodInputs.mdx (100%) rename {docs => website/src/content/docs/docs}/howtos/Client Generation/09versioning.mdx (100%) rename {docs => website/src/content/docs/docs}/howtos/Client Generation/10longRunningOperations.mdx (100%) rename {docs => website/src/content/docs/docs}/howtos/Client Generation/11etag.mdx (100%) rename {docs => website/src/content/docs/docs}/howtos/Client Generation/12multipart.mdx (100%) rename {docs => website/src/content/docs/docs}/howtos/Generating with tsp-client/tsp_client.md (100%) rename {docs => website/src/content/docs/docs}/howtos/rest-api-publish/_category_.json (100%) rename {docs => website/src/content/docs/docs}/howtos/rest-api-publish/buildpipelines.md (100%) rename {docs => website/src/content/docs/docs}/howtos/rest-api-publish/checking-in-api-specs-guide.md (100%) rename {docs => website/src/content/docs/docs}/intro.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/reference/data-types.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/reference/decorators.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/reference/index.mdx (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/reference/interfaces.md (100%) create mode 100644 website/src/content/docs/docs/libraries/azure-core/reference/linter.md rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/auth-required.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/bad-record-type.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/casing-style.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/no-closed-literal-union.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/no-enum.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/no-generic-numeric.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/no-multiple-discriminator.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/no-nullable.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/no-openapi.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/no-private-usage.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/no-query-explode.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/no-string-discriminator.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/non-breaking-versioning.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/operation-missing-api-version.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/prevent-format.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/require-versioned.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/spread-discriminated-model.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/use-standard-names.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-core/rules/use-standard-operations.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-portal-core/reference/data-types.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-portal-core/reference/decorators.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-portal-core/reference/index.mdx (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-resource-manager/reference/data-types.md (99%) rename {docs => website/src/content/docs/docs}/libraries/azure-resource-manager/reference/decorators.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-resource-manager/reference/index.mdx (99%) rename {docs => website/src/content/docs/docs}/libraries/azure-resource-manager/reference/interfaces.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-resource-manager/reference/linter.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-resource-manager/rules/arm-no-record.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-resource-manager/rules/arm-resource-invalid-action-verb.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-resource-manager/rules/arm-resource-provisioning-state.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-resource-manager/rules/delete-operation-response-codes.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-resource-manager/rules/lro-location-header.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-resource-manager/rules/missing-x-ms-identifiers.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-resource-manager/rules/no-empty-model.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-resource-manager/rules/post-operation-response-codes.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-resource-manager/rules/put-operation-response-codes.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-resource-manager/rules/resource-name-pattern.md (100%) rename {docs => website/src/content/docs/docs}/libraries/azure-resource-manager/rules/unsupported-type.md (100%) rename {docs => website/src/content/docs/docs}/libraries/typespec-client-generator-core/reference/decorators.md (100%) rename {docs => website/src/content/docs/docs}/libraries/typespec-client-generator-core/reference/index.mdx (100%) rename {docs => website/src/content/docs/docs}/migrate-swagger/01-get-started.md (100%) rename {docs => website/src/content/docs/docs}/migrate-swagger/_category_.json (100%) rename {docs => website/src/content/docs/docs}/migrate-swagger/checklists/_category_.json (100%) rename {docs => website/src/content/docs/docs}/migrate-swagger/checklists/migrate-arm-tips.md (100%) rename {docs => website/src/content/docs/docs}/migrate-swagger/checklists/migrate-dp-tips.md (100%) rename {docs => website/src/content/docs/docs}/migrate-swagger/faq/_category_.json (100%) rename {docs => website/src/content/docs/docs}/migrate-swagger/faq/breakingchange.md (100%) rename {docs => website/src/content/docs/docs}/migrate-swagger/faq/lintdiff.md (100%) rename {docs => website/src/content/docs/docs}/migrate-swagger/faq/x-ms-examples.md (100%) rename {docs => website/src/content/docs/docs}/reference/arm/index.md (100%) rename {docs => website/src/content/docs/docs}/reference/azure-style-guide.md (100%) rename {docs => website/src/content/docs/docs}/reference/azure.core/index.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/cadl-typespec-migration.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2022-07-08.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2022-08-10.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2022-09-07.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2022-10-12.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2022-11-11.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2022-12-07.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2023-01-12.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2023-02-07.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2023-03-13.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2023-04-11.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2023-05-10.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2023-06-06.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2023-07-11.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2023-08-08.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2023-09-12.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2023-10-11.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2023-11-07.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2023-12-06.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2024-01-23.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2024-02-06.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2024-03-05.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2024-04-02.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2024-05-07.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2024-06-11.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2024-07-16.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2024-08-06.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2024-09-10.md (100%) rename {docs => website/src/content/docs/docs}/release-notes/release-2024-10-09.md (100%) rename {docs => website/src/content/docs/docs}/troubleshoot/arm-proxy-operations-error.md (100%) rename {docs => website/src/content/docs/docs}/troubleshoot/enum-not-extensible.md (100%) rename {docs => website/src/content/docs/docs}/troubleshoot/sdl.md (100%) rename {docs => website/src/content/docs/docs}/troubleshoot/status-read-only-error.md (100%) rename {docs => website/src/content/docs/docs}/troubleshoot/suppresswarnings.md (100%) rename {docs => website/src/content/docs/docs}/troubleshoot/troubleshoot_template (100%) rename {docs => website/src/content/docs/docs}/troubleshoot/versioning_operation_template_changes.md (100%) rename {docs => website/src/content/docs/docs}/typespec-getting-started.md (100%) diff --git a/.chronus/changes/move-docs-2024-10-4-23-37-28.md b/.chronus/changes/move-docs-2024-10-4-23-37-28.md new file mode 100644 index 0000000000..c936970915 --- /dev/null +++ b/.chronus/changes/move-docs-2024-10-4-23-37-28.md @@ -0,0 +1,14 @@ +--- +# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking +changeKind: internal +packages: + - "@azure-tools/typespec-autorest-canonical" + - "@azure-tools/typespec-autorest" + - "@azure-tools/typespec-azure-core" + - "@azure-tools/typespec-azure-portal-core" + - "@azure-tools/typespec-azure-resource-manager" + - "@azure-tools/typespec-azure-rulesets" + - "@azure-tools/typespec-client-generator-core" +--- + +Move docs under website diff --git a/.gitignore b/.gitignore index 5137edf143..ca68f3c867 100644 --- a/.gitignore +++ b/.gitignore @@ -201,7 +201,7 @@ packages/samples/test/output/azure/templates-contoso/setup.* # JetBrains Rider .idea/ -docs/**/js-api/ +**/docs/**/js-api/ # vitest temporary files **/vitest.config.ts.timestamp* diff --git a/.vscode/launch.json b/.vscode/launch.json index 04b1ac5bb0..e29626c3ba 100644 --- a/.vscode/launch.json +++ b/.vscode/launch.json @@ -207,7 +207,7 @@ "doc", "${workspaceFolder}/packages/typespec-azure-resource-manager", "--enable-experimental", - "--output-dir=../../docs/libraries/azure-resource-manager/reference" + "--output-dir=../../website/src/content/docs/docs/libraries/azure-resource-manager/reference" ], "smartStep": true, "sourceMaps": true, diff --git a/docs/libraries/azure-core/reference/linter.md b/docs/libraries/azure-core/reference/linter.md deleted file mode 100644 index 7c28383131..0000000000 --- a/docs/libraries/azure-core/reference/linter.md +++ /dev/null @@ -1,63 +0,0 @@ ---- -title: "Linter usage" ---- - -## Usage - -Add the following in `tspconfig.yaml`: - -```yaml -linter: - extends: - - "@azure-tools/typespec-azure-core/all" -``` - -## RuleSets - -Available ruleSets: - -- `@azure-tools/typespec-azure-core/all` -- `@azure-tools/typespec-azure-core/canonical-versioning` - -## Rules - -| Name | Description | -| -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`@azure-tools/typespec-azure-core/operation-missing-api-version`](/libraries/azure-core/rules/operation-missing-api-version.md) | Operations need an api version parameter. | -| [`@azure-tools/typespec-azure-core/auth-required`](/libraries/azure-core/rules/auth-required.md) | Enforce service authentication. | -| `@azure-tools/typespec-azure-core/request-body-problem` | Request body should not be of raw array type. | -| `@azure-tools/typespec-azure-core/byos` | Use the BYOS pattern recommended for Azure Services. | -| [`@azure-tools/typespec-azure-core/casing-style`](/libraries/azure-core/rules/casing-style.md) | Ensure proper casing style. | -| `@azure-tools/typespec-azure-core/composition-over-inheritance` | Check that if a model is used in an operation and has derived models that it has a discriminator or recommend to use composition via spread or `is`. | -| `@azure-tools/typespec-azure-core/known-encoding` | Check for supported encodings. | -| `@azure-tools/typespec-azure-core/long-running-polling-operation-required` | Long-running operations should have a linked polling operation. | -| [`@azure-tools/typespec-azure-core/no-closed-literal-union`](/libraries/azure-core/rules/no-closed-literal-union.md) | Unions of literals should include the base scalar type to mark them as open enum. | -| [`@azure-tools/typespec-azure-core/no-enum`](/libraries/azure-core/rules/no-enum.md) | Azure services should not use enums. | -| `@azure-tools/typespec-azure-core/no-error-status-codes` | Recommend using the error response defined by Azure REST API guidelines. | -| `@azure-tools/typespec-azure-core/no-explicit-routes-resource-ops` | The @route decorator should not be used on standard resource operation signatures. | -| [`@azure-tools/typespec-azure-core/non-breaking-versioning`](/libraries/azure-core/rules/non-breaking-versioning.md) | Check that only backward compatible versioning change are done to a service. | -| [`@azure-tools/typespec-azure-core/no-generic-numeric`](/libraries/azure-core/rules/no-generic-numeric.md) | Don't use generic types. Use more specific types instead. | -| [`@azure-tools/typespec-azure-core/no-nullable`](/libraries/azure-core/rules/no-nullable.md) | Use `?` for optional properties. | -| `@azure-tools/typespec-azure-core/no-offsetdatetime` | Prefer using `utcDateTime` when representing a datetime unless an offset is necessary. | -| `@azure-tools/typespec-azure-core/no-response-body` | Ensure that the body is set correctly for the response type. | -| `@azure-tools/typespec-azure-core/no-rpc-path-params` | Operations defined using RpcOperation should not have path parameters. | -| `@azure-tools/typespec-azure-core/no-openapi` | Azure specs should not be using decorators from @typespec/openapi or @azure-tools/typespec-autorest | -| `@azure-tools/typespec-azure-core/prefer-csv-collection-format` | It is recommended to use "csv" for collection format of parameters. | -| [`@azure-tools/typespec-azure-core/no-format`](/libraries/azure-core/rules/prevent-format.md) | Azure services should not use the `@format` decorator. | -| `@azure-tools/typespec-azure-core/no-multiple-discriminator` | Classes should have at most one discriminator. | -| `@azure-tools/typespec-azure-core/no-rest-library-interfaces` | Resource interfaces from the TypeSpec.Rest.Resource library are incompatible with Azure.Core. | -| `@azure-tools/typespec-azure-core/no-unknown` | Azure services must not have properties of type `unknown`. | -| `@azure-tools/typespec-azure-core/property-name-conflict` | Avoid naming conflicts between a property and a model of the same name. | -| [`@azure-tools/typespec-azure-core/bad-record-type`](/libraries/azure-core/rules/bad-record-type.md) | Identify bad record definitions. | -| `@azure-tools/typespec-azure-core/documentation-required` | Require documentation over enums, models, and operations. | -| `@azure-tools/typespec-azure-core/key-visibility-required` | Key properties need to have an explicit visibility setting. | -| `@azure-tools/typespec-azure-core/response-schema-problem` | Warn about operations having multiple non-error response schemas. | -| `@azure-tools/typespec-azure-core/rpc-operation-request-body` | Warning for RPC body problems. | -| [`@azure-tools/typespec-azure-core/spread-discriminated-model`](/libraries/azure-core/rules/spread-discriminated-model.md) | Check a model with a discriminator has not been used in composition. | -| `@azure-tools/typespec-azure-core/use-standard-names` | Use recommended names for operations. | -| [`@azure-tools/typespec-azure-core/use-standard-operations`](/libraries/azure-core/rules/use-standard-operations.md) | Operations should be defined using a signature from the Azure.Core namespace. | -| [`@azure-tools/typespec-azure-core/no-string-discriminator`](/libraries/azure-core/rules/no-string-discriminator.md) | Azure services discriminated models should define the discriminated property as an extensible union. | -| [`@azure-tools/typespec-azure-core/require-versioned`](/libraries/azure-core/rules/require-versioned.md) | Azure services should use the versioning library. | -| `@azure-tools/typespec-azure-core/friendly-name` | Ensures that @friendlyName is used as intended. | -| [`@azure-tools/typespec-azure-core/no-private-usage`](/libraries/azure-core/rules/no-private-usage.md) | Verify that elements inside Private namespace are not referenced. | -| [`@azure-tools/typespec-azure-core/no-query-explode`](/libraries/azure-core/rules/no-query-explode.md) | It is recommended to serialize query parameter without explode: true | diff --git a/docs/readme.md b/docs/readme.md new file mode 100644 index 0000000000..2ffcd42d80 --- /dev/null +++ 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/packages/typespec-autorest-canonical/package.json b/packages/typespec-autorest-canonical/package.json index e62ecc9462..8dabfe8b5f 100644 --- a/packages/typespec-autorest-canonical/package.json +++ b/packages/typespec-autorest-canonical/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/emitters/typespec-autorest-canonical/reference" + "regen-docs": "tspd doc . --enable-experimental --output-dir ../../website/src/content/docs/docs/emitters/typespec-autorest-canonical/reference" }, "files": [ "lib/*.tsp", diff --git a/packages/typespec-autorest/package.json b/packages/typespec-autorest/package.json index 7e352c24c6..5b09c1c1bd 100644 --- a/packages/typespec-autorest/package.json +++ b/packages/typespec-autorest/package.json @@ -46,7 +46,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/typespec-autorest/reference" + "regen-docs": "tspd doc . --enable-experimental --output-dir ../../website/src/content/docs/docs/emitters/typespec-autorest/reference" }, "files": [ "lib/*.tsp", diff --git a/packages/typespec-azure-core/package.json b/packages/typespec-azure-core/package.json index eb6977a752..7fc76942f8 100644 --- a/packages/typespec-azure-core/package.json +++ b/packages/typespec-azure-core/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/azure-core/reference" + "regen-docs": "tspd doc . --enable-experimental --output-dir ../../website/src/content/docs/docs/libraries/azure-core/reference" }, "files": [ "lib/*.tsp", diff --git a/packages/typespec-azure-portal-core/package.json b/packages/typespec-azure-portal-core/package.json index a58c8342f3..fed85ce881 100644 --- a/packages/typespec-azure-portal-core/package.json +++ b/packages/typespec-azure-portal-core/package.json @@ -17,7 +17,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/azure-portal-core/reference" + "regen-docs": "tspd doc . --enable-experimental --output-dir ../../website/src/content/docs/docs/libraries/azure-portal-core/reference" }, "keywords": [ "Azure", diff --git a/packages/typespec-azure-resource-manager/package.json b/packages/typespec-azure-resource-manager/package.json index 6ebf391f88..494db386fc 100644 --- a/packages/typespec-azure-resource-manager/package.json +++ b/packages/typespec-azure-resource-manager/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/azure-resource-manager/reference" + "regen-docs": "tspd doc . --enable-experimental --output-dir ../../website/src/content/docs/docs/libraries/azure-resource-manager/reference" }, "files": [ "lib/**/*.tsp", diff --git a/packages/typespec-azure-rulesets/package.json b/packages/typespec-azure-rulesets/package.json index 353ef3c4d5..9e05ae625d 100644 --- a/packages/typespec-azure-rulesets/package.json +++ b/packages/typespec-azure-rulesets/package.json @@ -36,7 +36,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/typespec-azure-rulesets/reference" + "regen-docs": "tspd doc . --enable-experimental --output-dir ../../website/src/content/docs/docs/emitters/typespec-azure-rulesets/reference" }, "files": [ "dist/**", diff --git a/packages/typespec-client-generator-core/package.json b/packages/typespec-client-generator-core/package.json index d11465d3f3..4f1a22af29 100644 --- a/packages/typespec-client-generator-core/package.json +++ b/packages/typespec-client-generator-core/package.json @@ -47,7 +47,7 @@ "test:e2e": "vitest run --config ./vitest.config.e2e.ts", "lint": "eslint . --max-warnings=0", "lint:fix": "eslint . --fix ", - "regen-docs": "tspd doc . --enable-experimental --output-dir ../../docs/libraries/typespec-client-generator-core/reference" + "regen-docs": "tspd doc . --enable-experimental --output-dir ../../website/src/content/docs/docs/libraries/typespec-client-generator-core/reference" }, "files": [ "lib/*.tsp", diff --git a/packages/typespec-service-csharp/package.json b/packages/typespec-service-csharp/package.json index b25d5718e3..5dd37e4b39 100644 --- a/packages/typespec-service-csharp/package.json +++ b/packages/typespec-service-csharp/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/typespec-service-csharp/reference" + "regen-docs": "tspd doc . --enable-experimental --output-dir ../../website/src/content/docs/docs/emitters/typespec-service-csharp/reference" }, "files": [ "lib/*.tsp", diff --git a/website/.gitignore b/website/.gitignore deleted file mode 100644 index 4ea94ee81f..0000000000 --- a/website/.gitignore +++ /dev/null @@ -1 +0,0 @@ -src/content/docs/docs/ diff --git a/website/package.json b/website/package.json index 097f6378fc..5e5880bf53 100644 --- a/website/package.json +++ b/website/package.json @@ -4,10 +4,9 @@ "private": true, "version": "0.0.1", "scripts": { - "copy": "cp -r ../docs/. ./src/content/docs/docs", "dev": "astro dev", "start": "astro dev", - "build": "pnpm copy && tsx ./.scripts/build.ts", + "build": "tsx ./.scripts/build.ts", "build:web": "pnpm regen-all-packages-docs && astro check --minimumFailingSeverity warning && astro build", "preview": "astro preview", "regen-all-packages-docs": "pnpm -w --filter \"@azure-tools/typespec-azure-website...\" --filter \"!@typespec/monorepo\" --filter \"!@azure-tools/typespec-azure-monorepo\" run regen-docs", diff --git a/docs/emitters/typespec-autorest-canonical/reference/emitter.md b/website/src/content/docs/docs/emitters/typespec-autorest-canonical/reference/emitter.md similarity index 100% rename from docs/emitters/typespec-autorest-canonical/reference/emitter.md rename to website/src/content/docs/docs/emitters/typespec-autorest-canonical/reference/emitter.md diff --git a/docs/emitters/typespec-autorest-canonical/reference/index.mdx b/website/src/content/docs/docs/emitters/typespec-autorest-canonical/reference/index.mdx similarity index 100% rename from docs/emitters/typespec-autorest-canonical/reference/index.mdx rename to website/src/content/docs/docs/emitters/typespec-autorest-canonical/reference/index.mdx diff --git a/docs/emitters/typespec-autorest/index.md b/website/src/content/docs/docs/emitters/typespec-autorest/index.md similarity index 100% rename from docs/emitters/typespec-autorest/index.md rename to website/src/content/docs/docs/emitters/typespec-autorest/index.md diff --git a/docs/emitters/typespec-autorest/reference/decorators.md b/website/src/content/docs/docs/emitters/typespec-autorest/reference/decorators.md similarity index 100% rename from docs/emitters/typespec-autorest/reference/decorators.md rename to website/src/content/docs/docs/emitters/typespec-autorest/reference/decorators.md diff --git a/docs/emitters/typespec-autorest/reference/emitter.md b/website/src/content/docs/docs/emitters/typespec-autorest/reference/emitter.md similarity index 100% rename from docs/emitters/typespec-autorest/reference/emitter.md rename to website/src/content/docs/docs/emitters/typespec-autorest/reference/emitter.md diff --git a/docs/emitters/typespec-autorest/reference/index.mdx b/website/src/content/docs/docs/emitters/typespec-autorest/reference/index.mdx similarity index 100% rename from docs/emitters/typespec-autorest/reference/index.mdx rename to website/src/content/docs/docs/emitters/typespec-autorest/reference/index.mdx diff --git a/docs/emitters/typespec-azure-rulesets/reference/index.mdx b/website/src/content/docs/docs/emitters/typespec-azure-rulesets/reference/index.mdx similarity index 100% rename from docs/emitters/typespec-azure-rulesets/reference/index.mdx rename to website/src/content/docs/docs/emitters/typespec-azure-rulesets/reference/index.mdx diff --git a/docs/emitters/typespec-azure-rulesets/reference/linter.md b/website/src/content/docs/docs/emitters/typespec-azure-rulesets/reference/linter.md similarity index 100% rename from docs/emitters/typespec-azure-rulesets/reference/linter.md rename to website/src/content/docs/docs/emitters/typespec-azure-rulesets/reference/linter.md diff --git a/docs/emitters/typespec-csharp/index.md b/website/src/content/docs/docs/emitters/typespec-csharp/index.md similarity index 100% rename from docs/emitters/typespec-csharp/index.md rename to website/src/content/docs/docs/emitters/typespec-csharp/index.md diff --git a/docs/emitters/typespec-service-csharp/reference/emitter.md b/website/src/content/docs/docs/emitters/typespec-service-csharp/reference/emitter.md similarity index 100% rename from docs/emitters/typespec-service-csharp/reference/emitter.md rename to website/src/content/docs/docs/emitters/typespec-service-csharp/reference/emitter.md diff --git a/docs/emitters/typespec-service-csharp/reference/index.mdx b/website/src/content/docs/docs/emitters/typespec-service-csharp/reference/index.mdx similarity index 100% rename from docs/emitters/typespec-service-csharp/reference/index.mdx rename to website/src/content/docs/docs/emitters/typespec-service-csharp/reference/index.mdx diff --git a/docs/getstarted/azure-core/step01.md b/website/src/content/docs/docs/getstarted/azure-core/step01.md similarity index 100% rename from docs/getstarted/azure-core/step01.md rename to website/src/content/docs/docs/getstarted/azure-core/step01.md diff --git a/docs/getstarted/azure-core/step02.md b/website/src/content/docs/docs/getstarted/azure-core/step02.md similarity index 100% rename from docs/getstarted/azure-core/step02.md rename to website/src/content/docs/docs/getstarted/azure-core/step02.md diff --git a/docs/getstarted/azure-core/step03.md b/website/src/content/docs/docs/getstarted/azure-core/step03.md similarity index 100% rename from docs/getstarted/azure-core/step03.md rename to website/src/content/docs/docs/getstarted/azure-core/step03.md diff --git a/docs/getstarted/azure-core/step04.md b/website/src/content/docs/docs/getstarted/azure-core/step04.md similarity index 100% rename from docs/getstarted/azure-core/step04.md rename to website/src/content/docs/docs/getstarted/azure-core/step04.md diff --git a/docs/getstarted/azure-core/step05.md b/website/src/content/docs/docs/getstarted/azure-core/step05.md similarity index 100% rename from docs/getstarted/azure-core/step05.md rename to website/src/content/docs/docs/getstarted/azure-core/step05.md diff --git a/docs/getstarted/azure-core/step06.md b/website/src/content/docs/docs/getstarted/azure-core/step06.md similarity index 100% rename from docs/getstarted/azure-core/step06.md rename to website/src/content/docs/docs/getstarted/azure-core/step06.md diff --git a/docs/getstarted/azure-core/step07.md b/website/src/content/docs/docs/getstarted/azure-core/step07.md similarity index 100% rename from docs/getstarted/azure-core/step07.md rename to website/src/content/docs/docs/getstarted/azure-core/step07.md diff --git a/docs/getstarted/azure-core/step08.md b/website/src/content/docs/docs/getstarted/azure-core/step08.md similarity index 100% rename from docs/getstarted/azure-core/step08.md rename to website/src/content/docs/docs/getstarted/azure-core/step08.md diff --git a/docs/getstarted/azure-core/step09.md b/website/src/content/docs/docs/getstarted/azure-core/step09.md similarity index 100% rename from docs/getstarted/azure-core/step09.md rename to website/src/content/docs/docs/getstarted/azure-core/step09.md diff --git a/docs/getstarted/azure-core/step10.md b/website/src/content/docs/docs/getstarted/azure-core/step10.md similarity index 100% rename from docs/getstarted/azure-core/step10.md rename to website/src/content/docs/docs/getstarted/azure-core/step10.md diff --git a/docs/getstarted/azure-core/step11.md b/website/src/content/docs/docs/getstarted/azure-core/step11.md similarity index 100% rename from docs/getstarted/azure-core/step11.md rename to website/src/content/docs/docs/getstarted/azure-core/step11.md diff --git a/docs/getstarted/azure-core/step12.md b/website/src/content/docs/docs/getstarted/azure-core/step12.md similarity index 100% rename from docs/getstarted/azure-core/step12.md rename to website/src/content/docs/docs/getstarted/azure-core/step12.md diff --git a/docs/getstarted/azure-resource-manager/step00.md b/website/src/content/docs/docs/getstarted/azure-resource-manager/step00.md similarity index 100% rename from docs/getstarted/azure-resource-manager/step00.md rename to website/src/content/docs/docs/getstarted/azure-resource-manager/step00.md diff --git a/docs/getstarted/azure-resource-manager/step01.md b/website/src/content/docs/docs/getstarted/azure-resource-manager/step01.md similarity index 100% rename from docs/getstarted/azure-resource-manager/step01.md rename to website/src/content/docs/docs/getstarted/azure-resource-manager/step01.md diff --git a/docs/getstarted/azure-resource-manager/step02.md b/website/src/content/docs/docs/getstarted/azure-resource-manager/step02.md similarity index 100% rename from docs/getstarted/azure-resource-manager/step02.md rename to website/src/content/docs/docs/getstarted/azure-resource-manager/step02.md diff --git a/docs/getstarted/azure-resource-manager/step03.md b/website/src/content/docs/docs/getstarted/azure-resource-manager/step03.md similarity index 100% rename from docs/getstarted/azure-resource-manager/step03.md rename to website/src/content/docs/docs/getstarted/azure-resource-manager/step03.md diff --git a/docs/getstarted/azure-resource-manager/step04.md b/website/src/content/docs/docs/getstarted/azure-resource-manager/step04.md similarity index 100% rename from docs/getstarted/azure-resource-manager/step04.md rename to website/src/content/docs/docs/getstarted/azure-resource-manager/step04.md diff --git a/docs/getstarted/azure-resource-manager/step05.md b/website/src/content/docs/docs/getstarted/azure-resource-manager/step05.md similarity index 100% rename from docs/getstarted/azure-resource-manager/step05.md rename to website/src/content/docs/docs/getstarted/azure-resource-manager/step05.md diff --git a/docs/getstarted/createproject.md b/website/src/content/docs/docs/getstarted/createproject.md similarity index 100% rename from docs/getstarted/createproject.md rename to website/src/content/docs/docs/getstarted/createproject.md diff --git a/docs/getstarted/installation.md b/website/src/content/docs/docs/getstarted/installation.md similarity index 100% rename from docs/getstarted/installation.md rename to website/src/content/docs/docs/getstarted/installation.md diff --git a/docs/howtos/ARM/arm-rules.md b/website/src/content/docs/docs/howtos/ARM/arm-rules.md similarity index 100% rename from docs/howtos/ARM/arm-rules.md rename to website/src/content/docs/docs/howtos/ARM/arm-rules.md diff --git a/docs/howtos/ARM/change-provider-namespace.md b/website/src/content/docs/docs/howtos/ARM/change-provider-namespace.md similarity index 100% rename from docs/howtos/ARM/change-provider-namespace.md rename to website/src/content/docs/docs/howtos/ARM/change-provider-namespace.md diff --git a/docs/howtos/ARM/resource-operations.md b/website/src/content/docs/docs/howtos/ARM/resource-operations.md similarity index 100% rename from docs/howtos/ARM/resource-operations.md rename to website/src/content/docs/docs/howtos/ARM/resource-operations.md diff --git a/docs/howtos/ARM/resource-type.md b/website/src/content/docs/docs/howtos/ARM/resource-type.md similarity index 100% rename from docs/howtos/ARM/resource-type.md rename to website/src/content/docs/docs/howtos/ARM/resource-type.md diff --git a/docs/howtos/Azure Core/content-negotiation.md b/website/src/content/docs/docs/howtos/Azure Core/content-negotiation.md similarity index 100% rename from docs/howtos/Azure Core/content-negotiation.md rename to website/src/content/docs/docs/howtos/Azure Core/content-negotiation.md diff --git a/docs/howtos/Azure Core/long-running-operations.md b/website/src/content/docs/docs/howtos/Azure Core/long-running-operations.md similarity index 100% rename from docs/howtos/Azure Core/long-running-operations.md rename to website/src/content/docs/docs/howtos/Azure Core/long-running-operations.md diff --git a/docs/howtos/Client Generation/00howtogen.mdx b/website/src/content/docs/docs/howtos/Client Generation/00howtogen.mdx similarity index 100% rename from docs/howtos/Client Generation/00howtogen.mdx rename to website/src/content/docs/docs/howtos/Client Generation/00howtogen.mdx diff --git a/docs/howtos/Client Generation/01setup.mdx b/website/src/content/docs/docs/howtos/Client Generation/01setup.mdx similarity index 100% rename from docs/howtos/Client Generation/01setup.mdx rename to website/src/content/docs/docs/howtos/Client Generation/01setup.mdx diff --git a/docs/howtos/Client Generation/02client.mdx b/website/src/content/docs/docs/howtos/Client Generation/02client.mdx similarity index 100% rename from docs/howtos/Client Generation/02client.mdx rename to website/src/content/docs/docs/howtos/Client Generation/02client.mdx diff --git a/docs/howtos/Client Generation/03convenient.mdx b/website/src/content/docs/docs/howtos/Client Generation/03convenient.mdx similarity index 100% rename from docs/howtos/Client Generation/03convenient.mdx rename to website/src/content/docs/docs/howtos/Client Generation/03convenient.mdx diff --git a/docs/howtos/Client Generation/04renaming.mdx b/website/src/content/docs/docs/howtos/Client Generation/04renaming.mdx similarity index 100% rename from docs/howtos/Client Generation/04renaming.mdx rename to website/src/content/docs/docs/howtos/Client Generation/04renaming.mdx diff --git a/docs/howtos/Client Generation/05union.mdx b/website/src/content/docs/docs/howtos/Client Generation/05union.mdx similarity index 100% rename from docs/howtos/Client Generation/05union.mdx rename to website/src/content/docs/docs/howtos/Client Generation/05union.mdx diff --git a/docs/howtos/Client Generation/06types.mdx b/website/src/content/docs/docs/howtos/Client Generation/06types.mdx similarity index 100% rename from docs/howtos/Client Generation/06types.mdx rename to website/src/content/docs/docs/howtos/Client Generation/06types.mdx diff --git a/docs/howtos/Client Generation/07tcgcTypes.mdx b/website/src/content/docs/docs/howtos/Client Generation/07tcgcTypes.mdx similarity index 100% rename from docs/howtos/Client Generation/07tcgcTypes.mdx rename to website/src/content/docs/docs/howtos/Client Generation/07tcgcTypes.mdx diff --git a/docs/howtos/Client Generation/08methodInputs.mdx b/website/src/content/docs/docs/howtos/Client Generation/08methodInputs.mdx similarity index 100% rename from docs/howtos/Client Generation/08methodInputs.mdx rename to website/src/content/docs/docs/howtos/Client Generation/08methodInputs.mdx diff --git a/docs/howtos/Client Generation/09versioning.mdx b/website/src/content/docs/docs/howtos/Client Generation/09versioning.mdx similarity index 100% rename from docs/howtos/Client Generation/09versioning.mdx rename to website/src/content/docs/docs/howtos/Client Generation/09versioning.mdx diff --git a/docs/howtos/Client Generation/10longRunningOperations.mdx b/website/src/content/docs/docs/howtos/Client Generation/10longRunningOperations.mdx similarity index 100% rename from docs/howtos/Client Generation/10longRunningOperations.mdx rename to website/src/content/docs/docs/howtos/Client Generation/10longRunningOperations.mdx diff --git a/docs/howtos/Client Generation/11etag.mdx b/website/src/content/docs/docs/howtos/Client Generation/11etag.mdx similarity index 100% rename from docs/howtos/Client Generation/11etag.mdx rename to website/src/content/docs/docs/howtos/Client Generation/11etag.mdx diff --git a/docs/howtos/Client Generation/12multipart.mdx b/website/src/content/docs/docs/howtos/Client Generation/12multipart.mdx similarity index 100% rename from docs/howtos/Client Generation/12multipart.mdx rename to website/src/content/docs/docs/howtos/Client Generation/12multipart.mdx diff --git a/docs/howtos/Generating with tsp-client/tsp_client.md b/website/src/content/docs/docs/howtos/Generating with tsp-client/tsp_client.md similarity index 100% rename from docs/howtos/Generating with tsp-client/tsp_client.md rename to website/src/content/docs/docs/howtos/Generating with tsp-client/tsp_client.md diff --git a/docs/howtos/rest-api-publish/_category_.json b/website/src/content/docs/docs/howtos/rest-api-publish/_category_.json similarity index 100% rename from docs/howtos/rest-api-publish/_category_.json rename to website/src/content/docs/docs/howtos/rest-api-publish/_category_.json diff --git a/docs/howtos/rest-api-publish/buildpipelines.md b/website/src/content/docs/docs/howtos/rest-api-publish/buildpipelines.md similarity index 100% rename from docs/howtos/rest-api-publish/buildpipelines.md rename to website/src/content/docs/docs/howtos/rest-api-publish/buildpipelines.md diff --git a/docs/howtos/rest-api-publish/checking-in-api-specs-guide.md b/website/src/content/docs/docs/howtos/rest-api-publish/checking-in-api-specs-guide.md similarity index 100% rename from docs/howtos/rest-api-publish/checking-in-api-specs-guide.md rename to website/src/content/docs/docs/howtos/rest-api-publish/checking-in-api-specs-guide.md diff --git a/docs/intro.md b/website/src/content/docs/docs/intro.md similarity index 100% rename from docs/intro.md rename to website/src/content/docs/docs/intro.md diff --git a/docs/libraries/azure-core/reference/data-types.md b/website/src/content/docs/docs/libraries/azure-core/reference/data-types.md similarity index 100% rename from docs/libraries/azure-core/reference/data-types.md rename to website/src/content/docs/docs/libraries/azure-core/reference/data-types.md diff --git a/docs/libraries/azure-core/reference/decorators.md b/website/src/content/docs/docs/libraries/azure-core/reference/decorators.md similarity index 100% rename from docs/libraries/azure-core/reference/decorators.md rename to website/src/content/docs/docs/libraries/azure-core/reference/decorators.md diff --git a/docs/libraries/azure-core/reference/index.mdx b/website/src/content/docs/docs/libraries/azure-core/reference/index.mdx similarity index 100% rename from docs/libraries/azure-core/reference/index.mdx rename to website/src/content/docs/docs/libraries/azure-core/reference/index.mdx diff --git a/docs/libraries/azure-core/reference/interfaces.md b/website/src/content/docs/docs/libraries/azure-core/reference/interfaces.md similarity index 100% rename from docs/libraries/azure-core/reference/interfaces.md rename to website/src/content/docs/docs/libraries/azure-core/reference/interfaces.md diff --git a/website/src/content/docs/docs/libraries/azure-core/reference/linter.md b/website/src/content/docs/docs/libraries/azure-core/reference/linter.md new file mode 100644 index 0000000000..ed51534252 --- /dev/null +++ b/website/src/content/docs/docs/libraries/azure-core/reference/linter.md @@ -0,0 +1,63 @@ +--- +title: "Linter usage" +--- + +## Usage + +Add the following in `tspconfig.yaml`: + +```yaml +linter: + extends: + - "@azure-tools/typespec-azure-core/all" +``` + +## RuleSets + +Available ruleSets: + +- `@azure-tools/typespec-azure-core/all` +- `@azure-tools/typespec-azure-core/canonical-versioning` + +## Rules + +| Name | Description | +| -------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | +| `@azure-tools/typespec-azure-core/operation-missing-api-version` | Operations need an api version parameter. | +| `@azure-tools/typespec-azure-core/auth-required` | Enforce service authentication. | +| `@azure-tools/typespec-azure-core/request-body-problem` | Request body should not be of raw array type. | +| `@azure-tools/typespec-azure-core/byos` | Use the BYOS pattern recommended for Azure Services. | +| `@azure-tools/typespec-azure-core/casing-style` | Ensure proper casing style. | +| `@azure-tools/typespec-azure-core/composition-over-inheritance` | Check that if a model is used in an operation and has derived models that it has a discriminator or recommend to use composition via spread or `is`. | +| `@azure-tools/typespec-azure-core/known-encoding` | Check for supported encodings. | +| `@azure-tools/typespec-azure-core/long-running-polling-operation-required` | Long-running operations should have a linked polling operation. | +| [`@azure-tools/typespec-azure-core/no-closed-literal-union`](/libraries/azure-core/rules/no-closed-literal-union.md) | Unions of literals should include the base scalar type to mark them as open enum. | +| [`@azure-tools/typespec-azure-core/no-enum`](/libraries/azure-core/rules/no-enum.md) | Azure services should not use enums. | +| `@azure-tools/typespec-azure-core/no-error-status-codes` | Recommend using the error response defined by Azure REST API guidelines. | +| `@azure-tools/typespec-azure-core/no-explicit-routes-resource-ops` | The @route decorator should not be used on standard resource operation signatures. | +| [`@azure-tools/typespec-azure-core/non-breaking-versioning`](/libraries/azure-core/rules/non-breaking-versioning.md) | Check that only backward compatible versioning change are done to a service. | +| [`@azure-tools/typespec-azure-core/no-generic-numeric`](/libraries/azure-core/rules/no-generic-numeric.md) | Don't use generic types. Use more specific types instead. | +| [`@azure-tools/typespec-azure-core/no-nullable`](/libraries/azure-core/rules/no-nullable.md) | Use `?` for optional properties. | +| `@azure-tools/typespec-azure-core/no-offsetdatetime` | Prefer using `utcDateTime` when representing a datetime unless an offset is necessary. | +| `@azure-tools/typespec-azure-core/no-response-body` | Ensure that the body is set correctly for the response type. | +| `@azure-tools/typespec-azure-core/no-rpc-path-params` | Operations defined using RpcOperation should not have path parameters. | +| `@azure-tools/typespec-azure-core/no-openapi` | Azure specs should not be using decorators from @typespec/openapi or @azure-tools/typespec-autorest | +| `@azure-tools/typespec-azure-core/prefer-csv-collection-format` | It is recommended to use "csv" for collection format of parameters. | +| [`@azure-tools/typespec-azure-core/no-format`](/libraries/azure-core/rules/prevent-format.md) | Azure services should not use the `@format` decorator. | +| `@azure-tools/typespec-azure-core/no-multiple-discriminator` | Classes should have at most one discriminator. | +| `@azure-tools/typespec-azure-core/no-rest-library-interfaces` | Resource interfaces from the TypeSpec.Rest.Resource library are incompatible with Azure.Core. | +| `@azure-tools/typespec-azure-core/no-unknown` | Azure services must not have properties of type `unknown`. | +| `@azure-tools/typespec-azure-core/property-name-conflict` | Avoid naming conflicts between a property and a model of the same name. | +| [`@azure-tools/typespec-azure-core/bad-record-type`](/libraries/azure-core/rules/bad-record-type.md) | Identify bad record definitions. | +| `@azure-tools/typespec-azure-core/documentation-required` | Require documentation over enums, models, and operations. | +| `@azure-tools/typespec-azure-core/key-visibility-required` | Key properties need to have an explicit visibility setting. | +| `@azure-tools/typespec-azure-core/response-schema-problem` | Warn about operations having multiple non-error response schemas. | +| `@azure-tools/typespec-azure-core/rpc-operation-request-body` | Warning for RPC body problems. | +| [`@azure-tools/typespec-azure-core/spread-discriminated-model`](/libraries/azure-core/rules/spread-discriminated-model.md) | Check a model with a discriminator has not been used in composition. | +| `@azure-tools/typespec-azure-core/use-standard-names` | Use recommended names for operations. | +| [`@azure-tools/typespec-azure-core/use-standard-operations`](/libraries/azure-core/rules/use-standard-operations.md) | Operations should be defined using a signature from the Azure.Core namespace. | +| [`@azure-tools/typespec-azure-core/no-string-discriminator`](/libraries/azure-core/rules/no-string-discriminator.md) | Azure services discriminated models should define the discriminated property as an extensible union. | +| [`@azure-tools/typespec-azure-core/require-versioned`](/libraries/azure-core/rules/require-versioned.md) | Azure services should use the versioning library. | +| `@azure-tools/typespec-azure-core/friendly-name` | Ensures that @friendlyName is used as intended. | +| [`@azure-tools/typespec-azure-core/no-private-usage`](/libraries/azure-core/rules/no-private-usage.md) | Verify that elements inside Private namespace are not referenced. | +| [`@azure-tools/typespec-azure-core/no-query-explode`](/libraries/azure-core/rules/no-query-explode.md) | It is recommended to serialize query parameter without explode: true | diff --git a/docs/libraries/azure-core/rules/auth-required.md b/website/src/content/docs/docs/libraries/azure-core/rules/auth-required.md similarity index 100% rename from docs/libraries/azure-core/rules/auth-required.md rename to website/src/content/docs/docs/libraries/azure-core/rules/auth-required.md diff --git a/docs/libraries/azure-core/rules/bad-record-type.md b/website/src/content/docs/docs/libraries/azure-core/rules/bad-record-type.md similarity index 100% rename from docs/libraries/azure-core/rules/bad-record-type.md rename to website/src/content/docs/docs/libraries/azure-core/rules/bad-record-type.md diff --git a/docs/libraries/azure-core/rules/casing-style.md b/website/src/content/docs/docs/libraries/azure-core/rules/casing-style.md similarity index 100% rename from docs/libraries/azure-core/rules/casing-style.md rename to website/src/content/docs/docs/libraries/azure-core/rules/casing-style.md diff --git a/docs/libraries/azure-core/rules/no-closed-literal-union.md b/website/src/content/docs/docs/libraries/azure-core/rules/no-closed-literal-union.md similarity index 100% rename from docs/libraries/azure-core/rules/no-closed-literal-union.md rename to website/src/content/docs/docs/libraries/azure-core/rules/no-closed-literal-union.md diff --git a/docs/libraries/azure-core/rules/no-enum.md b/website/src/content/docs/docs/libraries/azure-core/rules/no-enum.md similarity index 100% rename from docs/libraries/azure-core/rules/no-enum.md rename to website/src/content/docs/docs/libraries/azure-core/rules/no-enum.md diff --git a/docs/libraries/azure-core/rules/no-generic-numeric.md b/website/src/content/docs/docs/libraries/azure-core/rules/no-generic-numeric.md similarity index 100% rename from docs/libraries/azure-core/rules/no-generic-numeric.md rename to website/src/content/docs/docs/libraries/azure-core/rules/no-generic-numeric.md diff --git a/docs/libraries/azure-core/rules/no-multiple-discriminator.md b/website/src/content/docs/docs/libraries/azure-core/rules/no-multiple-discriminator.md similarity index 100% rename from docs/libraries/azure-core/rules/no-multiple-discriminator.md rename to website/src/content/docs/docs/libraries/azure-core/rules/no-multiple-discriminator.md diff --git a/docs/libraries/azure-core/rules/no-nullable.md b/website/src/content/docs/docs/libraries/azure-core/rules/no-nullable.md similarity index 100% rename from docs/libraries/azure-core/rules/no-nullable.md rename to website/src/content/docs/docs/libraries/azure-core/rules/no-nullable.md diff --git a/docs/libraries/azure-core/rules/no-openapi.md b/website/src/content/docs/docs/libraries/azure-core/rules/no-openapi.md similarity index 100% rename from docs/libraries/azure-core/rules/no-openapi.md rename to website/src/content/docs/docs/libraries/azure-core/rules/no-openapi.md diff --git a/docs/libraries/azure-core/rules/no-private-usage.md b/website/src/content/docs/docs/libraries/azure-core/rules/no-private-usage.md similarity index 100% rename from docs/libraries/azure-core/rules/no-private-usage.md rename to website/src/content/docs/docs/libraries/azure-core/rules/no-private-usage.md diff --git a/docs/libraries/azure-core/rules/no-query-explode.md b/website/src/content/docs/docs/libraries/azure-core/rules/no-query-explode.md similarity index 100% rename from docs/libraries/azure-core/rules/no-query-explode.md rename to website/src/content/docs/docs/libraries/azure-core/rules/no-query-explode.md diff --git a/docs/libraries/azure-core/rules/no-string-discriminator.md b/website/src/content/docs/docs/libraries/azure-core/rules/no-string-discriminator.md similarity index 100% rename from docs/libraries/azure-core/rules/no-string-discriminator.md rename to website/src/content/docs/docs/libraries/azure-core/rules/no-string-discriminator.md diff --git a/docs/libraries/azure-core/rules/non-breaking-versioning.md b/website/src/content/docs/docs/libraries/azure-core/rules/non-breaking-versioning.md similarity index 100% rename from docs/libraries/azure-core/rules/non-breaking-versioning.md rename to website/src/content/docs/docs/libraries/azure-core/rules/non-breaking-versioning.md diff --git a/docs/libraries/azure-core/rules/operation-missing-api-version.md b/website/src/content/docs/docs/libraries/azure-core/rules/operation-missing-api-version.md similarity index 100% rename from docs/libraries/azure-core/rules/operation-missing-api-version.md rename to website/src/content/docs/docs/libraries/azure-core/rules/operation-missing-api-version.md diff --git a/docs/libraries/azure-core/rules/prevent-format.md b/website/src/content/docs/docs/libraries/azure-core/rules/prevent-format.md similarity index 100% rename from docs/libraries/azure-core/rules/prevent-format.md rename to website/src/content/docs/docs/libraries/azure-core/rules/prevent-format.md diff --git a/docs/libraries/azure-core/rules/require-versioned.md b/website/src/content/docs/docs/libraries/azure-core/rules/require-versioned.md similarity index 100% rename from docs/libraries/azure-core/rules/require-versioned.md rename to website/src/content/docs/docs/libraries/azure-core/rules/require-versioned.md diff --git a/docs/libraries/azure-core/rules/spread-discriminated-model.md b/website/src/content/docs/docs/libraries/azure-core/rules/spread-discriminated-model.md similarity index 100% rename from docs/libraries/azure-core/rules/spread-discriminated-model.md rename to website/src/content/docs/docs/libraries/azure-core/rules/spread-discriminated-model.md diff --git a/docs/libraries/azure-core/rules/use-standard-names.md b/website/src/content/docs/docs/libraries/azure-core/rules/use-standard-names.md similarity index 100% rename from docs/libraries/azure-core/rules/use-standard-names.md rename to website/src/content/docs/docs/libraries/azure-core/rules/use-standard-names.md diff --git a/docs/libraries/azure-core/rules/use-standard-operations.md b/website/src/content/docs/docs/libraries/azure-core/rules/use-standard-operations.md similarity index 100% rename from docs/libraries/azure-core/rules/use-standard-operations.md rename to website/src/content/docs/docs/libraries/azure-core/rules/use-standard-operations.md diff --git a/docs/libraries/azure-portal-core/reference/data-types.md b/website/src/content/docs/docs/libraries/azure-portal-core/reference/data-types.md similarity index 100% rename from docs/libraries/azure-portal-core/reference/data-types.md rename to website/src/content/docs/docs/libraries/azure-portal-core/reference/data-types.md diff --git a/docs/libraries/azure-portal-core/reference/decorators.md b/website/src/content/docs/docs/libraries/azure-portal-core/reference/decorators.md similarity index 100% rename from docs/libraries/azure-portal-core/reference/decorators.md rename to website/src/content/docs/docs/libraries/azure-portal-core/reference/decorators.md diff --git a/docs/libraries/azure-portal-core/reference/index.mdx b/website/src/content/docs/docs/libraries/azure-portal-core/reference/index.mdx similarity index 100% rename from docs/libraries/azure-portal-core/reference/index.mdx rename to website/src/content/docs/docs/libraries/azure-portal-core/reference/index.mdx diff --git a/docs/libraries/azure-resource-manager/reference/data-types.md b/website/src/content/docs/docs/libraries/azure-resource-manager/reference/data-types.md similarity index 99% rename from docs/libraries/azure-resource-manager/reference/data-types.md rename to website/src/content/docs/docs/libraries/azure-resource-manager/reference/data-types.md index 1ab2cfdb99..5a0b4da55a 100644 --- a/docs/libraries/azure-resource-manager/reference/data-types.md +++ b/website/src/content/docs/docs/libraries/azure-resource-manager/reference/data-types.md @@ -728,27 +728,6 @@ model Foo is TrackedResource { | ----- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | kind? | `string` | Metadata used by portal/tooling/etc to render different UX experiences for resources of the same type; e.g. ApiApps are a kind of Microsoft.Web/sites type. If supported, the resource provider must validate and persist this value. | -### `ResourceListCustomResult` {#Azure.ResourceManager.ResourceListCustomResult} - -Paged response containing results - -```typespec -model Azure.ResourceManager.ResourceListCustomResult -``` - -#### Template Parameters - -| Name | Description | -| ------ | ----------------------------------------------------- | -| Result | The type of the values returned in the paged response | - -#### Properties - -| Name | Type | Description | -| --------- | ---------------- | ---------------------------------- | -| value | `Array` | The items on this page | -| nextLink? | `string` | The link to the next page of items | - ### `ResourceListResult` {#Azure.ResourceManager.ResourceListResult} Paged response containing resources diff --git a/docs/libraries/azure-resource-manager/reference/decorators.md b/website/src/content/docs/docs/libraries/azure-resource-manager/reference/decorators.md similarity index 100% rename from docs/libraries/azure-resource-manager/reference/decorators.md rename to website/src/content/docs/docs/libraries/azure-resource-manager/reference/decorators.md diff --git a/docs/libraries/azure-resource-manager/reference/index.mdx b/website/src/content/docs/docs/libraries/azure-resource-manager/reference/index.mdx similarity index 99% rename from docs/libraries/azure-resource-manager/reference/index.mdx rename to website/src/content/docs/docs/libraries/azure-resource-manager/reference/index.mdx index 2c98b5bad8..a736ea6d4f 100644 --- a/docs/libraries/azure-resource-manager/reference/index.mdx +++ b/website/src/content/docs/docs/libraries/azure-resource-manager/reference/index.mdx @@ -149,7 +149,6 @@ npm install --save-peer @azure-tools/typespec-azure-resource-manager - [`ResourceGroupLocationResource`](./data-types.md#Azure.ResourceManager.ResourceGroupLocationResource) - [`ResourceInstanceParameters`](./data-types.md#Azure.ResourceManager.ResourceInstanceParameters) - [`ResourceKindProperty`](./data-types.md#Azure.ResourceManager.ResourceKindProperty) -- [`ResourceListCustomResult`](./data-types.md#Azure.ResourceManager.ResourceListCustomResult) - [`ResourceListResult`](./data-types.md#Azure.ResourceManager.ResourceListResult) - [`ResourceNameParameter`](./data-types.md#Azure.ResourceManager.ResourceNameParameter) - [`ResourceParentParameters`](./data-types.md#Azure.ResourceManager.ResourceParentParameters) diff --git a/docs/libraries/azure-resource-manager/reference/interfaces.md b/website/src/content/docs/docs/libraries/azure-resource-manager/reference/interfaces.md similarity index 100% rename from docs/libraries/azure-resource-manager/reference/interfaces.md rename to website/src/content/docs/docs/libraries/azure-resource-manager/reference/interfaces.md diff --git a/docs/libraries/azure-resource-manager/reference/linter.md b/website/src/content/docs/docs/libraries/azure-resource-manager/reference/linter.md similarity index 100% rename from docs/libraries/azure-resource-manager/reference/linter.md rename to website/src/content/docs/docs/libraries/azure-resource-manager/reference/linter.md diff --git a/docs/libraries/azure-resource-manager/rules/arm-no-record.md b/website/src/content/docs/docs/libraries/azure-resource-manager/rules/arm-no-record.md similarity index 100% rename from docs/libraries/azure-resource-manager/rules/arm-no-record.md rename to website/src/content/docs/docs/libraries/azure-resource-manager/rules/arm-no-record.md diff --git a/docs/libraries/azure-resource-manager/rules/arm-resource-invalid-action-verb.md b/website/src/content/docs/docs/libraries/azure-resource-manager/rules/arm-resource-invalid-action-verb.md similarity index 100% rename from docs/libraries/azure-resource-manager/rules/arm-resource-invalid-action-verb.md rename to website/src/content/docs/docs/libraries/azure-resource-manager/rules/arm-resource-invalid-action-verb.md diff --git a/docs/libraries/azure-resource-manager/rules/arm-resource-provisioning-state.md b/website/src/content/docs/docs/libraries/azure-resource-manager/rules/arm-resource-provisioning-state.md similarity index 100% rename from docs/libraries/azure-resource-manager/rules/arm-resource-provisioning-state.md rename to website/src/content/docs/docs/libraries/azure-resource-manager/rules/arm-resource-provisioning-state.md diff --git a/docs/libraries/azure-resource-manager/rules/delete-operation-response-codes.md b/website/src/content/docs/docs/libraries/azure-resource-manager/rules/delete-operation-response-codes.md similarity index 100% rename from docs/libraries/azure-resource-manager/rules/delete-operation-response-codes.md rename to website/src/content/docs/docs/libraries/azure-resource-manager/rules/delete-operation-response-codes.md diff --git a/docs/libraries/azure-resource-manager/rules/lro-location-header.md b/website/src/content/docs/docs/libraries/azure-resource-manager/rules/lro-location-header.md similarity index 100% rename from docs/libraries/azure-resource-manager/rules/lro-location-header.md rename to website/src/content/docs/docs/libraries/azure-resource-manager/rules/lro-location-header.md diff --git a/docs/libraries/azure-resource-manager/rules/missing-x-ms-identifiers.md b/website/src/content/docs/docs/libraries/azure-resource-manager/rules/missing-x-ms-identifiers.md similarity index 100% rename from docs/libraries/azure-resource-manager/rules/missing-x-ms-identifiers.md rename to website/src/content/docs/docs/libraries/azure-resource-manager/rules/missing-x-ms-identifiers.md diff --git a/docs/libraries/azure-resource-manager/rules/no-empty-model.md b/website/src/content/docs/docs/libraries/azure-resource-manager/rules/no-empty-model.md similarity index 100% rename from docs/libraries/azure-resource-manager/rules/no-empty-model.md rename to website/src/content/docs/docs/libraries/azure-resource-manager/rules/no-empty-model.md diff --git a/docs/libraries/azure-resource-manager/rules/post-operation-response-codes.md b/website/src/content/docs/docs/libraries/azure-resource-manager/rules/post-operation-response-codes.md similarity index 100% rename from docs/libraries/azure-resource-manager/rules/post-operation-response-codes.md rename to website/src/content/docs/docs/libraries/azure-resource-manager/rules/post-operation-response-codes.md diff --git a/docs/libraries/azure-resource-manager/rules/put-operation-response-codes.md b/website/src/content/docs/docs/libraries/azure-resource-manager/rules/put-operation-response-codes.md similarity index 100% rename from docs/libraries/azure-resource-manager/rules/put-operation-response-codes.md rename to website/src/content/docs/docs/libraries/azure-resource-manager/rules/put-operation-response-codes.md diff --git a/docs/libraries/azure-resource-manager/rules/resource-name-pattern.md b/website/src/content/docs/docs/libraries/azure-resource-manager/rules/resource-name-pattern.md similarity index 100% rename from docs/libraries/azure-resource-manager/rules/resource-name-pattern.md rename to website/src/content/docs/docs/libraries/azure-resource-manager/rules/resource-name-pattern.md diff --git a/docs/libraries/azure-resource-manager/rules/unsupported-type.md b/website/src/content/docs/docs/libraries/azure-resource-manager/rules/unsupported-type.md similarity index 100% rename from docs/libraries/azure-resource-manager/rules/unsupported-type.md rename to website/src/content/docs/docs/libraries/azure-resource-manager/rules/unsupported-type.md diff --git a/docs/libraries/typespec-client-generator-core/reference/decorators.md b/website/src/content/docs/docs/libraries/typespec-client-generator-core/reference/decorators.md similarity index 100% rename from docs/libraries/typespec-client-generator-core/reference/decorators.md rename to website/src/content/docs/docs/libraries/typespec-client-generator-core/reference/decorators.md diff --git a/docs/libraries/typespec-client-generator-core/reference/index.mdx b/website/src/content/docs/docs/libraries/typespec-client-generator-core/reference/index.mdx similarity index 100% rename from docs/libraries/typespec-client-generator-core/reference/index.mdx rename to website/src/content/docs/docs/libraries/typespec-client-generator-core/reference/index.mdx diff --git a/docs/migrate-swagger/01-get-started.md b/website/src/content/docs/docs/migrate-swagger/01-get-started.md similarity index 100% rename from docs/migrate-swagger/01-get-started.md rename to website/src/content/docs/docs/migrate-swagger/01-get-started.md diff --git a/docs/migrate-swagger/_category_.json b/website/src/content/docs/docs/migrate-swagger/_category_.json similarity index 100% rename from docs/migrate-swagger/_category_.json rename to website/src/content/docs/docs/migrate-swagger/_category_.json diff --git a/docs/migrate-swagger/checklists/_category_.json b/website/src/content/docs/docs/migrate-swagger/checklists/_category_.json similarity index 100% rename from docs/migrate-swagger/checklists/_category_.json rename to website/src/content/docs/docs/migrate-swagger/checklists/_category_.json diff --git a/docs/migrate-swagger/checklists/migrate-arm-tips.md b/website/src/content/docs/docs/migrate-swagger/checklists/migrate-arm-tips.md similarity index 100% rename from docs/migrate-swagger/checklists/migrate-arm-tips.md rename to website/src/content/docs/docs/migrate-swagger/checklists/migrate-arm-tips.md diff --git a/docs/migrate-swagger/checklists/migrate-dp-tips.md b/website/src/content/docs/docs/migrate-swagger/checklists/migrate-dp-tips.md similarity index 100% rename from docs/migrate-swagger/checklists/migrate-dp-tips.md rename to website/src/content/docs/docs/migrate-swagger/checklists/migrate-dp-tips.md diff --git a/docs/migrate-swagger/faq/_category_.json b/website/src/content/docs/docs/migrate-swagger/faq/_category_.json similarity index 100% rename from docs/migrate-swagger/faq/_category_.json rename to website/src/content/docs/docs/migrate-swagger/faq/_category_.json diff --git a/docs/migrate-swagger/faq/breakingchange.md b/website/src/content/docs/docs/migrate-swagger/faq/breakingchange.md similarity index 100% rename from docs/migrate-swagger/faq/breakingchange.md rename to website/src/content/docs/docs/migrate-swagger/faq/breakingchange.md diff --git a/docs/migrate-swagger/faq/lintdiff.md b/website/src/content/docs/docs/migrate-swagger/faq/lintdiff.md similarity index 100% rename from docs/migrate-swagger/faq/lintdiff.md rename to website/src/content/docs/docs/migrate-swagger/faq/lintdiff.md diff --git a/docs/migrate-swagger/faq/x-ms-examples.md b/website/src/content/docs/docs/migrate-swagger/faq/x-ms-examples.md similarity index 100% rename from docs/migrate-swagger/faq/x-ms-examples.md rename to website/src/content/docs/docs/migrate-swagger/faq/x-ms-examples.md diff --git a/docs/reference/arm/index.md b/website/src/content/docs/docs/reference/arm/index.md similarity index 100% rename from docs/reference/arm/index.md rename to website/src/content/docs/docs/reference/arm/index.md diff --git a/docs/reference/azure-style-guide.md b/website/src/content/docs/docs/reference/azure-style-guide.md similarity index 100% rename from docs/reference/azure-style-guide.md rename to website/src/content/docs/docs/reference/azure-style-guide.md diff --git a/docs/reference/azure.core/index.md b/website/src/content/docs/docs/reference/azure.core/index.md similarity index 100% rename from docs/reference/azure.core/index.md rename to website/src/content/docs/docs/reference/azure.core/index.md diff --git a/docs/release-notes/cadl-typespec-migration.md b/website/src/content/docs/docs/release-notes/cadl-typespec-migration.md similarity index 100% rename from docs/release-notes/cadl-typespec-migration.md rename to website/src/content/docs/docs/release-notes/cadl-typespec-migration.md diff --git a/docs/release-notes/release-2022-07-08.md b/website/src/content/docs/docs/release-notes/release-2022-07-08.md similarity index 100% rename from docs/release-notes/release-2022-07-08.md rename to website/src/content/docs/docs/release-notes/release-2022-07-08.md diff --git a/docs/release-notes/release-2022-08-10.md b/website/src/content/docs/docs/release-notes/release-2022-08-10.md similarity index 100% rename from docs/release-notes/release-2022-08-10.md rename to website/src/content/docs/docs/release-notes/release-2022-08-10.md diff --git a/docs/release-notes/release-2022-09-07.md b/website/src/content/docs/docs/release-notes/release-2022-09-07.md similarity index 100% rename from docs/release-notes/release-2022-09-07.md rename to website/src/content/docs/docs/release-notes/release-2022-09-07.md diff --git a/docs/release-notes/release-2022-10-12.md b/website/src/content/docs/docs/release-notes/release-2022-10-12.md similarity index 100% rename from docs/release-notes/release-2022-10-12.md rename to website/src/content/docs/docs/release-notes/release-2022-10-12.md diff --git a/docs/release-notes/release-2022-11-11.md b/website/src/content/docs/docs/release-notes/release-2022-11-11.md similarity index 100% rename from docs/release-notes/release-2022-11-11.md rename to website/src/content/docs/docs/release-notes/release-2022-11-11.md diff --git a/docs/release-notes/release-2022-12-07.md b/website/src/content/docs/docs/release-notes/release-2022-12-07.md similarity index 100% rename from docs/release-notes/release-2022-12-07.md rename to website/src/content/docs/docs/release-notes/release-2022-12-07.md diff --git a/docs/release-notes/release-2023-01-12.md b/website/src/content/docs/docs/release-notes/release-2023-01-12.md similarity index 100% rename from docs/release-notes/release-2023-01-12.md rename to website/src/content/docs/docs/release-notes/release-2023-01-12.md diff --git a/docs/release-notes/release-2023-02-07.md b/website/src/content/docs/docs/release-notes/release-2023-02-07.md similarity index 100% rename from docs/release-notes/release-2023-02-07.md rename to website/src/content/docs/docs/release-notes/release-2023-02-07.md diff --git a/docs/release-notes/release-2023-03-13.md b/website/src/content/docs/docs/release-notes/release-2023-03-13.md similarity index 100% rename from docs/release-notes/release-2023-03-13.md rename to website/src/content/docs/docs/release-notes/release-2023-03-13.md diff --git a/docs/release-notes/release-2023-04-11.md b/website/src/content/docs/docs/release-notes/release-2023-04-11.md similarity index 100% rename from docs/release-notes/release-2023-04-11.md rename to website/src/content/docs/docs/release-notes/release-2023-04-11.md diff --git a/docs/release-notes/release-2023-05-10.md b/website/src/content/docs/docs/release-notes/release-2023-05-10.md similarity index 100% rename from docs/release-notes/release-2023-05-10.md rename to website/src/content/docs/docs/release-notes/release-2023-05-10.md diff --git a/docs/release-notes/release-2023-06-06.md b/website/src/content/docs/docs/release-notes/release-2023-06-06.md similarity index 100% rename from docs/release-notes/release-2023-06-06.md rename to website/src/content/docs/docs/release-notes/release-2023-06-06.md diff --git a/docs/release-notes/release-2023-07-11.md b/website/src/content/docs/docs/release-notes/release-2023-07-11.md similarity index 100% rename from docs/release-notes/release-2023-07-11.md rename to website/src/content/docs/docs/release-notes/release-2023-07-11.md diff --git a/docs/release-notes/release-2023-08-08.md b/website/src/content/docs/docs/release-notes/release-2023-08-08.md similarity index 100% rename from docs/release-notes/release-2023-08-08.md rename to website/src/content/docs/docs/release-notes/release-2023-08-08.md diff --git a/docs/release-notes/release-2023-09-12.md b/website/src/content/docs/docs/release-notes/release-2023-09-12.md similarity index 100% rename from docs/release-notes/release-2023-09-12.md rename to website/src/content/docs/docs/release-notes/release-2023-09-12.md diff --git a/docs/release-notes/release-2023-10-11.md b/website/src/content/docs/docs/release-notes/release-2023-10-11.md similarity index 100% rename from docs/release-notes/release-2023-10-11.md rename to website/src/content/docs/docs/release-notes/release-2023-10-11.md diff --git a/docs/release-notes/release-2023-11-07.md b/website/src/content/docs/docs/release-notes/release-2023-11-07.md similarity index 100% rename from docs/release-notes/release-2023-11-07.md rename to website/src/content/docs/docs/release-notes/release-2023-11-07.md diff --git a/docs/release-notes/release-2023-12-06.md b/website/src/content/docs/docs/release-notes/release-2023-12-06.md similarity index 100% rename from docs/release-notes/release-2023-12-06.md rename to website/src/content/docs/docs/release-notes/release-2023-12-06.md diff --git a/docs/release-notes/release-2024-01-23.md b/website/src/content/docs/docs/release-notes/release-2024-01-23.md similarity index 100% rename from docs/release-notes/release-2024-01-23.md rename to website/src/content/docs/docs/release-notes/release-2024-01-23.md diff --git a/docs/release-notes/release-2024-02-06.md b/website/src/content/docs/docs/release-notes/release-2024-02-06.md similarity index 100% rename from docs/release-notes/release-2024-02-06.md rename to website/src/content/docs/docs/release-notes/release-2024-02-06.md diff --git a/docs/release-notes/release-2024-03-05.md b/website/src/content/docs/docs/release-notes/release-2024-03-05.md similarity index 100% rename from docs/release-notes/release-2024-03-05.md rename to website/src/content/docs/docs/release-notes/release-2024-03-05.md diff --git a/docs/release-notes/release-2024-04-02.md b/website/src/content/docs/docs/release-notes/release-2024-04-02.md similarity index 100% rename from docs/release-notes/release-2024-04-02.md rename to website/src/content/docs/docs/release-notes/release-2024-04-02.md diff --git a/docs/release-notes/release-2024-05-07.md b/website/src/content/docs/docs/release-notes/release-2024-05-07.md similarity index 100% rename from docs/release-notes/release-2024-05-07.md rename to website/src/content/docs/docs/release-notes/release-2024-05-07.md diff --git a/docs/release-notes/release-2024-06-11.md b/website/src/content/docs/docs/release-notes/release-2024-06-11.md similarity index 100% rename from docs/release-notes/release-2024-06-11.md rename to website/src/content/docs/docs/release-notes/release-2024-06-11.md diff --git a/docs/release-notes/release-2024-07-16.md b/website/src/content/docs/docs/release-notes/release-2024-07-16.md similarity index 100% rename from docs/release-notes/release-2024-07-16.md rename to website/src/content/docs/docs/release-notes/release-2024-07-16.md diff --git a/docs/release-notes/release-2024-08-06.md b/website/src/content/docs/docs/release-notes/release-2024-08-06.md similarity index 100% rename from docs/release-notes/release-2024-08-06.md rename to website/src/content/docs/docs/release-notes/release-2024-08-06.md diff --git a/docs/release-notes/release-2024-09-10.md b/website/src/content/docs/docs/release-notes/release-2024-09-10.md similarity index 100% rename from docs/release-notes/release-2024-09-10.md rename to website/src/content/docs/docs/release-notes/release-2024-09-10.md diff --git a/docs/release-notes/release-2024-10-09.md b/website/src/content/docs/docs/release-notes/release-2024-10-09.md similarity index 100% rename from docs/release-notes/release-2024-10-09.md rename to website/src/content/docs/docs/release-notes/release-2024-10-09.md diff --git a/docs/troubleshoot/arm-proxy-operations-error.md b/website/src/content/docs/docs/troubleshoot/arm-proxy-operations-error.md similarity index 100% rename from docs/troubleshoot/arm-proxy-operations-error.md rename to website/src/content/docs/docs/troubleshoot/arm-proxy-operations-error.md diff --git a/docs/troubleshoot/enum-not-extensible.md b/website/src/content/docs/docs/troubleshoot/enum-not-extensible.md similarity index 100% rename from docs/troubleshoot/enum-not-extensible.md rename to website/src/content/docs/docs/troubleshoot/enum-not-extensible.md diff --git a/docs/troubleshoot/sdl.md b/website/src/content/docs/docs/troubleshoot/sdl.md similarity index 100% rename from docs/troubleshoot/sdl.md rename to website/src/content/docs/docs/troubleshoot/sdl.md diff --git a/docs/troubleshoot/status-read-only-error.md b/website/src/content/docs/docs/troubleshoot/status-read-only-error.md similarity index 100% rename from docs/troubleshoot/status-read-only-error.md rename to website/src/content/docs/docs/troubleshoot/status-read-only-error.md diff --git a/docs/troubleshoot/suppresswarnings.md b/website/src/content/docs/docs/troubleshoot/suppresswarnings.md similarity index 100% rename from docs/troubleshoot/suppresswarnings.md rename to website/src/content/docs/docs/troubleshoot/suppresswarnings.md diff --git a/docs/troubleshoot/troubleshoot_template b/website/src/content/docs/docs/troubleshoot/troubleshoot_template similarity index 100% rename from docs/troubleshoot/troubleshoot_template rename to website/src/content/docs/docs/troubleshoot/troubleshoot_template diff --git a/docs/troubleshoot/versioning_operation_template_changes.md b/website/src/content/docs/docs/troubleshoot/versioning_operation_template_changes.md similarity index 100% rename from docs/troubleshoot/versioning_operation_template_changes.md rename to website/src/content/docs/docs/troubleshoot/versioning_operation_template_changes.md diff --git a/docs/typespec-getting-started.md b/website/src/content/docs/docs/typespec-getting-started.md similarity index 100% rename from docs/typespec-getting-started.md rename to website/src/content/docs/docs/typespec-getting-started.md