Skip to content

Application Gateway | Top 5 CSS Issues updates to migrated docs#2025

Open
mbender-ms wants to merge 2 commits intoMicrosoftDocs:mainfrom
mbender-ms:fact-check/application-gateway-css-updates-2026-03
Open

Application Gateway | Top 5 CSS Issues updates to migrated docs#2025
mbender-ms wants to merge 2 commits intoMicrosoftDocs:mainfrom
mbender-ms:fact-check/application-gateway-css-updates-2026-03

Conversation

@mbender-ms
Copy link

Summary

Fact-check and edit Application Gateway troubleshooting docs based on customer feedback report and top CSS issues.

Changes (14 edits across 5 files)

http-response-codes.md (7 changes)

  • Fixed 303 response code description (was incorrectly referencing 302)
  • Fixed 'storage blog' typo to 'storage blob' and grammar correction
  • Added missing 503 Service Unavailable section with causes and troubleshooting
  • Added TLS handshake failure note covering TLS 1.0/1.1 deprecation (Aug 2025)
  • Added WAF false positive troubleshooting steps to 403 section (5-step remediation)
  • Updated ms.date

log-analytics.md (2 changes)

  • Fixed 'WAK SKU' typo to 'WAF SKU'
  • Updated ms.date

create-gateway-internal-load-balancer-app-service-environment.md (2 changes)

  • Fixed ms.service from azure-vpn-gateway to azure-application-gateway
  • Updated ms.date

application-gateway-key-vault-common-errors.md (1 change)

  • Updated ms.date (was 3.5 years stale)

ingress-controller-troubleshoot.md (2 changes)

  • Fixed Kubernetes Ingress YAML for networking.k8s.io/v1 format
  • Updated ms.date

CSS Issue Coverage

Issue Coverage
Frequent 5xx errors (502/503) 502 article + new 503 section + backend health article
SSL/TLS certificate setup issues Key Vault errors + mutual auth + backend health + new TLS handshake note
WAF false positives blocking traffic New 403 troubleshooting steps + log-analytics WAF queries

AB#552416

…rage

- Fix 303 response code description (was incorrectly referencing 302)
- Fix 'storage blog' typo to 'storage blob' and grammar correction
- Add missing 503 Service Unavailable section with causes and troubleshooting
- Fix 'WAK SKU' typo to 'WAF SKU' in log-analytics.md
- Fix ms.service from azure-vpn-gateway to azure-application-gateway
- Fix Kubernetes Ingress YAML for networking.k8s.io/v1 format
- Add TLS handshake failure note (TLS 1.0/1.1 deprecation)
- Add WAF false positive troubleshooting steps to 403 section
- Update ms.date on all modified files
- Add ts-updates summary document

AB#552416
@prmerger-automator
Copy link

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

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 97a3382:

⚠️ Validation status: warnings

File Status Preview URL Details
support/azure/application-gateway/ts-updates-03052026.md ⚠️Warning Details
support/azure/application-gateway/application-gateway-key-vault-common-errors.md ✅Succeeded
support/azure/application-gateway/create-gateway-internal-load-balancer-app-service-environment.md ✅Succeeded
support/azure/application-gateway/http-response-codes.md ✅Succeeded
support/azure/application-gateway/ingress-controller-troubleshoot.md ✅Succeeded
support/azure/application-gateway/log-analytics.md ✅Succeeded

support/azure/application-gateway/ts-updates-03052026.md

  • 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: [Suggestion: ms-date-missing - See documentation] Missing required attribute: 'ms.date'.
  • Line 1, Column 1: [Suggestion: description-missing - See documentation] Missing required attribute: 'description'.
  • Line 1, Column 1: [Suggestion: ms-service-suggested] Missing required attribute: 'ms.service'. ms.service is suggested for each article that is published on Learn.
  • Line 51, Column 48: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/azure/application-gateway/http-response-codes' will be broken in isolated environments. Replace with a relative link.
  • Line 52, Column 44: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/azure/application-gateway/custom-error' will be broken in isolated environments. Replace with a relative link.
  • Line 53, Column 36: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/troubleshoot/azure/application-gateway/application-gateway-backend-health-troubleshooting' will be broken in isolated environments. Replace with a relative link.
  • Line 54, Column 38: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/azure/web-application-firewall/ag/ag-overview' will be broken in isolated environments. Replace with a relative link.
  • Line 56, Column 41: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/azure/storage/common/storage-network-security' will be broken in isolated environments. Replace with a relative link.
  • Line 57, Column 45: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/azure/application-gateway/application-gateway-ssl-policy-overview' will be broken in isolated environments. Replace with a relative link.
  • Line 58, Column 53: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/azure/application-gateway/application-gateway-configure-ssl-policy-powershell' will be broken in isolated environments. Replace with a relative link.
  • Line 59, Column 46: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/azure/web-application-firewall/ag/web-application-firewall-troubleshoot' will be broken in isolated environments. Replace with a relative link.
  • Line 60, Column 25: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/azure/web-application-firewall/ag/application-gateway-waf-configuration' will be broken in isolated environments. Replace with a relative link.
  • Line 61, Column 48: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/azure/web-application-firewall/ag/best-practices' will be broken in isolated environments. Replace with a relative link.

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.

@mbender-ms mbender-ms changed the title Fact-check Application Gateway docs: fix errors, add 503/TLS/WAF coverage Application Gateway | Top 5 CSS Issues updates to migrated docs Mar 5, 2026
@learn-build-service-prod
Copy link
Contributor

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants