April/May Docs Plan

[savannahostrowski]

• [ ] Brainstorm/spec updates to learn.microsoft.com/en-us/azure/developer/azure-developer-cli/overview
• [ ] Brainstorm/spec updates to "Get started" tab
• [x] Add ASA info to DevHub when merged (if in DevHub) - https://github.com/Azure/azure-dev/pull/1808 @fangjian0423 @vhvb1989
• [ ] SWA known issue/troubleshoot update https://github.com/Azure/azure-dev/issues/1847 @vhvb1989
• [x] Pipelines <-> CodeSpaces improvements. Any additions/removals from existing troubleshoot/FAQ's - https://github.com/Azure/azure-dev/issues/1938 @vhvb1989
• [ ] azure.yaml.json publishing recent updates. Is it automatic as part of pipelines? @danieljurek

[savannahostrowski]

Add ASA info to DevHub when merged (if in DevHub).

[savannahostrowski]

P0 for release on May 9:

• Add ASA info to DevHub when merged (if in DevHub) - https://github.com/Azure/azure-dev/pull/1808 @fangjian0423 @vhvb1989
• https://github.com/Azure/azure-dev/pull/2029

By May 23:

• Getting started revisions
• CSS doc updates
• SWA known issue/troubleshoot update https://github.com/Azure/azure-dev/issues/1847 @vhvb1989 Pipelines <-> CodeSpaces improvements. Any additions/removals from existing troubleshoot/FAQ's - https://github.com/Azure/azure-dev/issues/1938 @vhvb1989 azure.yaml.json publishing recent updates. Is it automatic as part of pipelines? @danieljurek
• environment updates per @ellismg
• Remove readme in /.azdo/pipelines/README.md in azd templates#1313

[danieljurek]

Publishing azure.yaml.json docs is not automated today, however our builds always produce the markdown for that.

To get the markdown:

1. Open release build
2. Navigate to Artifacts
3. Open the docs artifact
4. Download the azure.yaml.schema.md file
5. Open PR to update docs using the new azure.yaml.schema.md file