From 755ca2c7f5555f29718d6b3fdae6e87fdac7a31b Mon Sep 17 00:00:00 2001
From: alexander-akait <4567934+alexander-akait@users.noreply.github.com>
Date: Sun, 28 Jun 2026 01:10:59 +0000
Subject: [PATCH] docs: update

---
 OPTIONS.md          | 23 ++++++++++++++---------
 SERVE-OPTIONS-v5.md | 20 +++++++++++++-------
 2 files changed, 27 insertions(+), 16 deletions(-)

diff --git a/OPTIONS.md b/OPTIONS.md
index 8cdf9fcff24..fa7390e7983 100644
--- a/OPTIONS.md
+++ b/OPTIONS.md
@@ -1,10 +1,13 @@
 ```
-Usage: webpack [entries...] [options]
-Alternative usage to run commands: webpack [command] [options]
 
+⬡ webpack
+────────────────────────────────────────────────────────────────────────
 The build tool for modern web applications.
 
-Options:
+Usage: webpack [entries...] [options] | webpack [command] [options]
+
+Options
+────────────────────────────────────────────────────────────────────────
   -c, --config <pathToConfigFile...>                                                 Provide path to one or more webpack configuration files to process, e.g. "./webpack.config.js".
   --config-name <name...>                                                            Name(s) of particular configuration(s) to use if configuration file exports an array of multiple configurations.
   -m, --merge                                                                        Merge two or more configurations using 'webpack-merge'.
@@ -1383,13 +1386,15 @@ Options:
   --watch-options-stdin                                                              Stop watching when stdin stream has ended.
   --no-watch-options-stdin                                                           Negative 'watch-options-stdin' option.
 
-Global options:
+Global options
+────────────────────────────────────────────────────────────────────────
   --color                                                                            Enable colors on console.
   --no-color                                                                         Disable colors on console.
   -v, --version                                                                      Output the version number of 'webpack', 'webpack-cli' and 'webpack-dev-server' and other packages.
   -h, --help [verbose]                                                               Display help for commands and options.
 
-Commands:
+Commands
+────────────────────────────────────────────────────────────────────────
   build|bundle|b [entries...] [options]                                              Run webpack (default command, can be omitted).
   configtest|t [config-path]                                                         Validate a webpack configuration.
   help|h [command] [option]                                                          Display help for commands and options.
@@ -1398,9 +1403,9 @@ Commands:
   version|v [options]                                                                Output the version number of 'webpack', 'webpack-cli' and 'webpack-dev-server' and other packages.
   watch|w [entries...] [options]                                                     Run webpack and watch for files changes.
 
-To see list of all supported commands and options run 'webpack --help=verbose'.
+────────────────────────────────────────────────────────────────────────
 
-Webpack documentation: https://webpack.js.org/.
-CLI documentation: https://webpack.js.org/api/cli/.
-Made with ♥ by the webpack team.
+Webpack documentation:  https://webpack.js.org/
+CLI documentation:      https://webpack.js.org/api/cli/
+Made with ♥ by the webpack team
 ```
diff --git a/SERVE-OPTIONS-v5.md b/SERVE-OPTIONS-v5.md
index e4b0c61d0ec..f05f4e2b931 100644
--- a/SERVE-OPTIONS-v5.md
+++ b/SERVE-OPTIONS-v5.md
@@ -1,9 +1,13 @@
 ```
-Usage: webpack serve|server|s [entries...] [options]
 
+⬡ webpack serve
+────────────────────────────────────────────────────────────────────────
 Run the webpack dev server and watch for source file changes while serving.
 
-Options:
+Usage: webpack serve|server|s [entries...] [options]
+
+Options
+────────────────────────────────────────────────────────────────────────
   -c, --config <pathToConfigFile...>                  Provide path to one or more webpack configuration files to process, e.g. "./webpack.config.js".
   --config-name <name...>                             Name(s) of particular configuration(s) to use if configuration file exports an array of multiple configurations.
   -m, --merge                                         Merge two or more configurations using 'webpack-merge'.
@@ -99,15 +103,17 @@ Options:
   --no-web-socket-server                              Disallows to set web socket server and options.
   --web-socket-server-type <value>                    Allows to set web socket server and options (by default 'ws').
 
-Global options:
+Global options
+────────────────────────────────────────────────────────────────────────
   --color                                             Enable colors on console.
   --no-color                                          Disable colors on console.
   -v, --version                                       Output the version number of 'webpack', 'webpack-cli' and 'webpack-dev-server' and other packages.
   -h, --help [verbose]                                Display help for commands and options.
 
-To see list of all supported commands and options run 'webpack --help=verbose'.
+────────────────────────────────────────────────────────────────────────
+ℹ Run 'webpack --help=verbose' to see all available commands and options.
 
-Webpack documentation: https://webpack.js.org/.
-CLI documentation: https://webpack.js.org/api/cli/.
-Made with ♥ by the webpack team.
+Webpack documentation:  https://webpack.js.org/
+CLI documentation:      https://webpack.js.org/api/cli/
+Made with ♥ by the webpack team
 ```