diff --git a/doc/telescope.txt b/doc/telescope.txt
index 67c0da4..5d4dd64 100644
--- a/doc/telescope.txt
+++ b/doc/telescope.txt
@@ -1563,6 +1563,22 @@ themes.get_ivy()                                            *themes.get_ivy()*
 ================================================================================
                                                               *telescope.layout*
 
+The layout of telescope pickers can be adjusted using the
+|telescope.defaults.layout_strategy| and |telescope.defaults.layout_config|
+options. For example, the following configuration changes the default layout
+strategy and the default size of the picker:
+>
+  require('telescope').setup{
+    defaults = {
+      layout_strategy = 'vertical',
+      layout_config = { height = 0.95 },
+    },
+  }
+<
+
+
+────────────────────────────────────────────────────────────────────────────────
+
 Layout strategies are different functions to position telescope.
 
 All layout strategies are functions with the following signature:
diff --git a/lua/telescope/pickers/layout_strategies.lua b/lua/telescope/pickers/layout_strategies.lua
index c0692be..75ce032 100644
--- a/lua/telescope/pickers/layout_strategies.lua
+++ b/lua/telescope/pickers/layout_strategies.lua
@@ -1,6 +1,20 @@
 ---@tag telescope.layout
 
 ---@brief [[
+--- The layout of telescope pickers can be adjusted using the
+--- |telescope.defaults.layout_strategy| and |telescope.defaults.layout_config| options.
+--- For example, the following configuration changes the default layout strategy and the
+--- default size of the picker:
+--- <code>
+---   require('telescope').setup{
+---     defaults = {
+---       layout_strategy = 'vertical',
+---       layout_config = { height = 0.95 },
+---     },
+---   }
+--- </code>
+---
+--- ────────────────────────────────────────────────────────────────────────────────
 ---
 --- Layout strategies are different functions to position telescope.
 ---