Update plugin docs

Author: dasvh

doc/taskfile.nvim.txt

@@ -1,4 +1,4 @@
-*taskfile.nvim.txt*     For Neovim >= 0.8.0     Last change: 2025 September 15
+*taskfile.nvim.txt*     For Neovim >= 0.8.0     Last change: 2025 September 22
 
 ==============================================================================
 Table of Contents                            *taskfile.nvim-table-of-contents*
@@ -26,8 +26,12 @@ FEATURES                                *taskfile.nvim-taskfile.nvim-features*
 - Run tasks in a floating terminal
 - Automatically scroll to bottom of output (optional)
 - Rerun last task via command or key-map
-- Flexible layout with width_ratio or auto-sizing to fit
-    task names and descriptions neatly
+- Flexible layouts:
+    - **Horizontal**task list and preview side-by-side
+    - **Vertical**task list stacked above preview
+- Configurable `width_ratio` / `height_ratio` or automatic sizing
+    to neatly fit task names and descriptions
+- Toggle between horizontal and vertical layouts at runtime
 
 
 REQUIREMENTS                        *taskfile.nvim-taskfile.nvim-requirements*
@@ -55,6 +59,9 @@ fields are optional and shown below with their default values:
 
 >lua
     require('taskfile').setup({
+      layout = "horizontal", -- Layout: 'h', 'horiz', 'horizontal' or 'v', 'vert', 'vertical'.
+                             -- For 'horizontal' layout, list and preview are side-by-side.
+                             -- For 'vertical', list is above preview (vertically stacked).
       windows = {
         output = {           -- Task output window
           width = 0.8,       -- Width of the window (percentage of editor width)
@@ -64,11 +71,18 @@ fields are optional and shown below with their default values:
         list = {             -- Task list and preview window
           width = 0.6,
           height = 0.4,
-          border = "rounded"
+          border = "rounded",
+          -- only used for horizontal layout
           width_ratio = 0,   -- Ratio (0–1) of list vs preview width.
                              -- If set, determines how much space is given to the list.
                              -- If unset or 0, the list width is calculated to fit
                              -- longest task name and description without wrapping.
+          -- only used for vertical layout
+          height_ratio = 0,  -- Ratio (0–1) of list vs preview height.
+                             -- If set, determines how much space is given to the list.
+                             -- If unset or 0, the list height is calculated to fit
+                             -- the rendered task lines (name + description),
+                             -- wrapping as needed, without overflow.
         },
       },
       scroll = {
@@ -91,6 +105,8 @@ COMMANDS ~
 - `:Task <task_name>`Run a specific task by name
 - `:Task`Show a floating task selector with preview
 - `:TaskRerun`Rerun the last executed task
+- `:TaskToggleLayout`Toggles the layout for the current Neovim session.
+    On restart, it resets to your configured default.
 
 You can also bind a key to rerun using the `keymaps.rerun` config.