Sentence case for headers

Author: hugovk

Doc/library/profile.rst

@@ -1,7 +1,7 @@
 .. _profile:
 
 ****************************************
-:mod:`!profile` --- Pure Python Profiler
+:mod:`!profile` --- Pure Python profiler
 ****************************************
 
 .. module:: profile
@@ -199,7 +199,7 @@ extend for custom profiling behavior.
 
 .. _deterministic-profiling:
 
-What Is Deterministic Profiling?
+What is deterministic profiling?
 ================================
 
 :dfn:`Deterministic profiling` is meant to reflect the fact that all *function

Doc/library/profiling-sampling.rst

@@ -3,7 +3,7 @@
 .. _profiling-sampling:
 
 ***************************************************
-:mod:`profiling.sampling` --- Statistical Profiler
+:mod:`profiling.sampling` --- Statistical profiler
 ***************************************************
 
 .. module:: profiling.sampling
@@ -28,7 +28,7 @@ process, overhead is virtually zero, making this profiler suitable for both
 development and production environments.
 
 
-What Is Statistical Profiling?
+What is statistical profiling?
 ==============================
 
 Statistical profiling builds a picture of program behavior by periodically
@@ -64,7 +64,7 @@ deterministic profiling overhead would be unacceptable. For exact call counts
 and complete call graphs, use :mod:`profiling.tracing` instead.
 
 
-Quick Examples
+Quick examples
 ==============
 
 Profile a script and see the results immediately::
@@ -103,7 +103,7 @@ The profiler operates through two subcommands that determine how to obtain
 the target process.
 
 
-The ``run`` Command
+The ``run`` command
 -------------------
 
 The ``run`` command launches a Python script or module and profiles it from
@@ -121,7 +121,7 @@ profiled program::
    python -m profiling.sampling run script.py --config settings.yaml
 
 
-The ``attach`` Command
+The ``attach`` command
 ----------------------
 
 The ``attach`` command connects to an already-running Python process by its
@@ -138,7 +138,7 @@ On most systems, attaching to another process requires appropriate permissions.
 On Linux, you may need to run as root or adjust the ``ptrace_scope`` setting.
 
 
-Sampling Configuration
+Sampling configuration
 ======================
 
 Before exploring the various output formats and visualization options, it is
@@ -171,7 +171,7 @@ The default configuration works well for most use cases:
      - No live statistics display during profiling
 
 
-Sampling Interval and Duration
+Sampling interval and duration
 ------------------------------
 
 The two most fundamental parameters are the sampling interval and duration.
@@ -200,7 +200,7 @@ a program that runs for a fixed time, you may want to set the duration to
 match or exceed the expected runtime.
 
 
-Thread Selection
+Thread selection
 ----------------
 
 Python programs often use multiple threads, whether explicitly through the
@@ -219,7 +219,7 @@ This option is particularly useful when investigating concurrency issues or
 when work is distributed across a thread pool.
 
 
-Special Frames
+Special frames
 --------------
 
 The profiler can inject artificial frames into the captured stacks to provide
@@ -249,7 +249,7 @@ see substantial time in ``<GC>`` frames, consider investigating object
 allocation rates or using object pooling.
 
 
-Real-Time Statistics
+Real-time statistics
 --------------------
 
 The ``--realtime-stats`` option displays sampling rate statistics during
@@ -262,15 +262,15 @@ if the profiler cannot keep up. The statistics help verify that profiling is
 working correctly and that sufficient samples are being collected.
 
 
-Profiling Modes
+Profiling modes
 ===============
 
 The sampling profiler supports three modes that control which samples are
 recorded. The mode determines what the profile measures: total elapsed time,
 CPU execution time, or time spent holding the Global Interpreter Lock.
 
 
-Wall-Clock Mode
+Wall-clock mode
 ---------------
 
 Wall-clock mode (``--mode=wall``) captures all samples regardless of what the
@@ -290,7 +290,7 @@ function. This is often exactly what you want when optimizing end-to-end
 latency.
 
 
-CPU Mode
+CPU mode
 --------
 
 CPU mode (``--mode=cpu``) records samples only when the thread is actually
@@ -308,7 +308,7 @@ and network calls, CPU mode reveals which computational sections are most
 expensive.
 
 
-GIL Mode
+GIL mode
 --------
 
 GIL mode (``--mode=gil``) records samples only when the thread holds Python's
@@ -327,15 +327,15 @@ single-threaded programs or for code that releases the GIL (such as many
 NumPy operations or I/O calls).
 
 
-Output Formats
+Output formats
 ==============
 
 The profiler produces output in several formats, each suited to different
 analysis workflows. The format is selected with a command-line flag, and
 output goes to stdout, a file, or a directory depending on the format.
 
 
