Add doc for Microsoft Graph migration

[jiasli]

Add doc for Microsoft Graph migration.

[opbld30]

Docs Build status updates of commit 1d5a40c:

✅ Validation status: passed

File	Status	Preview URL	Details
docs-ref-conceptual/microsoft-graph-migration.md	💡Suggestion	View	Details
docs-ref-conceptual/TOC.yml	✅Succeeded	View

docs-ref-conceptual/microsoft-graph-migration.md

• Line 17, Column 8: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://docs.microsoft.com/graph/migrate-azure-ad-graph-overview' will be broken in isolated environments. Replace with a relative link.
• Line 21, Column 89: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://docs.microsoft.com/graph/migrate-azure-ad-graph-property-differences' will be broken in isolated environments. Replace with a relative link.

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

• Try searching the docs.microsoft.com contributor guides
• Post your question in the Docs support channel

[opbld32]

Docs Build status updates of commit 5775818:

✅ Validation status: passed

File	Status	Preview URL	Details
docs-ref-conceptual/TOC.yml	✅Succeeded	View
docs-ref-conceptual/microsoft-graph-migration.md	✅Succeeded	View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

• Try searching the docs.microsoft.com contributor guides
• Post your question in the Docs support channel

[dbradish-microsoft]

@jiasli , @chasewilson , I feel we need some "before" and "after" actual examples in this article. I will definitely need this as well as this change impacts the following:

az ad app create -- 18 articles
az ad app permission grant -- 3 articles
az ad app credential reset -- no articles
az ad sp delete -- 5 articles
etc.

Maybe use tabbed conceptual with the new method on the top tab /or/ use dependent tabs?

[dbradish-microsoft]

@jiasli, this information used to be in our install docs, so two questions: 1.) what was the thought process behind removing information about Beta from our install docs, and 2.) is this the best (only) place for Beta information?

[jiasli]

Exactly. The beta installation guide was removed by #2807 after the MSAL migration.

We don't have regular beta releases. In other words, beta is only for specific features like MSAL, Microsoft Graph. We stop releasing beta versions after jobs are finished.

[jiasli]

@dbradish-microsoft, this is only the first version. Let's refine it later. 😉 We need to catch up with tomorrow's beta release.

[chasewilson]

Suggested change

	pip install --extra-index-url https://azcliprod.blob.core.windows.net/beta/simple/ azure-cli
	pip install --extra-index-url https://azcliprod.blob.core.windows.net/beta/simple/azure-cli

I don't think there is supposed to be a space here? Correct me if I'm wrong. it will install but with a warning and adjusted url:

warning: missing-index-doctype

× The package index page being used does not have a proper HTML doctype declaration.
╰─> Problematic URL: https://azcliprod.blob.core.windows.net/beta/simple/azure-cli/

[jiasli]

No, the space is required because https://azcliprod.blob.core.windows.net/beta/simple/ is the index URL and azure-cli is the package name.

The page doesn't work because we haven't published beta yet. I will do that today.

[opbld33]

Docs Build status updates of commit 2686fc0:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
	❌Error		Details

• [Error: GitBranchDeletedOrForcePushed] Cannot sync git repo to specified commit because branch ms-graph has been deleted or has been force pushed

For more details, please refer to the build report.

If you see build warnings/errors with permission issues, it might be due to single sign-on (SSO) enabled on Microsoft's GitHub organizations. Please follow instructions here to re-authorize your GitHub account to Docs Build.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

Note: Your PR may contain errors or warnings unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

• Try searching the docs.microsoft.com contributor guides
• Post your question in the Docs support channel

[jiasli]

@chasewilson, your error warning: missing-index-doctype is caused by a recent change of pip: pypa/pip#10825

I have updated the beta release script: https://github.com/jiasli/az-publish/commit/1f1b4745aa9c9e913aa434f45d1c6b777b173a34