Updated documentation.

Author: kmvanbrunt

CHANGELOG.md

@@ -72,6 +72,9 @@ prompt is displayed.
     - Renamed `cmd2_handler` to `cmd2_subcmd_handler` in the `argparse.Namespace` for clarity.
     - Removed `Cmd2AttributeWrapper` class. `argparse.Namespace` objects passed to command functions
       now contain direct attributes for `cmd2_statement` and `cmd2_subcmd_handler`.
+    - Removed `Cmd.doc_header` and the `with_default_category` decorator. Help categorization is now
+      driven by the `DEFAULT_CATEGORY` class variable (see **Simplified command categorization** in
+      the Enhancements section below for details).
 - Enhancements
     - New `cmd2.Cmd` parameters
         - **auto_suggest**: (boolean) if `True`, provide fish shell style auto-suggestions. These
@@ -97,6 +100,11 @@ prompt is displayed.
     - Add support for Python 3.15 by fixing various bugs related to internal `argparse` changes
     - Added `common_prefix` method to `cmd2.string_utils` module as a replacement for
       `os.path.commonprefix` since that is now deprecated in Python 3.15
+    - Simplified command categorization:
+        - By default, all commands in a class are grouped under its `DEFAULT_CATEGORY`.
+        - Individual commands can still be manually moved using the `with_category()` decorator.
+        - For more details and examples, see the [Help](docs/features/help.md) documentation and the
+          `examples/default_categories.py` file.
 
 ## 3.4.0 (March 3, 2026)
 

docs/features/help.md

@@ -56,7 +56,7 @@ category, and the display is driven by the `DEFAULT_CATEGORY` class variable.
 There are 3 methods of specifying command categories:
 
 1. Using the `DEFAULT_CATEGORY` class variable (Automatic)
-1. Using the [@with_category][cmd2.with_category] decorator (Surgical)
+1. Using the [@with_category][cmd2.with_category] decorator (Manual)
 1. Using the [categorize()][cmd2.categorize] function (Manual)
 
 ### Automatic Categorization

docs/features/initialization.md

@@ -16,6 +16,16 @@ Certain things must be initialized within the `__init__()` method of your class
 
 ::: cmd2.Cmd.__init__
 
+## Cmd class variables
+
+The `cmd2.Cmd` class provides several class-level variables that can be overridden in subclasses to change default behavior across all instances of that class.
+
+- **DEFAULT_CATEGORY**: The default help category for documented commands defined in the class that haven't been explicitly categorized. (Default: `"Cmd2 Commands"`)
+- **DEFAULT_EDITOR**: The default editor program used by the `edit` command.
+- **DEFAULT_PROMPT**: The default prompt string. (Default: `"(Cmd) "`)
+- **MISC_HEADER**: Header for the help section listing miscellaneous help topics. (Default: `"Miscellaneous Help Topics"`)
+- **UNDOC_HEADER**: Header for the help section listing undocumented commands. (Default: `"Undocumented Commands"`)
+
 ## Cmd instance attributes
 
 The `cmd2.Cmd` class provides a large number of public instance attributes which allow developers to customize a `cmd2` application further beyond the options provided by the `__init__()` method.