Skip to content

resolved conflicts#128541

Open
tanvishinde017 wants to merge 29 commits into
MicrosoftDocs:mainfrom
tanvishinde017:main
Open

resolved conflicts#128541
tanvishinde017 wants to merge 29 commits into
MicrosoftDocs:mainfrom
tanvishinde017:main

Conversation

@tanvishinde017
Copy link
Copy Markdown

No description provided.

Corrected grammar and formatting in migration documentation.
Revised customer intent statement for clarity and completeness.
Improve App Service plan documentation readability and formatting consistency
Updated summaries and titles for clarity and consistency. Revised descriptions and links for better understanding of Azure App Testing features.
Improve Azure App Testing landing page readability and content organization
Updated the FAQ article for WordPress on Azure App Service to enhance descriptions, correct terminology, and improve clarity on various topics including security, performance, and configuration.
## Summary

Enhanced the WordPress on Azure App Service FAQ documentation by improving content structure, refining technical explanations, and expanding operational guidance for deployment, security, monitoring, scaling, and troubleshooting scenarios.

## Key improvements

### Documentation quality and readability

* Refined article introduction and FAQ flow for improved discoverability
* Standardized formatting, capitalization, and terminology across all sections
* Improved readability of technical explanations and operational guidance
* Simplified complex configuration workflows into clearer step-based guidance

### Security and identity enhancements

* Expanded security recommendations for App Service, MySQL Flexible Server, and Microsoft Entra integrations
* Clarified managed identity authentication and phpMyAdmin access workflows
* Improved guidance for HTTPS, VNet integration, Key Vault, and Defender for Cloud scenarios
* Enhanced explanations for enterprise authentication and access management

### Performance and scalability guidance

* Improved recommendations for scaling, caching, and enterprise-grade deployments
* Enhanced guidance for Azure Front Door, Blob Storage, Redis Cache, and dynamic caching integrations
* Clarified App Service plan sizing considerations and hosting capacity recommendations
* Added more actionable performance optimization references

### Troubleshooting and monitoring improvements

* Reorganized debugging and monitoring sections for easier navigation
* Improved troubleshooting guidance for common WordPress deployment issues
* Enhanced log access, Kudu, SSH, and diagnostic workflow explanations
* Refined phpMyAdmin and database access documentation for clarity and operational accuracy

### Developer and deployment experience

* Improved CI/CD, startup script, and configuration guidance
* Enhanced documentation for custom domains, multisite deployments, and headless WordPress architectures
* Updated enterprise deployment recommendations and production readiness guidance
* Improved consistency across external references and Azure service integrations

## Files updated

* `articles/app-service/wordpress-faq.md`

## Impact

These updates improve the overall developer and administrator experience by making the FAQ easier to navigate, more technically accurate, and more actionable for enterprise WordPress deployments on Azure App Service. The revised structure and guidance help users better understand operational best practices, troubleshoot issues more efficiently, and deploy scalable, secure, production-ready WordPress environments on Azure.
Updated the article to clarify the usage of Azure Key Vault references in app settings and connection strings, including access permissions and troubleshooting.
## Summary

Added comprehensive Markdown documentation for using Azure Key Vault references as application settings in:

- Azure App Service
- Azure Functions
- Azure Logic Apps (Standard)

## Changes Included

- Added managed identity configuration guidance
- Documented Key Vault access setup and RBAC permissions
- Added support details for user-assigned identities
- Included network-restricted vault configuration
- Added secret rotation and refresh behavior documentation
- Documented Key Vault reference formats with examples
- Added Azure Files mounting considerations
- Included Application Insights integration notes
- Added ARM template deployment examples
- Improved troubleshooting guidance and diagnostics steps
- Added security and deployment best practices

## Benefits

