MicrosoftDocs/architecture-center/docs/best-practices

PNP Edit: [FRESHNESS] Scheduler agent supervisor - ph4 (#16773) * first draft * Apply engineering review fixes: WAF service guide links, consolidate alternatives, lint fix * Address reviewer feedback: fix blank first line, dangling Process Manager reference, add missing links, remove duplicate Implementation-in-Azure section, de-technologize two notes * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Chad Kittel <chad.kittel@gmail.com> * Some minor changes as part of review * Adjust solution a bit and dedup * Final touches before review * Update metadata * Apply batched suggestions from code review Co-authored-by: Chad Kittel <chad.kittel@gmail.com> * Enhance documentation on Agent and Scheduler behavior Clarified the Agent's behavior regarding retry logic and handling of timeouts. Added details on how the Scheduler and Supervisor manage steps that have timed out or failed. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Typo fix * convert * edits * edits * touchups * fix dupe headings * peer review cx * edit * add line ending to force display? * fix * some edits * fix * Update docs/patterns/scheduler-agent-supervisor.md * Update docs/patterns/scheduler-agent-supervisor.md Co-authored-by: learn-build-service-prod-10[bot] <274431553+learn-build-service-prod-10[bot]@users.noreply.github.com> --------- Co-authored-by: Anastasia Harris <61602255+anaharris-ms@users.noreply.github.com> Co-authored-by: Chad Kittel <chad.kittel@gmail.com> Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: learn-build-service-prod-10[bot] <274431553+learn-build-service-prod-10[bot]@users.noreply.github.com>

PnP edit: Health Endpoint Monitoring pattern (#16771) * first draft * Update docs/patterns/health-endpoint-monitoring-content.md * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Address Health Endpoint Monitoring review feedback * Address follow-up health monitoring safety and attestation findings * Improve health endpoint monitoring documentation Refine health endpoint monitoring content for clarity and security recommendations. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Edit pass before review * Fix typos * Apply batched suggestions from code review Co-authored-by: Chad Kittel <chad.kittel@gmail.com> * Apply batched suggestions from code review Co-authored-by: Chad Kittel <chad.kittel@gmail.com> * Apply suggestion from @ckittel * convert to md only * broken links * edits * edits * edits * edit * edit * edits --------- Co-authored-by: Anastasia Harris <61602255+anaharris-ms@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Chad Kittel <chad.kittel@gmail.com>

PnP edit: Index Table pattern (#16765) * first draft * Apply suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Address Index Table review feedback * Use image directive for Index Table diagram * Apply Index Table style suggestions * Finish Index Table style cleanup * Address remaining Index Table review comments * Improve Index Table article coherence * Clarify composite index key encoding * minor changes before review * Additional updates * Apply suggestion from @ckittel * Apply suggestion from @ckittel * Apply batched suggestions from code review Co-authored-by: Chad Kittel <chad.kittel@gmail.com> * Convert YAML and Markdown to Markdown only; update references to YAML file * Do P4 edits * Expand long description to meet the 300-character minimum Expand a complex-image description so that it meets the repository’s 300-character minimum. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Address Copilot feedback: improve long descriptions; clarify stale references * Address Copilot feedback: clarify language Clarify language about queries and records. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Do peer review edits: adjust wording, correct typo, and add ellipses to long descriptions * Change image type to complex Change image type to complex so it can include a long description. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Anastasia Harris <61602255+anaharris-ms@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Chad Kittel <chad.kittel@gmail.com>

PnP edit: Materialized View pattern (#16739) * first draft * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Address materialized view review feedback * Address remaining materialized view feedback * Minor tweaks before review * Apply batched suggestions from code review Co-authored-by: Chad Kittel <chad.kittel@gmail.com> * Apply batched suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Restore cross-partition Materialized View example * convert to md only * links * edits * edit * edit * remove file accidentally added * edits --------- Co-authored-by: Anastasia Harris <61602255+anaharris-ms@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Chad Kittel <chad.kittel@gmail.com>

Use lightboxes where it helps (#16737) Aligns image lightbox usage with the width of the image a reader opens (threshold: strictly greater than 688 pixels). Removes lightbox attributes from 21 images at or below the threshold and adds one lightbox attribute to an image above it. Co-authored-by: azure-patterns-practices-assistant[bot] <316226753+azure-patterns-practices-assistant[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

[lightbox-janitor] Correct image lightboxes by intrinsic width (#16693) * Correct image lightboxes by intrinsic width Add or remove the lightbox attribute on :::image directives so lightboxes are only present for images wider than 688 pixels. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix alt-text: add periods and graphic type prefixes per PR review Co-authored-by: ckittel <671075+ckittel@users.noreply.github.com> --------- Co-authored-by: azure-patterns-practices-assistant[bot] <316226753+azure-patterns-practices-assistant[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: ckittel <671075+ckittel@users.noreply.github.com>

Convert more images to :::image format

Fix redirected links in 3 articles Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Apply suggestions from code review Co-authored-by: learn-build-service-prod-05[bot] <274429479+learn-build-service-prod-05[bot]@users.noreply.github.com>

Fix redirecting links in best-practices articles Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Fix redirecting and outdated links in auto-scaling and background-jobs articles Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Apply suggestions from code review Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com>

Fix redirecting and stale-anchor links in 3 AAC articles Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Align CDN best practices guidance with Azure Front Door (#16341) * Initial plan * Align CDN best practices with Azure Front Door Co-authored-by: ckittel <671075+ckittel@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Correct AFD origin and query-string versioning guidance in CDN best practices Co-authored-by: ckittel <671075+ckittel@users.noreply.github.com> * Minor tweaks * Apply suggestion from @learn-build-service-prod-08[bot] Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: ckittel <671075+ckittel@users.noreply.github.com> Co-authored-by: Chad Kittel <chad.kittel@gmail.com> Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com>

Modernize data collection guidance to Azure Monitor Agent Co-authored-by: ckittel <671075+ckittel@users.noreply.github.com>

Modernize web API hosting options in API Management section Co-authored-by: ckittel <671075+ckittel@users.noreply.github.com>

[New] New Design Pattern: Idempotent Consumer pattern (#16314) * Add article * Link to the new page * Remove links to the Mission Ctricial content * Apply suggestions from code review Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: John Downs <john@johndowns.co.nz> * Apply suggestion from @ckittel * Update docs/patterns/idempotent-consumer.md Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Clayton Siemens <84867658+claytonsiemens77@users.noreply.github.com> --------- Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: John Downs <john@johndowns.co.nz> Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com> Co-authored-by: Clayton Siemens <84867658+claytonsiemens77@users.noreply.github.com>

PNP Edit: Priority Queue pattern (#16253) * edit * in progress * edits * ai * diagram * try fix * try another fix * peer review cx * replace svg * try again svg * try again * . * . * touchup

Provide links into new article (#16105) * Provide links into new article * Apply suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

[SCOPED] Quality check: Acrolinx edits 3 (#15767) * edits * Apply suggestions from code review Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> --------- Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com>