Function _build_docs_root

lib/devtools/tests/test_docs_versioning.py:16–98

Build a minimal docs/ tree with one previous snapshot + Edge + docs.json. The shape mirrors the real repo: an Edge directory with per-locale folders and YAMLs, one previously-frozen v1.14.7 snapshot, and a docs.json with Edge + the previous default in the version selector plus canonical

(tmp_path: Path)

def _build_docs_root(tmp_path: Path) -> Path:
    """Build a minimal docs/ tree with one previous snapshot + Edge + docs.json.

    The shape mirrors the real repo: an Edge directory with per-locale folders
    and YAMLs, one previously-frozen v1.14.7 snapshot, and a docs.json with
    Edge + the previous default in the version selector plus canonical-URL
    wildcard redirects.
    """
    docs = tmp_path / "docs"

    # Edge sources (what the release will freeze).
    edge_en = docs / "edge" / "en"
    edge_en.mkdir(parents=True)
    (edge_en / "introduction.mdx").write_text("# Intro (Edge)\n")
    (edge_en / "changelog.mdx").write_text("---\ntitle: Changelog\n---\n")
    (edge_en / "api.mdx").write_text(
        '---\nopenapi: "/enterprise-api.en.yaml GET /foo"\n---\n'
    )
    # A page added to Edge after the previous release. It exists as a file and
    # is wired into the Edge nav, but is intentionally absent from the v1.14.7
    # nav below — the freeze must still surface it in the new version.
    (edge_en / "datadog.mdx").write_text("# Datadog (Edge)\n")
    (docs / "edge" / "enterprise-api.en.yaml").write_text("openapi: 3.0.0\n")

    # A pre-existing frozen snapshot to clone the nav structure from.
    snap_en = docs / "v1.14.7" / "en"
    snap_en.mkdir(parents=True)
    (snap_en / "introduction.mdx").write_text("# Intro (1.14.7)\n")
    (snap_en / "changelog.mdx").write_text("---\ntitle: Changelog\n---\n")
    (snap_en / "api.mdx").write_text(
        '---\nopenapi: "/v1.14.7/enterprise-api.en.yaml GET /foo"\n---\n'
    )

    docs_json = {
        "navigation": {
            "languages": [
                {
                    "language": "en",
                    "versions": [
                        {
                            "version": "Edge",
                            "tag": "Edge",
                            "tabs": [
                                {
                                    "tab": "Guides",
                                    "pages": [
                                        "edge/en/introduction",
                                        "edge/en/changelog",
                                        "edge/en/api",
                                        "edge/en/datadog",
                                    ],
                                }
                            ],
                        },
                        {
                            "version": "v1.14.7",
                            "default": True,
                            "tag": "Latest",