From aaba4cb3db3542492a1acd9b7200277905381fec Mon Sep 17 00:00:00 2001
From: squidfunk <martin.donath@squidfunk.com>
Date: Sat, 2 Oct 2021 15:24:09 +0200
Subject: [PATCH] Updated content tabs documentation

---
 docs/reference/content-tabs.md | 27 +++++++++++++++++++++++----
 1 file changed, 23 insertions(+), 4 deletions(-)

diff --git a/docs/reference/content-tabs.md b/docs/reference/content-tabs.md
index 8d77894dd..972532379 100644
--- a/docs/reference/content-tabs.md
+++ b/docs/reference/content-tabs.md
@@ -18,10 +18,29 @@ grouping code blocks and other content.
 The [Tabbed][2] extension, which is part of [Python Markdown Extensions][3],
 integrates with Material for MkDocs and can be enabled via `mkdocs.yml`:
 
-``` yaml
-markdown_extensions:
-  - pymdownx.tabbed
-```
+=== "Modern"
+
+    ``` yaml
+    markdown_extensions:
+      - pymdownx.tabbed:
+          alternate_style: true # (1)
+    ```
+
+    1. As of 7.3.1, support was added for the new [`alternate_style`][12] flag,
+       which has much better behavior on smaller screen sizes, as content tabs
+       are now scrollable and will overflow instead of break across multiple
+       lines.
+
+        __The legacy style will be deprecated with the next major release.__
+
+  [12]: https://facelessuser.github.io/pymdown-extensions/extensions/tabbed/#alternate-style
+
+=== "Legacy"
+
+    ``` yaml
+    markdown_extensions:
+      - pymdownx.tabbed
+    ```
 
   [1]: https://github.com/squidfunk/mkdocs-material/blob/master/src/assets/stylesheets/main/extensions/pymdownx/_tabbed.scss
   [2]: https://facelessuser.github.io/pymdown-extensions/extensions/tabbed/