Skip to content

Commit 8c25785

Browse files
troy0820mikekistler
authored andcommitted
fix link for breaking change documentation vanity link
Signed-off-by: Troy Connor <[email protected]>
1 parent 90e9ca6 commit 8c25785

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

azure/Guidelines.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Please ensure that you add an anchor tag to any new guidelines that you add and
1313

1414
<details>
1515
<summary>Expand change history</summary>
16-
16+
1717
| Date | Notes |
1818
| ----------- | -------------------------------------------------------------- |
1919
| 2023-May-12 | Explain service response for missing/unsupported `api-version` |
@@ -749,7 +749,7 @@ Azure services need to change over time. However, when changing a service, there
749749
1. Already-running customer workloads must not break due to a service change
750750
2. Customers can adopt a new service version without requiring any code changes (Of course, the customer must modify code to leverage any new service features.)
751751

752-
*NOTE: the [Azure Breaking Change Policy](http://aka.ms/AzBreakingChangesPolicy/) has tables (section 5) describing what kinds of changes are considered breaking. Breaking changes are allowable (due to security/compliance/etc.) if approved by the [Azure Breaking Change Reviewers](mailto:[email protected]) but only following ample communication to customers and a lengthy deprecation period.*
752+
*NOTE: the [Azure Breaking Change Policy](http://aka.ms/AzBreakingChangesPolicy) has tables (section 5) describing what kinds of changes are considered breaking. Breaking changes are allowable (due to security/compliance/etc.) if approved by the [Azure Breaking Change Reviewers](mailto:[email protected]) but only following ample communication to customers and a lengthy deprecation period.*
753753

754754
<a href="#versioning-review-required" name="versioning-review-required">:white_check_mark:</a> **DO** review any API changes with the Azure API Stewardship Board
755755

@@ -809,7 +809,7 @@ When the [API Versioning](#api-versioning) guidance above cannot be followed and
809809

810810
The purpose is to inform customers (when debugging/logging responses) that they must take action to modify their call to the service's operation and use a newer API version or their call will soon stop working entirely. It is not expected that client code will examine/parse this header's value in any way; it is purely informational to a human being. The string is _not_ part of an API contract (except for the semi-colon delimiters) and may be changed/improved at any time without incurring a breaking change.
811811

812-
<a href="#deprecation-header" name="deprecation-header">:white_check_mark:</a> **DO** include the `azure-deprecating` header in the operation's response _only if_ the operation will stop working in the future and the client _must take_ action in order for it to keep working.
812+
<a href="#deprecation-header" name="deprecation-header">:white_check_mark:</a> **DO** include the `azure-deprecating` header in the operation's response _only if_ the operation will stop working in the future and the client _must take_ action in order for it to keep working.
813813
> NOTE: We do not want to scare customers with this header.
814814
815815
<a href="#deprecation-header-value" name="deprecation-header-value">:white_check_mark:</a> **DO** make the header's value a semicolon-delimited string indicating a set of deprecations where each one indicates what is deprecating, when it is deprecating, and a URL to more information.

0 commit comments

Comments
 (0)