Remove "5 Longest Pages to Generate" documentation page (#2170)

* Initial plan

* remove page 5 Longest Pages to Generate

Agent-Logs-Url: https://github.com/xadupre/yet-another-onnx-builder/sessions/5475a79a-084f-49c0-b3e1-1112d4cac12b

Co-authored-by: xadupre <22452781+xadupre@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: xadupre <22452781+xadupre@users.noreply.github.com>

Author: Copilot

docs/conf.py

@@ -1,56 +1,14 @@
-import json
 import logging
 import os
 import shutil
 import sys
-import time
 from sphinx_runpython.github_link import make_linkcode_resolve
 import yobx
 
 # Suppress TensorFlow C++ and Python logging before any TF import occurs.
 os.environ["TF_CPP_MIN_LOG_LEVEL"] = "3"
 logging.getLogger("tensorflow").setLevel(logging.ERROR)
 
-# ---------------------------------------------------------------------------
-# Per-page build duration tracking (writes top-5 to a JSON file so that the
-# doc_build_durations.rst page can display it in the generated documentation).
-# ---------------------------------------------------------------------------
-
-_PAGE_TIMINGS_START: dict[str, float] = {}
-_PAGE_DURATIONS: dict[str, float] = {}
-_DOC_BUILD_DURATIONS_JSON = os.path.join(
-    os.path.dirname(__file__), "_static", "doc_build_durations.json"
-)
-os.environ["YOBX_DOC_BUILD_DURATIONS_JSON"] = _DOC_BUILD_DURATIONS_JSON
-
-
-def _on_source_read(app, docname, source):
-    """Records the start time when a source file begins to be read."""
-    _PAGE_TIMINGS_START[docname] = time.monotonic()
-
-
-def _on_doctree_read(app, doctree):
-    """Records the elapsed time after a doctree has been parsed."""
-    docname = app.env.docname
-    start = _PAGE_TIMINGS_START.pop(docname, None)
-    if start is not None:
-        _PAGE_DURATIONS[docname] = time.monotonic() - start
-
-
-def _on_build_finished(app, exception):
-    """Writes the 5 slowest pages (by build duration) to a JSON file."""
-    if exception or not _PAGE_DURATIONS:
-        return
-    top5 = sorted(_PAGE_DURATIONS.items(), key=lambda kv: kv[1], reverse=True)[:5]
-    static_dir = os.path.dirname(_DOC_BUILD_DURATIONS_JSON)
-    if os.path.exists(static_dir) and not os.path.isdir(static_dir):
-        os.remove(static_dir)
-    os.makedirs(static_dir, exist_ok=True)
-    with open(_DOC_BUILD_DURATIONS_JSON, "w", encoding="utf-8") as fh:
-        json.dump(
-            [{"docname": name, "duration_s": round(dur, 3)} for name, dur in top5], fh, indent=2
-        )
-
 
 def _on_builder_inited(app):
     """Removes any non-directory file named '_static' in the output directory.
@@ -66,11 +24,8 @@ def _on_builder_inited(app):
 
 
 def setup(app):
-    """Connects duration-tracking hooks to Sphinx events."""
+    """Connects hooks to Sphinx events."""
     app.connect("builder-inited", _on_builder_inited)
-    app.connect("source-read", _on_source_read)
-    app.connect("doctree-read", _on_doctree_read)
-    app.connect("build-finished", _on_build_finished)
 
 
 project = "yet-another-onnx-builder"

docs/doc_build_durations.rst

@@ -11,7 +11,6 @@ Additional statistics and metadata about the documentation build.
    index_stats
    ci_durations
    commits_per_week
-   doc_build_durations
    comparison
    weekly_progress
    pypi_downloads