Skip to content

Phase 2: fork DX & docs (re-target to main)#88

Merged
kwiens merged 3 commits into
mainfrom
oss-phase2-docs
Jun 21, 2026
Merged

Phase 2: fork DX & docs (re-target to main)#88
kwiens merged 3 commits into
mainfrom
oss-phase2-docs

Conversation

@kwiens

@kwiens kwiens commented Jun 21, 2026

Copy link
Copy Markdown
Owner

Re-lands #84 against main. #84 was merged with base oss-phase1-hygiene instead of main, so its content (docs/DEPLOYING.md, docs/DATA.md, scripts/requirements.txt, README trims, the env-token fix for the trail script, and the public/terrain deploy docs) never reached main. This PR brings that content to main so Phase 3 (#85) can rebase cleanly on top.

No new changes beyond what was reviewed in #84 plus the post-review terrain/token follow-up.

🤖 Generated with Claude Code

kwiens added 3 commits May 20, 2026 17:40
Make a community fork follow one document end-to-end.

- docs/DEPLOYING.md — the full fork checklist: Mapbox setup, the two
  config files (site.config.ts / map.config.ts), src/data/ content,
  routes/trails in Mapbox Studio, the trail elevation pipeline, brand
  assets, and Vercel deploy. Condensed checklist at the end.
- docs/DATA.md — the data-file type contract for BikeRoute,
  MountainBikeTrail, BikeResource, MapFeature, and LocalResource, plus
  which scripts/*.py own which generated fields.
- scripts/requirements.txt — pins the Python deps the trail scripts
  actually import (requests, urllib3, Pillow).
- README.md — trimmed: the deep "Make it yours" / "Configuration model" /
  "Deploying" detail moves into docs/; README keeps the pitch, features,
  a short getting-started, and links into docs/. Adds a CI badge, points
  Contributing at CONTRIBUTING.md, and fixes a stale directory tree
  (dropped the deleted useLocationTracking hook).
- DEPLOYING.md §6: note that scripts/add_trail_elevation.py has its own
  MVT_TILESET constant that must point at the same tileset as
  MTN_BIKE_TILESET_URL — otherwise the elevation pipeline runs against the
  wrong tileset.
- DATA.md: trailColor takes (rating, isGreenway), not a single arg.
- DEPLOYING.md: add a step covering the region-specific public/terrain/
  Terrain-RGB cache used by ride-recording DEM correction (skip or
  regenerate per region; degrades gracefully). Renumber later steps and
  add a checklist item.
- README: re-add the public/terrain/ line to the directory tree.
- add_trail_elevation.py: token is no longer a literal in map.config.ts,
  so _read_mapbox_token() now reads NEXT_PUBLIC_MAPBOX_TOKEN from the
  environment, falling back to .env.local/.env. Fixes the script exiting
  with 'Could not find accessToken' even with a populated .env.local.
- gitignore .venv/ and __pycache__/ for the documented Python workflow.
@vercel

vercel Bot commented Jun 21, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
bikemap Ready Ready Preview Jun 21, 2026 3:53am

Request Review

@kwiens
kwiens merged commit e32210c into main Jun 21, 2026
3 checks passed
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