Add disclaimer that flatteing is not recommended anymore (#4908)

Azure · May 28, 2024 · 4ddb583 · 4ddb583
1 parent 961b09d
commit 4ddb583
Showing 1 changed file with 2 additions and 0 deletions.
diff --git a/docs/extensions/readme.md b/docs/extensions/readme.md
@@ -467,6 +467,8 @@ Swagger 2.0 specification requires that when used, the value of `discriminator`
 
 ## x-ms-client-flatten
 
+Note: This extension is not recommended anymore, and will be refused in Swagger reviews going forward. This is kept for legacy only for SDK that have done a stable SDK release.
+
 This extension allows to flatten deeply nested payloads into a more user friendly object. For example a payload that looks like this on the wire:
 
 ```json5