-pstats Format
+pstats format
 -------------
 
 The pstats format (``--pstats``) produces a text table similar to what
@@ -390,7 +390,7 @@ The ``--no-summary`` option suppresses the header summary that precedes the
 statistics table.
 
 
-Collapsed Stacks Format
+Collapsed stacks format
 -----------------------
 
 Collapsed stacks format (``--collapsed``) produces one line per unique call
@@ -418,7 +418,7 @@ The resulting SVG can be viewed in any web browser and provides an interactive
 visualization where you can click to zoom into specific call paths.
 
 
-Flame Graph Format
+Flame graph format
 ------------------
 
 Flame graph format (``--flamegraph``) produces a self-contained HTML file with
@@ -452,7 +452,7 @@ at the top indicate functions that consume significant time either directly
 or through their callees.
 
 
-Gecko Format
+Gecko format
 ------------
 
 Gecko format (``--gecko``) produces JSON output compatible with the Firefox
@@ -486,7 +486,7 @@ For this reason, the ``--mode`` option is not available with Gecko format;
 all relevant data is captured automatically.
 
 
-Heatmap Format
+Heatmap format
 --------------
 
 Heatmap format (``--heatmap``) generates an interactive HTML visualization
@@ -527,7 +527,7 @@ intuitive view that shows exactly where time is spent without requiring
 interpretation of hierarchical visualizations.
 
 
-Live Mode
+Live mode
 =========
 
 Live mode (``--live``) provides a terminal-based real-time view of profiling
@@ -584,7 +584,7 @@ Live mode is incompatible with output format options (``--collapsed``,
 interface rather than producing file output.
 
 
-Async-Aware Profiling
+Async-aware profiling
 =====================
 
 For programs using :mod:`asyncio`, the profiler offers async-aware mode
@@ -623,7 +623,7 @@ Command Line Reference
 The complete command-line interface for reference.
 
 
-Global Options
+Global options
 --------------
 
 .. option:: run
@@ -635,7 +635,7 @@ Global Options
    Attach to and profile a running process by PID.
 
 
-Sampling Options
+Sampling options
 ----------------
 
 .. option:: -i <microseconds>, --interval <microseconds>
@@ -667,7 +667,7 @@ Sampling Options
    Enable async-aware profiling for asyncio programs.
 
 
-Mode Options
+Mode options
 ------------
 
 .. option:: --mode <mode>
@@ -681,7 +681,7 @@ Mode Options
    Requires ``--async-aware``.
 
 
-Output Options
+Output options
 --------------
 
 .. option:: --pstats
@@ -712,7 +712,7 @@ Output Options
    named ``heatmap_PID``.
 
 
-pstats Display Options
+pstats display options
 ----------------------
 
 These options apply only to pstats format output.
@@ -731,7 +731,7 @@ These options apply only to pstats format output.
    Omit the Legend and Summary of Interesting Functions sections from output.
 
 
-Run Command Options
+Run command options
 -------------------
 
 .. option:: -m, --module

Doc/library/profiling-tracing.rst

@@ -1,7 +1,7 @@
 .. _profiling-tracing:
 
 ****************************************************
-:mod:`profiling.tracing` --- Deterministic Profiler
+:mod:`profiling.tracing` --- Deterministic profiler
 ****************************************************
 
 .. module:: profiling.tracing
@@ -38,7 +38,7 @@ testing scenarios.
       cProfile.run('my_function()')
 
 
-What Is Deterministic Profiling?
+What is deterministic profiling?
 ================================
 
 :dfn:`Deterministic profiling` captures every function call, function return,
@@ -74,7 +74,7 @@ allows direct comparison of recursive and iterative implementations.
 
 .. _profiling-tracing-cli:
 
-Command Line Interface
+Command-line interface
 ======================
 
 .. program:: profiling.tracing
@@ -111,14 +111,14 @@ results to standard output (or saves them to a file).
       The ``-m`` option for :mod:`profile`.
 
 
-Programmatic Usage Examples
+Programmatic usage examples
 ===========================
 
 For more control over profiling, use the module's functions and classes
 directly.
 
 
-Basic Profiling
+Basic profiling
 ---------------
 
 The simplest approach uses the :func:`run` function::
@@ -162,7 +162,7 @@ The :class:`Profile` class also works as a context manager::
    pr.print_stats()
 
 
-Module Reference
+Module reference
 ================
 
 .. currentmodule:: profiling.tracing
@@ -264,7 +264,7 @@ Module Reference
    profiling, no results will be available.
 
 
-Using a Custom Timer
+Using a custom timer
 ====================
 
 The :class:`Profile` class accepts a custom timing function, allowing you to