## History

<details>
  <summary>Expand change history</summary>

| Date        | Notes                                                          |
| ----------- | -------------------------------------------------------------- |
| 2025-Mar-28 | Added guidelines about JSON ID and null values                 |
| 2024-Mar-17 | Updated LRO guidelines                                         |
| 2024-Jan-17 | Added guidelines on returning string offsets & lengths         |
| 2023-May-12 | Explain service response for missing/unsupported `api-version` |
| 2023-Apr-21 | Update/clarify guidelines on POST method repeatability         |
| 2023-Apr-07 | Update/clarify guidelines on polymorphism                      |
| 2022-Sep-07 | Updated URL guidelines for DNS Done Right                      |
| 2022-Jul-15 | Update guidance on long-running operations                     |
| 2022-May-11 | Drop guidance on version discovery                             |
| 2022-Mar-29 | Add guidelines about using durations                           |
| 2022-Mar-25 | Update guideline for date values in headers to follow RFC 7231 |
| 2022-Feb-01 | Updated error guidance                                         |
| 2021-Sep-11 | Add long-running operations guidance                           |
| 2021-Aug-06 | Updated Azure REST Guidelines per Azure API Stewardship Board. |
| 2020-Jul-31 | Added service advice for initial versions                      |
| 2020-Mar-31 | 1st public release of the Azure REST API Guidelines            |

</details>