great-docs timings

Show page-level build timings from the last build.

great-docs timings [OPTIONS]

Reads the build-timings.json artifact generated during great-docs build and displays per-page render durations as a sorted table. Pages are listed slowest-first to help identify bottlenecks.

Run great-docs build first to generate the timing data.

Full --help output

Usage: great-docs timings [OPTIONS]

  Show page-level build timings from the last build.

  Reads the build-timings.json artifact generated during 'great-docs build'
  and displays per-page render durations as a sorted table. Pages are listed
  slowest-first to help identify bottlenecks.

  Run 'great-docs build' first to generate the timing data.

  Examples:
    great-docs timings
    great-docs timings --top 10
    great-docs timings --version 0.10
    great-docs timings --output-dir ./public
    great-docs timings --json

Options:
  --project-path DIRECTORY  Path to your project root directory (default:
                            current directory)
  --top INTEGER             Show only the N slowest pages.
  --version TEXT            Show timings for a specific version only (multi-
                            version builds).
  --json                    Output raw JSON instead of a table.
  --output-dir DIRECTORY    Path to the build output directory (if different
                            from default _site).
  --help                    Show this message and exit.

Options

--project-path: DIRECTORY

Path to your project root directory (default: current directory)

--top: INTEGER

Show only the N slowest pages.

--version: TEXT

Show timings for a specific version only (multi-version builds).

--json

Output raw JSON instead of a table.

--output-dir: DIRECTORY

Path to the build output directory (if different from default _site).

Examples

  great-docs timings
  great-docs timings --top 10
  great-docs timings --version 0.10
  great-docs timings --output-dir ./public
  great-docs timings --json