- Improves readability and maintainability of documentation
- Provides end-to-end guidance for secure secret management
- Helps developers implement production-ready Key Vault integration
- Simplifies onboarding for App Service and Functions users
Updated the agent registry overview to enhance clarity and detail, including improved descriptions and structured sections for key features, registration, management, and dependency tracking.
Fix formatting of link in agent overview documentation
Updated the access tokens documentation for clarity and accuracy, including changes to the customer intent, access token descriptions, and scope explanations.
Revise access tokens documentation for clarity
Update overview-what-is-azure-app-testing.md
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 99cf52f:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File Status Preview URL Details
❌Error Details

  • [Error: CannotMergeCommit] Cannot merge commit 99cf52f610f127879f189c887826d79e333df8c3 in branch main of repository https://github.com/tanvishinde017/azure-docs into branch main (commit 152a2e93cad977301da57fb2872f250373c8ff59). Please follow this documentation: https://help.github.com/articles/resolving-a-merge-conflict-using-the-command-line/ to use git.exe to resolve you content conflicts locally and then push to remote.

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.

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit a51cfa8:

⚠️ Validation status: warnings

File Status Preview URL Details
articles/active-directory-b2c/authorization-code-flow.md ⚠️Warning Details
articles/active-directory-b2c/openid-connect.md ⚠️Warning Details
articles/app-service/app-service-asp-net-migration.md ⚠️Warning Details
articles/app-service/app-service-key-vault-references.md ⚠️Warning Details
articles/app-service/configure-language-java-security.md ⚠️Warning Details
articles/app-service/includes/configure-azure-storage/azure-storage-linux-container-pivot.md ⚠️Warning Details
articles/app-service/includes/configure-azure-storage/azure-storage-windows-code-pivot.md ⚠️Warning Details
articles/app-service/includes/configure-azure-storage/azure-storage-windows-container-pivot.md ⚠️Warning Details
articles/app-service/tutorial-networking-isolate-vnet.md ⚠️Warning Details
articles/app-testing/overview-what-is-azure-app-testing.md ⚠️Warning Details
articles/azure-functions/errors-diagnostics/diagnostic-events/azfd0002.md ⚠️Warning Details
articles/active-directory-b2c/access-tokens.md 💡Suggestion Details
articles/api-center/agent-to-agent-overview.md ✅Succeeded
articles/app-service/app-service-plan-manage.md ✅Succeeded
articles/app-service/wordpress-faq.md ✅Succeeded
articles/app-testing/index.yml ✅Succeeded

articles/active-directory-b2c/authorization-code-flow.md

  • Line 116, Column 189: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#request-a-token' in 'articles/active-directory-b2c/access-tokens.md'.

articles/active-directory-b2c/openid-connect.md

  • Line 153, Column 213: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#request-a-token' in 'articles/active-directory-b2c/access-tokens.md'.

articles/app-service/app-service-asp-net-migration.md

  • Line 0, Column 0: [Warning: h1-missing - See documentation] H1 is required. Use a single hash (#) followed by a space to create your top-level heading.
  • Line 1, Column 1: [Warning: author-missing - See documentation] Missing required attribute: 'author'. Add the current author's GitHub ID.
  • Line 1, Column 1: [Warning: title-missing - See documentation] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Warning: ms-author-missing - See documentation] Missing required attribute: 'ms.author'. Add the current author's Microsoft alias.
  • Line 1, Column 1: [Warning: ms-topic-missing - See documentation] Missing required attribute: 'ms.topic'.
  • Line 1, Column 1: [Suggestion: ms-date-missing - See documentation] Missing required attribute: 'ms.date'.
  • Line 1, Column 1: [Suggestion: description-missing - See documentation] Missing required attribute: 'description'.

