Skip to content

new transportation guide#281

Merged
Dana Bauer (danabauer) merged 3 commits intomainfrom
transpo-guide
Mar 6, 2026
Merged

new transportation guide#281
Dana Bauer (danabauer) merged 3 commits intomainfrom
transpo-guide

Conversation

@danabauer
Copy link
Collaborator

@danabauer Dana Bauer (danabauer) commented Mar 3, 2026

What's in this PR?

  • move all transportation concepts pages from schema ref to transportation guide
  • rewrite and restructure text to create a five-page guide
  • integrate new linear referencing material
  • embed example yaml snippets in guide pages
  • convert svg files to png and optimize png files

To do

  • move transportation splitter to its own page (create task)

@github-actions
Copy link

github-actions bot commented Mar 3, 2026

🚀 Overture Maps docs branch preview deployed!

You can review your changes at https://staging.overturemaps.org/docs/pr/281/index.html


♻️ Last refreshed: 2026-03-06T18:28:24Z

@danabauer Dana Bauer (danabauer) changed the title new transportation guide [WIP] new transportation guide Mar 3, 2026
@github-actions
Copy link

github-actions bot commented Mar 3, 2026

Super-linter summary

Language Validation result
MARKDOWN Fail ❌
NATURAL_LANGUAGE Fail ❌
SQLFLUFF Pass ✅

Super-linter detected linting errors

For more information, see the GitHub Actions workflow run

Powered by Super-linter

MARKDOWN
/github/workspace/docs/schema/index.md:16 error MD012/no-multiple-blanks Multiple consecutive blank lines [Expected: 1; Actual: 2]
/github/workspace/docs/schema/index.md:17:274 error MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]
/github/workspace/docs/schema/index.md:55:113 error MD047/single-trailing-newline Files should end with a single newline character
/github/workspace/docs/schema/reference/addresses/address.md:58:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/addresses/address.md:58:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/base/bathymetry.md:31:338 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/base/bathymetry.md:31:397 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/base/bathymetry.md:32:338 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/base/bathymetry.md:32:397 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/base/bathymetry.md:44:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/base/bathymetry.md:44:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/base/infrastructure.md:46:97 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/base/infrastructure.md:57:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/base/infrastructure.md:57:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/base/land_cover.md:38:338 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/base/land_cover.md:38:397 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/base/land_cover.md:39:338 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/base/land_cover.md:39:397 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/base/land_cover.md:51:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/base/land_cover.md:51:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/base/land_use.md:51:97 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/base/land_use.md:62:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/base/land_use.md:62:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/base/land.md:12 error MD012/no-multiple-blanks Multiple consecutive blank lines [Expected: 1; Actual: 2]
/github/workspace/docs/schema/reference/base/land.md:13 error MD012/no-multiple-blanks Multiple consecutive blank lines [Expected: 1; Actual: 3]
/github/workspace/docs/schema/reference/base/land.md:56:97 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/base/land.md:67:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/base/land.md:67:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/base/water.md:12 error MD022/blanks-around-headings Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "Ocean"]
/github/workspace/docs/schema/reference/base/water.md:24 error MD022/blanks-around-headings Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "Inland Water"]
/github/workspace/docs/schema/reference/base/water.md:67:97 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/base/water.md:78:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/base/water.md:78:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/buildings/building_part.md:74:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/buildings/building_part.md:74:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/buildings/building.md:73:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/buildings/building.md:73:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/core/cartographic_hints.md:10:318 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/core/cartographic_hints.md:10:377 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/core/cartographic_hints.md:11:318 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/core/cartographic_hints.md:11:377 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/core/max_zoom.md:9 error MD032/blanks-around-lists Lists should be surrounded by blank lines [Context: "- [https://wiki.openstreetmap...."]
/github/workspace/docs/schema/reference/core/min_zoom.md:9 error MD032/blanks-around-lists Lists should be surrounded by blank lines [Context: "- [https://wiki.openstreetmap...."]
/github/workspace/docs/schema/reference/core/name_rule.md:10 error MD032/blanks-around-lists Lists should be surrounded by blank lines [Context: "- An official, alternate, or s..."]
/github/workspace/docs/schema/reference/core/name_variant.md:13 error MD032/blanks-around-lists Lists should be surrounded by blank lines [Context: "- `official` - The legally or ..."]
/github/workspace/docs/schema/reference/divisions/division_area.md:71:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/divisions/division_area.md:71:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/divisions/division_boundary.md:58:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/divisions/division_boundary.md:58:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/divisions/division_boundary.md:64:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/divisions/division_boundary.md:64:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/divisions/division.md:18:338 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/divisions/division.md:18:397 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/divisions/division.md:19:338 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/divisions/division.md:19:397 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/divisions/division.md:68:97 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/divisions/division.md:91:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/divisions/division.md:91:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/places/place.md:31:712 error MD034/no-bare-urls Bare URL used [Context: "https://docs.overturemaps.org/..."]
/github/workspace/docs/schema/reference/places/place.md:54:103 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/places/place.md:83:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/places/place.md:83:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/places/types/brand.md:23:100 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/system/primitive/geometry.md:11:161 error MD047/single-trailing-newline Files should end with a single newline character
/github/workspace/docs/schema/reference/transportation/connector.md:39:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/transportation/connector.md:39:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/transportation/segment.md:31:272 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/segment.md:47:106 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/transportation/segment.md:84:278 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/segment.md:106:258 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/segment.md:129:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/transportation/segment.md:129:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/transportation/types/access_restriction_rule.md:11:253 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/types/access_restriction_rule.when.md:10:248 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/types/destination_rule.when.md:3:27 error MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]
/github/workspace/docs/schema/reference/transportation/types/prohibited_transition_rule.md:14:256 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/types/prohibited_transition_rule.when.md:10:251 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/types/route_reference.md:13:100 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/transportation/types/speed_limit_rule.md:19:246 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/types/speed_limit_rule.when.md:10:241 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
NATURAL_LANGUAGE

/github/workspace/docs/schema/index.md
  29:67  ✓ error  Incorrect term: “key/value”, use “key-value” instead  terminology

/github/workspace/docs/schema/reference/base/infrastructure.md
  45:74  ✓ error  Incorrect term: “Key/value”, use “Key-value” instead  terminology

/github/workspace/docs/schema/reference/base/land.md
   9:74  ✓ error  Incorrect term: “TODO”, use “Todo” instead            terminology
  55:74  ✓ error  Incorrect term: “Key/value”, use “Key-value” instead  terminology

/github/workspace/docs/schema/reference/base/land_use.md
  50:74  ✓ error  Incorrect term: “Key/value”, use “Key-value” instead  terminology

/github/workspace/docs/schema/reference/base/water.md
  66:74  ✓ error  Incorrect term: “Key/value”, use “Key-value” instead  terminology

/github/workspace/docs/schema/reference/base/types/source_tags.md
  3:1  ✓ error  Incorrect term: “Key/value”, use “Key-value” instead  terminology

/github/workspace/docs/schema/reference/places/place.md
  37:49  ✓ error  Incorrect term: “websites”, use “sites” instead  terminology

/github/workspace/docs/schema/reference/system/ref/id.md
  1:3  ✓ error  Incorrect term: “Id”, use “ID” instead  terminology

/github/workspace/docs/schema/reference/system/snake_case_string.md
  3:28  ✓ error  Incorrect term: “snake case”, use “snake_case” instead  terminology
  9:38  ✓ error  Incorrect term: “snake case”, use “snake_case” instead  terminology

✖ 11 problems (11 errors, 0 warnings, 0 infos)
✓ 11 fixable problems.
Try to run: $ textlint --fix [file]

@github-actions
Copy link

github-actions bot commented Mar 3, 2026

Super-linter summary

Language Validation result
MARKDOWN Fail ❌
NATURAL_LANGUAGE Fail ❌
SQLFLUFF Pass ✅

Super-linter detected linting errors

For more information, see the GitHub Actions workflow run

Powered by Super-linter

MARKDOWN
/github/workspace/docs/schema/index.md:16 error MD012/no-multiple-blanks Multiple consecutive blank lines [Expected: 1; Actual: 2]
/github/workspace/docs/schema/index.md:17:274 error MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]
/github/workspace/docs/schema/index.md:55:113 error MD047/single-trailing-newline Files should end with a single newline character
/github/workspace/docs/schema/reference/addresses/address.md:58:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/addresses/address.md:58:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/base/bathymetry.md:31:338 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/base/bathymetry.md:31:397 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/base/bathymetry.md:32:338 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/base/bathymetry.md:32:397 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/base/bathymetry.md:44:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/base/bathymetry.md:44:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/base/infrastructure.md:46:97 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/base/infrastructure.md:57:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/base/infrastructure.md:57:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/base/land_cover.md:38:338 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/base/land_cover.md:38:397 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/base/land_cover.md:39:338 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/base/land_cover.md:39:397 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/base/land_cover.md:51:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/base/land_cover.md:51:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/base/land_use.md:51:97 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/base/land_use.md:62:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/base/land_use.md:62:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/base/land.md:12 error MD012/no-multiple-blanks Multiple consecutive blank lines [Expected: 1; Actual: 2]
/github/workspace/docs/schema/reference/base/land.md:13 error MD012/no-multiple-blanks Multiple consecutive blank lines [Expected: 1; Actual: 3]
/github/workspace/docs/schema/reference/base/land.md:56:97 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/base/land.md:67:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/base/land.md:67:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/base/water.md:12 error MD022/blanks-around-headings Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "Ocean"]
/github/workspace/docs/schema/reference/base/water.md:24 error MD022/blanks-around-headings Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "Inland Water"]
/github/workspace/docs/schema/reference/base/water.md:67:97 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/base/water.md:78:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/base/water.md:78:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/buildings/building_part.md:74:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/buildings/building_part.md:74:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/buildings/building.md:73:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/buildings/building.md:73:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/core/cartographic_hints.md:10:318 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/core/cartographic_hints.md:10:377 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/core/cartographic_hints.md:11:318 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/core/cartographic_hints.md:11:377 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/core/max_zoom.md:9 error MD032/blanks-around-lists Lists should be surrounded by blank lines [Context: "- [https://wiki.openstreetmap...."]
/github/workspace/docs/schema/reference/core/min_zoom.md:9 error MD032/blanks-around-lists Lists should be surrounded by blank lines [Context: "- [https://wiki.openstreetmap...."]
/github/workspace/docs/schema/reference/core/name_rule.md:10 error MD032/blanks-around-lists Lists should be surrounded by blank lines [Context: "- An official, alternate, or s..."]
/github/workspace/docs/schema/reference/core/name_variant.md:13 error MD032/blanks-around-lists Lists should be surrounded by blank lines [Context: "- `official` - The legally or ..."]
/github/workspace/docs/schema/reference/divisions/division_area.md:71:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/divisions/division_area.md:71:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/divisions/division_boundary.md:58:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/divisions/division_boundary.md:58:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/divisions/division_boundary.md:64:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/divisions/division_boundary.md:64:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/divisions/division.md:18:338 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/divisions/division.md:18:397 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/divisions/division.md:19:338 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/divisions/division.md:19:397 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/divisions/division.md:68:97 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/divisions/division.md:91:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/divisions/division.md:91:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/places/place.md:31:712 error MD034/no-bare-urls Bare URL used [Context: "https://docs.overturemaps.org/..."]
/github/workspace/docs/schema/reference/places/place.md:54:103 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/places/place.md:83:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/places/place.md:83:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/places/types/brand.md:23:100 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/system/primitive/geometry.md:11:161 error MD047/single-trailing-newline Files should end with a single newline character
/github/workspace/docs/schema/reference/transportation/connector.md:39:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/transportation/connector.md:39:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/transportation/segment.md:31:272 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/segment.md:47:106 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/transportation/segment.md:84:278 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/segment.md:106:258 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/segment.md:129:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/transportation/segment.md:129:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/transportation/types/access_restriction_rule.md:11:253 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/types/access_restriction_rule.when.md:10:248 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/types/destination_rule.when.md:3:27 error MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]
/github/workspace/docs/schema/reference/transportation/types/prohibited_transition_rule.md:14:256 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/types/prohibited_transition_rule.when.md:10:251 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/types/route_reference.md:13:100 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/transportation/types/speed_limit_rule.md:19:246 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/types/speed_limit_rule.when.md:10:241 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
NATURAL_LANGUAGE

/github/workspace/docs/schema/index.md
  29:67  ✓ error  Incorrect term: “key/value”, use “key-value” instead  terminology

/github/workspace/docs/schema/reference/base/infrastructure.md
  45:74  ✓ error  Incorrect term: “Key/value”, use “Key-value” instead  terminology

/github/workspace/docs/schema/reference/base/land.md
   9:74  ✓ error  Incorrect term: “TODO”, use “Todo” instead            terminology
  55:74  ✓ error  Incorrect term: “Key/value”, use “Key-value” instead  terminology

/github/workspace/docs/schema/reference/base/land_use.md
  50:74  ✓ error  Incorrect term: “Key/value”, use “Key-value” instead  terminology

/github/workspace/docs/schema/reference/base/water.md
  66:74  ✓ error  Incorrect term: “Key/value”, use “Key-value” instead  terminology

/github/workspace/docs/schema/reference/base/types/source_tags.md
  3:1  ✓ error  Incorrect term: “Key/value”, use “Key-value” instead  terminology

/github/workspace/docs/schema/reference/places/place.md
  37:49  ✓ error  Incorrect term: “websites”, use “sites” instead  terminology

/github/workspace/docs/schema/reference/system/ref/id.md
  1:3  ✓ error  Incorrect term: “Id”, use “ID” instead  terminology

/github/workspace/docs/schema/reference/system/snake_case_string.md
  3:28  ✓ error  Incorrect term: “snake case”, use “snake_case” instead  terminology
  9:38  ✓ error  Incorrect term: “snake case”, use “snake_case” instead  terminology

✖ 11 problems (11 errors, 0 warnings, 0 infos)
✓ 11 fixable problems.
Try to run: $ textlint --fix [file]

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not the requested reviewer (hi Brad Richardson (@brad-richardson) 👀), but this is AWESOME. Didn't look at everything, but definitely a stellar rewrite. Easier on the eyes + more human.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great stuff, thank you!

@danabauer Dana Bauer (danabauer) changed the title [WIP] new transportation guide new transportation guide Mar 6, 2026
@github-actions
Copy link

github-actions bot commented Mar 6, 2026

Super-linter summary

Language Validation result
MARKDOWN Fail ❌
NATURAL_LANGUAGE Fail ❌
SQLFLUFF Pass ✅

Super-linter detected linting errors

For more information, see the GitHub Actions workflow run

Powered by Super-linter

MARKDOWN
/github/workspace/docs/schema/index.md:16 error MD012/no-multiple-blanks Multiple consecutive blank lines [Expected: 1; Actual: 2]
/github/workspace/docs/schema/index.md:17:274 error MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]
/github/workspace/docs/schema/index.md:55:113 error MD047/single-trailing-newline Files should end with a single newline character
/github/workspace/docs/schema/reference/addresses/address.md:58:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/addresses/address.md:58:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/base/bathymetry.md:31:338 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/base/bathymetry.md:31:397 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/base/bathymetry.md:32:338 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/base/bathymetry.md:32:397 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/base/bathymetry.md:44:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/base/bathymetry.md:44:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/base/infrastructure.md:46:97 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/base/infrastructure.md:57:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/base/infrastructure.md:57:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/base/land_cover.md:38:338 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/base/land_cover.md:38:397 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/base/land_cover.md:39:338 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/base/land_cover.md:39:397 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/base/land_cover.md:51:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/base/land_cover.md:51:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/base/land_use.md:51:97 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/base/land_use.md:62:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/base/land_use.md:62:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/base/land.md:12 error MD012/no-multiple-blanks Multiple consecutive blank lines [Expected: 1; Actual: 2]
/github/workspace/docs/schema/reference/base/land.md:13 error MD012/no-multiple-blanks Multiple consecutive blank lines [Expected: 1; Actual: 3]
/github/workspace/docs/schema/reference/base/land.md:56:97 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/base/land.md:67:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/base/land.md:67:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/base/water.md:12 error MD022/blanks-around-headings Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "Ocean"]
/github/workspace/docs/schema/reference/base/water.md:24 error MD022/blanks-around-headings Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "Inland Water"]
/github/workspace/docs/schema/reference/base/water.md:67:97 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/base/water.md:78:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/base/water.md:78:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/buildings/building_part.md:74:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/buildings/building_part.md:74:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/buildings/building.md:73:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/buildings/building.md:73:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/core/cartographic_hints.md:10:318 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/core/cartographic_hints.md:10:377 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/core/cartographic_hints.md:11:318 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/core/cartographic_hints.md:11:377 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/core/max_zoom.md:9 error MD032/blanks-around-lists Lists should be surrounded by blank lines [Context: "- [https://wiki.openstreetmap...."]
/github/workspace/docs/schema/reference/core/min_zoom.md:9 error MD032/blanks-around-lists Lists should be surrounded by blank lines [Context: "- [https://wiki.openstreetmap...."]
/github/workspace/docs/schema/reference/core/name_rule.md:10 error MD032/blanks-around-lists Lists should be surrounded by blank lines [Context: "- An official, alternate, or s..."]
/github/workspace/docs/schema/reference/core/name_variant.md:13 error MD032/blanks-around-lists Lists should be surrounded by blank lines [Context: "- `official` - The legally or ..."]
/github/workspace/docs/schema/reference/divisions/division_area.md:71:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/divisions/division_area.md:71:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/divisions/division_boundary.md:58:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/divisions/division_boundary.md:58:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/divisions/division_boundary.md:64:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/divisions/division_boundary.md:64:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/divisions/division.md:18:338 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/divisions/division.md:18:397 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/divisions/division.md:19:338 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/divisions/division.md:19:397 error MD034/no-bare-urls Bare URL used [Context: "https://www.maptiler.com/googl..."]
/github/workspace/docs/schema/reference/divisions/division.md:68:97 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/divisions/division.md:91:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/divisions/division.md:91:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/places/place.md:31:712 error MD034/no-bare-urls Bare URL used [Context: "https://docs.overturemaps.org/..."]
/github/workspace/docs/schema/reference/places/place.md:54:103 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/places/place.md:83:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/places/place.md:83:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/places/types/brand.md:23:100 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/system/primitive/geometry.md:11:161 error MD047/single-trailing-newline Files should end with a single newline character
/github/workspace/docs/schema/reference/transportation/connector.md:39:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/transportation/connector.md:39:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/transportation/segment.md:31:272 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/segment.md:47:106 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/transportation/segment.md:84:278 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/segment.md:106:258 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/segment.md:129:28 error MD060/table-column-style Table column style [Table pipe has extra space to the left for style "compact"]
/github/workspace/docs/schema/reference/transportation/segment.md:129:25 error MD060/table-column-style Table column style [Table pipe has extra space to the right for style "compact"]
/github/workspace/docs/schema/reference/transportation/types/access_restriction_rule.md:11:253 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/types/access_restriction_rule.when.md:10:248 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/types/destination_rule.when.md:3:27 error MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]
/github/workspace/docs/schema/reference/transportation/types/prohibited_transition_rule.md:14:256 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/types/prohibited_transition_rule.when.md:10:251 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/types/route_reference.md:13:100 error MD034/no-bare-urls Bare URL used [Context: "https://www.wikidata.org/"]
/github/workspace/docs/schema/reference/transportation/types/speed_limit_rule.md:19:246 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
/github/workspace/docs/schema/reference/transportation/types/speed_limit_rule.when.md:10:241 error MD034/no-bare-urls Bare URL used [Context: "https://wiki.openstreetmap.org..."]
NATURAL_LANGUAGE

/github/workspace/docs/schema/index.md
  29:67  ✓ error  Incorrect term: “key/value”, use “key-value” instead  terminology

/github/workspace/docs/schema/reference/base/infrastructure.md
  45:74  ✓ error  Incorrect term: “Key/value”, use “Key-value” instead  terminology

/github/workspace/docs/schema/reference/base/land.md
   9:74  ✓ error  Incorrect term: “TODO”, use “Todo” instead            terminology
  55:74  ✓ error  Incorrect term: “Key/value”, use “Key-value” instead  terminology

/github/workspace/docs/schema/reference/base/land_use.md
  50:74  ✓ error  Incorrect term: “Key/value”, use “Key-value” instead  terminology

/github/workspace/docs/schema/reference/base/water.md
  66:74  ✓ error  Incorrect term: “Key/value”, use “Key-value” instead  terminology

/github/workspace/docs/schema/reference/base/types/source_tags.md
  3:1  ✓ error  Incorrect term: “Key/value”, use “Key-value” instead  terminology

/github/workspace/docs/schema/reference/places/place.md
  37:49  ✓ error  Incorrect term: “websites”, use “sites” instead  terminology

/github/workspace/docs/schema/reference/system/ref/id.md
  1:3  ✓ error  Incorrect term: “Id”, use “ID” instead  terminology

/github/workspace/docs/schema/reference/system/snake_case_string.md
  3:28  ✓ error  Incorrect term: “snake case”, use “snake_case” instead  terminology
  9:38  ✓ error  Incorrect term: “snake case”, use “snake_case” instead  terminology

✖ 11 problems (11 errors, 0 warnings, 0 infos)
✓ 11 fixable problems.
Try to run: $ textlint --fix [file]

@danabauer Dana Bauer (danabauer) merged commit 0cbd015 into main Mar 6, 2026
3 of 7 checks passed
@danabauer Dana Bauer (danabauer) deleted the transpo-guide branch March 6, 2026 18:32
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.

3 participants