provide-foundry 2025-11-18
Initial commit establishing the provide-foundry documentation and theme toolkit
1743 files · 50,227,102+ · 4,155-

MkDocs theme with hooks, partials, and cross-repo link resolution

4 files changed
  • theme Custom MkDocs theme with hooks for global partials injection, nav filtering, Terraform provider docs, and version display
  • crossrepo_links.py MkDocs plugin for resolving cross-repository documentation links
  • markdown_export.py MkDocs plugin for exporting rendered markdown
  • inject_partials.py Script to inject shared documentation partials into consuming repos
  • Created custom MkDocs theme with global partials hook, nav filter hook, Terraform provider hook, and version hook instantiate architectural
    4 files
    • global_partials_hook.py
    • nav_filter_hook.py
    • terraform_provider.py
    • version_hook.py
  • Built cross-repo link resolution plugin for MkDocs to support ecosystem-wide documentation instantiate behavioral
    1 file
    • crossrepo_links.py
  • Added partials injection script for distributing shared documentation fragments across repos instantiate behavioral
    1 file
    • inject_partials.py

Documentation configuration and shared partials

2 files changed
  • _partials Shared documentation partials for distribution, CLI verification, Go requirements, troubleshooting, and uv installation
  • base-mkdocs.yml Base MkDocs configuration template for ecosystem repos
  • Created shared documentation partials covering distribution, CLI verification, Go requirements, optional dependencies, troubleshooting, and virtual environment setup specify behavioral
    5 files
    • DISTRIBUTION.md
    • cli-verification.md
    • go-requirements.md
    • optional-dependencies.md
    • troubleshooting-common.md

CI workflows and project configuration

5 files changed
  • ci.yml CI workflow for linting and testing
  • release.yml Release workflow for PyPI publishing
  • links.yml Link checking workflow using lychee
  • .pre-commit-config.yaml Pre-commit hooks configuration
  • pyproject.toml Python project configuration with uv build system
  • Added CI, release, and link-checking GitHub Actions workflows baseline behavioral
    3 files
    • ci.yml
    • release.yml
    • links.yml
  • Configured pre-commit hooks and project metadata baseline internal
    2 files
    • .pre-commit-config.yaml
    • pyproject.toml

Memory profiling baselines with memray

1 file changed
  • memray Memray-based memory allocation tests for cross-repo links and extraction
  • Added memray memory profiling tests for cross-repo link resolution and extraction operations qualify internal
    2 files
    • test_crossrepo_links_allocations.py
    • test_extract_allocations.py