[Documentation] Migrate spec PR review workflow support docs to EngHub

[konrad-jamrozik]

Per the V-Team: Service Partner Docs I have some docs to migrate to https://aka.ms/azsdkdocs ad Engineering Hub: https://eng.ms/docs/products/azure-developer-experience. There is an Excel spreadsheet for that, but not sharing here on purpose.

Specifically, I shall migrate these docs, among others (see comments below):

• DONE https://dev.azure.com/azure-sdk/internal/_wiki/wikis/internal.wiki/85/Swagger-Suppression-Process
• DONE https://dev.azure.com/azure-sdk/internal/_wiki/wikis/internal.wiki/828/How-to-suppress-validation-rules
• DONE https://dev.azure.com/azure-sdk/internal/_wiki/wikis/internal.wiki/84/OpenAPI-Spec-Authoring-Validation-tools
• DONE https://aka.ms/azsdk/support/spectools / https://dev.azure.com/azure-sdk/internal/_wiki/wikis/internal.wiki/923/API-Spec-Validation-Tooling-Support

Note: @heaths to be included as a reviewer.

Related work:

• [PR Workflow] Add "Next steps to merge this PR" comment #6617

Leftover follow-up work to be done later:

• [Documentation] Deduplicate docs on sample directory structure for REST API specs #6869
• [Documentation] Migrate deprecated docs to archive in January 2024 #6870
• [Documentation] Migrate leftover guidance on how to create new specs #6886
• [Documentation] Migrate the pinned API Spec review posts to EngHub #6897

[konrad-jamrozik]

Also need to migrate all the relevant pinned announcements on the Teams spec review channel, including the owners list.

Update: Moved this work to:

• [Documentation] Migrate the pinned API Spec review posts to EngHub #6897

[konrad-jamrozik]

Also need to update the docs per the email thread with subject Re: Incorrect docs on PR approvals? Asking for feedback both from ARM and data-plane folks..

Update: DONE: https://dev.azure.com/azure-sdk/internal/_git/azure-sdk-docs-eng.ms/pullrequest/828

[konrad-jamrozik]

@kurtzeborn do you want to migrate this page to EngHub?

https://dev.azure.com/azure-sdk/internal/_wiki/wikis/internal.wiki/369/Support

Update: DONE: https://dev.azure.com/azure-sdk/internal/_git/azure-sdk-docs-eng.ms/pullrequest/813

[konrad-jamrozik]

There are few more pages to migrate assigned to me by @ccbarragan, including:

• DONE Subpages of https://dev.azure.com/azure-sdk/internal/_wiki/wikis/internal.wiki/369/Support
• (#6886) https://dev.azure.com/azure-sdk/internal/_wiki/wikis/internal.wiki/80/Getting-started-with-OpenAPI-specifications
• DONE https://dev.azure.com/azure-sdk/internal/_wiki/wikis/internal.wiki/92/Sample-ReadME
• DONE https://dev.azure.com/azure-sdk/internal/_wiki/wikis/internal.wiki/902/API-spec-checking-in-and-PR-review
• DONE Subtree of https://dev.azure.com/azure-sdk/internal/_wiki/wikis/internal.wiki/611/API-First-with-Service-API-Toolset

[konrad-jamrozik]

Meta docs to add:

• Page on how to obtain telemetry
• Page on how to read feedback

Source: this meeting. Also:

• https://eng.ms/docs/help/kusto
• https://eng.ms/docs/help/blog/posts/logviewer

Update: DONE.

[konrad-jamrozik]

I also should review my old docs issues, like this one:

• Consolidate support guidance for API spec PR tools #5867 (comment)

I had few more.