Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

authentication doc reorganization #3866

Conversation

dbradish-microsoft
Copy link
Collaborator

@dbradish-microsoft dbradish-microsoft commented Sep 18, 2023

The purpose of this PR is to break our single long doc into smaller individual docs similar to our install organization. The instructions have changed very little in this step. Our next step is to add more content -- more pros and cons, tips and techniques etc.

@dbradish-microsoft dbradish-microsoft changed the title outline of new sign in docs authentication doc reorganization Sep 18, 2023
@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 8414b4e:

⚠️ Validation status: warnings

File Status Preview URL Details
docs-ref-conceptual/authenticate-azure-cli.md ⚠️Warning View Details
docs-ref-conceptual/authenticate-azure-cli-interactively.md ⚠️Warning View Details
docs-ref-conceptual/authenticate-azure-cli-managed-identity.md ⚠️Warning View Details
docs-ref-conceptual/authenticate-azure-cli-service-principal.md ⚠️Warning View Details
docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md ⚠️Warning View Details
docs-ref-conceptual/TOC.yml ✅Succeeded View

docs-ref-conceptual/authenticate-azure-cli.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Sign in with Azure CLI — Login and Authentication | Microsoft Docs' is duplicated in: 'docs-ref-conceptual/authenticate-azure-cli.md(2,8), docs-ref-conceptual/authenticate-azure-cli-interactively.md(2,8), docs-ref-conceptual/authenticate-azure-cli-managed-identity.md(2,8), docs-ref-conceptual/authenticate-azure-cli-service-principal.md(2,8), docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md(2,8)'. Titles must be unique within a docset.
  • Line 3, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'Learn the different authentication types for your Azure CLI login — sign in with Azure CLI automatically, locally, or interactively using the az login command.' is duplicated in 'docs-ref-conceptual/authenticate-azure-cli-interactively.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli-managed-identity.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli-service-principal.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli.md(3,14)'.

docs-ref-conceptual/authenticate-azure-cli-interactively.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Sign in with Azure CLI — Login and Authentication | Microsoft Docs' is duplicated in: 'docs-ref-conceptual/authenticate-azure-cli.md(2,8), docs-ref-conceptual/authenticate-azure-cli-interactively.md(2,8), docs-ref-conceptual/authenticate-azure-cli-managed-identity.md(2,8), docs-ref-conceptual/authenticate-azure-cli-service-principal.md(2,8), docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md(2,8)'. Titles must be unique within a docset.
  • Line 3, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'Learn the different authentication types for your Azure CLI login — sign in with Azure CLI automatically, locally, or interactively using the az login command.' is duplicated in 'docs-ref-conceptual/authenticate-azure-cli-interactively.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli-managed-identity.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli-service-principal.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli.md(3,14)'.

docs-ref-conceptual/authenticate-azure-cli-managed-identity.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Sign in with Azure CLI — Login and Authentication | Microsoft Docs' is duplicated in: 'docs-ref-conceptual/authenticate-azure-cli.md(2,8), docs-ref-conceptual/authenticate-azure-cli-interactively.md(2,8), docs-ref-conceptual/authenticate-azure-cli-managed-identity.md(2,8), docs-ref-conceptual/authenticate-azure-cli-service-principal.md(2,8), docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md(2,8)'. Titles must be unique within a docset.
  • Line 3, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'Learn the different authentication types for your Azure CLI login — sign in with Azure CLI automatically, locally, or interactively using the az login command.' is duplicated in 'docs-ref-conceptual/authenticate-azure-cli-interactively.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli-managed-identity.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli-service-principal.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli.md(3,14)'.

docs-ref-conceptual/authenticate-azure-cli-service-principal.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Sign in with Azure CLI — Login and Authentication | Microsoft Docs' is duplicated in: 'docs-ref-conceptual/authenticate-azure-cli.md(2,8), docs-ref-conceptual/authenticate-azure-cli-interactively.md(2,8), docs-ref-conceptual/authenticate-azure-cli-managed-identity.md(2,8), docs-ref-conceptual/authenticate-azure-cli-service-principal.md(2,8), docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md(2,8)'. Titles must be unique within a docset.
  • Line 3, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'Learn the different authentication types for your Azure CLI login — sign in with Azure CLI automatically, locally, or interactively using the az login command.' is duplicated in 'docs-ref-conceptual/authenticate-azure-cli-interactively.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli-managed-identity.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli-service-principal.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli.md(3,14)'.

docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Sign in with Azure CLI — Login and Authentication | Microsoft Docs' is duplicated in: 'docs-ref-conceptual/authenticate-azure-cli.md(2,8), docs-ref-conceptual/authenticate-azure-cli-interactively.md(2,8), docs-ref-conceptual/authenticate-azure-cli-managed-identity.md(2,8), docs-ref-conceptual/authenticate-azure-cli-service-principal.md(2,8), docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md(2,8)'. Titles must be unique within a docset.
  • Line 3, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'Learn the different authentication types for your Azure CLI login — sign in with Azure CLI automatically, locally, or interactively using the az login command.' is duplicated in 'docs-ref-conceptual/authenticate-azure-cli-interactively.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli-managed-identity.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli-service-principal.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md(3,14)', 'docs-ref-conceptual/authenticate-azure-cli.md(3,14)'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions 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:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 7f8fc61:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/authenticate-azure-cli.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-interactively.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-managed-identity.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-service-principal.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md ✅Succeeded View
docs-ref-conceptual/TOC.yml ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit dbb56d3:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/authenticate-azure-cli.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-interactively.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-managed-identity.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-service-principal.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md ✅Succeeded View
docs-ref-conceptual/TOC.yml ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit a27385e:

⚠️ Validation status: warnings

File Status Preview URL Details
docs-ref-conceptual/authenticate-azure-cli.md ⚠️Warning View Details
docs-ref-conceptual/authenticate-azure-cli-interactively.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-managed-identity.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-service-principal.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md ✅Succeeded View
docs-ref-conceptual/TOC.yml ✅Succeeded View

docs-ref-conceptual/authenticate-azure-cli.md

  • Line 28, Column 16: [Warning: file-not-found - See documentation] Invalid file link: 'authenticate-auzre-cli-web-account-manager.md'.
  • Line 32, Column 395: [Suggestion: link-broken - See documentation] Link '/active-directory/develop/refresh-tokens' points to a page that doesn't exist. Check the path or URL and update the link.

For more details, please refer to the build report.

Note: Links can become broken if there are changes on the target sites. If you think the validation result is a false alarm, please use SiteHelp with option 'Content authoring and publishing -> False alarm on broken link validation' to report.

Note: Your PR may contain errors or warnings or suggestions 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:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit cb70929:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/authenticate-azure-cli.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-interactively.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-managed-identity.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-service-principal.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md ✅Succeeded View
docs-ref-conceptual/TOC.yml ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 1f2af54:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/authenticate-azure-cli.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-interactively.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-managed-identity.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-service-principal.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md ✅Succeeded View
docs-ref-conceptual/TOC.yml ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 879f099:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/authenticate-azure-cli.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-interactively.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-managed-identity.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-service-principal.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md ✅Succeeded View
docs-ref-conceptual/TOC.yml ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit b8ac45a:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/authenticate-azure-cli.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-interactively.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-managed-identity.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-service-principal.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md ✅Succeeded View
docs-ref-conceptual/TOC.yml ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 66654b7:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/authenticate-azure-cli.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-interactively.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-managed-identity.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-service-principal.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli.md ✅Succeeded View
docs-ref-conceptual/TOC.yml ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit d174455:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/authenticate-azure-cli.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-interactively.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-managed-identity.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-service-principal.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli.md ✅Succeeded View
docs-ref-conceptual/TOC.yml ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@dbradish-microsoft dbradish-microsoft marked this pull request as ready for review September 18, 2023 18:39
@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 2d0bf7a:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/authenticate-azure-cli.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-interactively.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-managed-identity.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-service-principal.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli.md ✅Succeeded View
docs-ref-conceptual/TOC.yml ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@bebound
Copy link
Contributor

bebound commented Sep 19, 2023

@jiasli for review

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 2187812:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/authenticate-azure-cli.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-interactively.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-managed-identity.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-service-principal.md ✅Succeeded View
docs-ref-conceptual/authenticate-azure-cli-web-account-manager.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli.md ✅Succeeded View
docs-ref-conceptual/TOC.yml ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@dbradish-microsoft
Copy link
Collaborator Author

Merging PR with sufficient time given for engineering review. Our next step is to add content to each individual auth article with more pros, cons, tips, and techniques.

@dbradish-microsoft dbradish-microsoft merged commit e197de7 into MicrosoftDocs:main Sep 22, 2023
@dbradish-microsoft dbradish-microsoft deleted the dbradish_signinDocRewrite branch May 23, 2024 18:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants