perf(docs): pre-render API reference HTML in Python

[hkad98]

Summary

• Move API reference HTML rendering from Hugo shortcodes into python_ref_builder.py using Jinja2 templates and a pre-compiled LinkResolver with O(1) dict lookups, eliminating the O(n²) shortcode processing that took ~8 minutes per build
• Add 33 unit tests for the ref builder covering link resolution, template rendering, context builders, and file structure creation
• Fix generate.sh crash on missing links.json, narrow V2 cache key to exclude test files, fix Dockerfile COPY paths and type annotations
• Document the three documentation deployment workflows in scripts/docs/README.md

Changes

Core optimization (python_ref_builder.py):

• Two-pass generation: pass 1 builds a links dict, pass 2 renders HTML via Jinja2 templates
• Markdown templates now receive pre-rendered CONTENT instead of {{< api-ref >}} shortcodes
• jinja2 added to script-requirements.txt

Jinja2 templates (scripts/docs/templates/):

• object_partial.html.j2, class.html.j2, function.html.j2, module.html.j2 replicate exact Hugo shortcode output

CI/Dockerfile:

• V2 workflow: use master's scripts for all versions, hash-based cache key scoped to *.py + templates/**
• Dockerfile: fix COPY paths for SDK packages, persist Go modules in image layer, remove dead links.json copy
• generate.sh: guard links.json sed with if [ -f ... ]
• Add docs-scripts-tests job to pre-merge pipeline, scripts/docs/** in path filter
• Add make test-docs-scripts target

Result: Hugo build drops from ~405s to ~100s (API ref template time eliminated entirely)

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 77.53%. Comparing base (9659a3e) to head (dd6fc46).
⚠️ Report is 4 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1391      +/-   ##
==========================================
- Coverage   77.53%   77.53%   -0.01%     
==========================================
  Files         225      225              
  Lines       14615    14614       -1     
==========================================
- Hits        11332    11331       -1     
  Misses       3283     3283              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.