Skip to content

[WIP] new transportation guide#281

Open
Dana Bauer (danabauer) wants to merge 2 commits intomainfrom
transpo-guide
Open

[WIP] new transportation guide#281
Dana Bauer (danabauer) wants to merge 2 commits intomainfrom
transpo-guide

Conversation

@danabauer
Copy link
Collaborator

@danabauer Dana Bauer (danabauer) commented Mar 3, 2026 •
edited
Loading

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

  • edit text
  • reformat section headings
  • move transportation splitter to its own page

@danabauer Dana Bauer (danabauer) requested a review from a team as a code owner March 3, 2026 22:01
@github-actions
Copy link

github-actions bot commented Mar 3, 2026 •
edited
Loading

🚀 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-03T22:18:52Z

@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]

Rachmanin0xFF
Adam Lastowka (Rachmanin0xFF) approved these changes Mar 3, 2026
View reviewed changes
Copy link

@Rachmanin0xFF Adam Lastowka (Rachmanin0xFF) left a comment

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.

docs/guides/transportation/overview.mdx
| theme | string | Name of the Overture theme being queried. |
| type | string | Name of the Overture feature type being queried. |
- The **segment** type has a LineString geometry that represents the center-line of a path repeatedly traversed by people or objects. Segment properties describe both the physical properties (e.g. road surface and width) and non-physical properties (e.g. access restriction rules) of that path.
- The **connector** type has a Point geometry that defines the topology of the transportation network by representing the physical connection between two or more segments. Connectors do not have properties beyond geometry and the common properties required for all Overture features.
Copy link

@Rachmanin0xFF Adam Lastowka (Rachmanin0xFF) Mar 3, 2026

Choose a reason for hiding this comment

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

Nit: the connector type doesn't really "[define] the topology" of the network; that information lives within the connectors field within the segment type. The connector type is just a convenient list of "the positions of all links between segments", but this is redundant information that can be reconstructed from the segments alone.

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

Reviewers

@Rachmanin0xFF Adam Lastowka (Rachmanin0xFF) Rachmanin0xFF approved these changes

@brad-richardson Brad Richardson (brad-richardson) Awaiting requested review from brad-richardson

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@danabauer @Rachmanin0xFF