articles/app-service/app-service-key-vault-references.md

  • Line 37, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Grant your app access to a key vault') are not allowed. You can only have one top-level heading.
  • Line 82, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Access network-restricted vaults') are not allowed. You can only have one top-level heading.
  • Line 116, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Access vaults with a user-assigned identity') are not allowed. You can only have one top-level heading.
  • Line 174, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Understand rotation') are not allowed. You can only have one top-level heading.
  • Line 198, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Use Key Vault references in app settings') are not allowed. You can only have one top-level heading.
  • Line 238, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Considerations for Azure Files mounting') are not allowed. You can only have one top-level heading.
  • Line 259, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Considerations for Application Insights') are not allowed. You can only have one top-level heading.
  • Line 274, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Azure Resource Manager deployment') are not allowed. You can only have one top-level heading.
  • Line 323, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Troubleshoot Key Vault references') are not allowed. You can only have one top-level heading.
  • Line 342, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Diagnose issues in Azure portal') are not allowed. You can only have one top-level heading.
  • Line 368, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Best practices') are not allowed. You can only have one top-level heading.
  • Line 380, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Summary') are not allowed. You can only have one top-level heading.

articles/app-service/configure-language-java-security.md

  • Line 85, Column 125: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#source-app-settings-from-key-vault' in 'articles/app-service/app-service-key-vault-references.md'.

articles/app-service/includes/configure-azure-storage/azure-storage-linux-container-pivot.md

  • Line 92, Column 33: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#source-app-settings-from-key-vault' in 'articles/app-service/app-service-key-vault-references.md'.

articles/app-service/includes/configure-azure-storage/azure-storage-windows-code-pivot.md

  • Line 85, Column 40: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#source-app-settings-from-key-vault' in 'articles/app-service/app-service-key-vault-references.md'.

articles/app-service/includes/configure-azure-storage/azure-storage-windows-container-pivot.md

  • Line 86, Column 39: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#source-app-settings-from-key-vault' in 'articles/app-service/app-service-key-vault-references.md'.

This comment lists only the first 25 errors (including error/warning/suggestion) in the pull request.
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.

Expanded the README file to provide detailed guidance on contributing to Microsoft Azure documentation, including sections on prerequisites, contribution workflow, documentation standards, and additional resources.
Strengthen contributor onboarding by enhancing Azure documentation README
@prmerger-automator
Copy link
Copy Markdown
Contributor

@tanvishinde017 : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

Strengthen contributor onboarding by enhancing Azure documentation README
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit a6b51a9:

⚠️ Validation status: warnings

File Status Preview URL Details
articles/active-directory-b2c/authorization-code-flow.md ⚠️Warning Details
articles/active-directory-b2c/openid-connect.md ⚠️Warning Details
articles/app-service/app-service-asp-net-migration.md ⚠️Warning Details
articles/app-service/app-service-key-vault-references.md ⚠️Warning Details
articles/app-service/configure-language-java-security.md ⚠️Warning Details
articles/app-service/includes/configure-azure-storage/azure-storage-linux-container-pivot.md ⚠️Warning Details
articles/app-service/includes/configure-azure-storage/azure-storage-windows-code-pivot.md ⚠️Warning Details
articles/app-service/includes/configure-azure-storage/azure-storage-windows-container-pivot.md ⚠️Warning Details
articles/app-service/tutorial-networking-isolate-vnet.md ⚠️Warning Details
articles/app-testing/overview-what-is-azure-app-testing.md ⚠️Warning Details
articles/azure-functions/errors-diagnostics/diagnostic-events/azfd0002.md ⚠️Warning Details
articles/active-directory-b2c/access-tokens.md 💡Suggestion Details
articles/api-center/agent-to-agent-overview.md ✅Succeeded
articles/app-service/app-service-plan-manage.md ✅Succeeded
articles/app-service/wordpress-faq.md ✅Succeeded
articles/app-testing/index.yml ✅Succeeded

articles/active-directory-b2c/authorization-code-flow.md

  • Line 116, Column 189: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#request-a-token' in 'articles/active-directory-b2c/access-tokens.md'.

articles/active-directory-b2c/openid-connect.md

  • Line 153, Column 213: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#request-a-token' in 'articles/active-directory-b2c/access-tokens.md'.

articles/app-service/app-service-asp-net-migration.md

  • Line 0, Column 0: [Warning: h1-missing - See documentation] H1 is required. Use a single hash (#) followed by a space to create your top-level heading.
  • Line 1, Column 1: [Warning: author-missing - See documentation] Missing required attribute: 'author'. Add the current author's GitHub ID.
  • Line 1, Column 1: [Warning: title-missing - See documentation] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Warning: ms-author-missing - See documentation] Missing required attribute: 'ms.author'. Add the current author's Microsoft alias.
  • Line 1, Column 1: [Warning: ms-topic-missing - See documentation] Missing required attribute: 'ms.topic'.
  • Line 1, Column 1: [Suggestion: ms-date-missing - See documentation] Missing required attribute: 'ms.date'.
  • Line 1, Column 1: [Suggestion: description-missing - See documentation] Missing required attribute: 'description'.

articles/app-service/app-service-key-vault-references.md

  • Line 37, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Grant your app access to a key vault') are not allowed. You can only have one top-level heading.
  • Line 82, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Access network-restricted vaults') are not allowed. You can only have one top-level heading.
  • Line 116, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Access vaults with a user-assigned identity') are not allowed. You can only have one top-level heading.
  • Line 174, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Understand rotation') are not allowed. You can only have one top-level heading.
  • Line 198, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Use Key Vault references in app settings') are not allowed. You can only have one top-level heading.
  • Line 238, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Considerations for Azure Files mounting') are not allowed. You can only have one top-level heading.
  • Line 259, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Considerations for Application Insights') are not allowed. You can only have one top-level heading.
  • Line 274, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Azure Resource Manager deployment') are not allowed. You can only have one top-level heading.
  • Line 323, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Troubleshoot Key Vault references') are not allowed. You can only have one top-level heading.
  • Line 342, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Diagnose issues in Azure portal') are not allowed. You can only have one top-level heading.
  • Line 368, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Best practices') are not allowed. You can only have one top-level heading.
  • Line 380, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Summary') are not allowed. You can only have one top-level heading.

articles/app-service/configure-language-java-security.md

  • Line 85, Column 125: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#source-app-settings-from-key-vault' in 'articles/app-service/app-service-key-vault-references.md'.

articles/app-service/includes/configure-azure-storage/azure-storage-linux-container-pivot.md

  • Line 92, Column 33: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#source-app-settings-from-key-vault' in 'articles/app-service/app-service-key-vault-references.md'.

articles/app-service/includes/configure-azure-storage/azure-storage-windows-code-pivot.md

  • Line 85, Column 40: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#source-app-settings-from-key-vault' in 'articles/app-service/app-service-key-vault-references.md'.

articles/app-service/includes/configure-azure-storage/azure-storage-windows-container-pivot.md

  • Line 86, Column 39: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#source-app-settings-from-key-vault' in 'articles/app-service/app-service-key-vault-references.md'.

This comment lists only the first 25 errors (including error/warning/suggestion) in the pull request.
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.

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 992ae1f:

⚠️ Validation status: warnings

File Status Preview URL Details
articles/active-directory-b2c/authorization-code-flow.md ⚠️Warning Details
articles/active-directory-b2c/openid-connect.md ⚠️Warning Details
articles/app-service/app-service-asp-net-migration.md ⚠️Warning Details
articles/app-service/app-service-key-vault-references.md ⚠️Warning Details
articles/app-service/configure-language-java-security.md ⚠️Warning Details
articles/app-service/includes/configure-azure-storage/azure-storage-linux-container-pivot.md ⚠️Warning Details
articles/app-service/includes/configure-azure-storage/azure-storage-windows-code-pivot.md ⚠️Warning Details
articles/app-service/includes/configure-azure-storage/azure-storage-windows-container-pivot.md ⚠️Warning Details
articles/app-service/tutorial-networking-isolate-vnet.md ⚠️Warning Details
articles/app-testing/overview-what-is-azure-app-testing.md ⚠️Warning Details
articles/azure-functions/errors-diagnostics/diagnostic-events/azfd0002.md ⚠️Warning Details
articles/active-directory-b2c/access-tokens.md 💡Suggestion Details
articles/api-center/agent-to-agent-overview.md ✅Succeeded
articles/app-service/app-service-plan-manage.md ✅Succeeded
articles/app-service/wordpress-faq.md ✅Succeeded
articles/app-testing/index.yml ✅Succeeded
README.md ✅Succeeded

articles/active-directory-b2c/authorization-code-flow.md

  • Line 116, Column 189: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#request-a-token' in 'articles/active-directory-b2c/access-tokens.md'.

articles/active-directory-b2c/openid-connect.md

  • Line 153, Column 213: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#request-a-token' in 'articles/active-directory-b2c/access-tokens.md'.

articles/app-service/app-service-asp-net-migration.md

  • Line 0, Column 0: [Warning: h1-missing - See documentation] H1 is required. Use a single hash (#) followed by a space to create your top-level heading.
  • Line 1, Column 1: [Warning: author-missing - See documentation] Missing required attribute: 'author'. Add the current author's GitHub ID.
  • Line 1, Column 1: [Warning: title-missing - See documentation] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Warning: ms-author-missing - See documentation] Missing required attribute: 'ms.author'. Add the current author's Microsoft alias.
  • Line 1, Column 1: [Warning: ms-topic-missing - See documentation] Missing required attribute: 'ms.topic'.
  • Line 1, Column 1: [Suggestion: ms-date-missing - See documentation] Missing required attribute: 'ms.date'.
  • Line 1, Column 1: [Suggestion: description-missing - See documentation] Missing required attribute: 'description'.

articles/app-service/app-service-key-vault-references.md

  • Line 37, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Grant your app access to a key vault') are not allowed. You can only have one top-level heading.
  • Line 82, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Access network-restricted vaults') are not allowed. You can only have one top-level heading.
  • Line 116, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Access vaults with a user-assigned identity') are not allowed. You can only have one top-level heading.
  • Line 174, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Understand rotation') are not allowed. You can only have one top-level heading.
  • Line 198, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Use Key Vault references in app settings') are not allowed. You can only have one top-level heading.
  • Line 238, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Considerations for Azure Files mounting') are not allowed. You can only have one top-level heading.
  • Line 259, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Considerations for Application Insights') are not allowed. You can only have one top-level heading.
  • Line 274, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Azure Resource Manager deployment') are not allowed. You can only have one top-level heading.
  • Line 323, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Troubleshoot Key Vault references') are not allowed. You can only have one top-level heading.
  • Line 342, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Diagnose issues in Azure portal') are not allowed. You can only have one top-level heading.
  • Line 368, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Best practices') are not allowed. You can only have one top-level heading.
  • Line 380, Column 1: [Warning: multiple-h1s - See documentation] Multiple H1s(H1 'Summary') are not allowed. You can only have one top-level heading.

articles/app-service/configure-language-java-security.md

  • Line 85, Column 125: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#source-app-settings-from-key-vault' in 'articles/app-service/app-service-key-vault-references.md'.

articles/app-service/includes/configure-azure-storage/azure-storage-linux-container-pivot.md

  • Line 92, Column 33: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#source-app-settings-from-key-vault' in 'articles/app-service/app-service-key-vault-references.md'.

articles/app-service/includes/configure-azure-storage/azure-storage-windows-code-pivot.md

  • Line 85, Column 40: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#source-app-settings-from-key-vault' in 'articles/app-service/app-service-key-vault-references.md'.

articles/app-service/includes/configure-azure-storage/azure-storage-windows-container-pivot.md

  • Line 86, Column 39: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#source-app-settings-from-key-vault' in 'articles/app-service/app-service-key-vault-references.md'.

This comment lists only the first 25 errors (including error/warning/suggestion) in the pull request.
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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment