Skip to content

hotfix(docs): exclude AirSim scene binaries from docs builds (0.20.8) - #420

Closed
andrewjong wants to merge 1 commit into
mainfrom
hotfix-docs-exclude-airsim-binaries
Closed

hotfix(docs): exclude AirSim scene binaries from docs builds (0.20.8)#420
andrewjong wants to merge 1 commit into
mainfrom
hotfix-docs-exclude-airsim-binaries

Conversation

@andrewjong

Copy link
Copy Markdown
Member

Summary

  • Add simulation/ms-airsim/assets/scenes/** and simulation/ms-airsim/environments/** to exclude_docs in mkdocs.yml.
  • Bump VERSION 0.20.7 → 0.20.8 and record the change in docs/release_notes/index.md.

Why

The same-dir plugin publishes the whole repo tree as site content. The downloaded Microsoft AirSim UE4 scenes and environments are gitignored but were not excluded from docs, so every mkdocs build / docs serve on a machine with scenes fetched copied ~15 GB of Unreal .debug binaries and zips into the site directory. On one dev machine this had accumulated to ~70 GB across ../site and stale build dirs.

No pages or links reference either directory (checked mkdocs.yml nav and docs/).

Verification

  • mkdocs.config.load_config loads the config; pattern match test:
    • EXCLUDED simulation/ms-airsim/assets/scenes/Blocks/LinuxNoEditor/Blocks.debug
    • EXCLUDED simulation/ms-airsim/environments/AbandonedPark.zip
    • kept simulation/ms-airsim/docker/README.md
    • kept docs/simulation/ms-airsim/index.md
  • Full mkdocs build with the same two patterns on a machine with all four scenes plus AbandonedPark fetched: build output dropped from ~17–20 GB to ~2.5 GB, and simulation/ms-airsim/assets/scenes/ and simulation/ms-airsim/environments/ are absent from the output.

🤖 Generated with Claude Code

The same-dir plugin publishes the whole repo tree as site content, and the
downloaded Microsoft AirSim UE4 scenes (simulation/ms-airsim/assets/scenes/)
and environments (simulation/ms-airsim/environments/) were not in
exclude_docs, so every mkdocs build/serve on a machine with scenes fetched
copied ~15 GB of Unreal .debug binaries and zips into the site directory.
No pages or links reference either directory.

Bumps VERSION 0.20.7 -> 0.20.8 and records the change in the release notes.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@andrewjong

Copy link
Copy Markdown
Member Author

Superseded: the enforce-branch-targets check requires a hotfix/* head branch. Same commit reopened from hotfix/docs-exclude-airsim-binaries.

@andrewjong andrewjong closed this Sep 5, 2026
@andrewjong
andrewjong deleted the hotfix-docs-exclude-airsim-binaries branch September 5, 2026 00:27
@github-actions

github-actions Bot commented Sep 5, 2026

Copy link
Copy Markdown
Contributor

Test Metrics — bda0b9824f1817d28570378dfceeb4f025d1ba28

This was a unit/build-only run. Simulation regression comparison does not apply.

system.test_build_packages

Pass rates

Test Pass Fail Skip Rate
test_colcon_build_gcs 1 0 0 100%
test_colcon_build_ms_airsim 1 0 0 100%
test_colcon_build_robot 1 0 0 100%
test_colcon_test_robot 1 0 0 100%

Metrics

Test Metric Value
test_colcon_build_robot duration_s 103.4s
test_colcon_test_robot duration_s 44.19s
test_colcon_build_gcs duration_s 72.65s
test_colcon_build_ms_airsim duration_s 14.89s

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant