From fd8329ee29ee29a26d2a933053d496521aa06857 Mon Sep 17 00:00:00 2001
From: John McCall <john@overturemaps.org>
Date: Mon, 14 Sep 2026 16:17:50 -0400
Subject: [PATCH 1/3] [FEATURE] Version the schema reference docs per released
 schema tag

Schema reference becomes its own versioned Docusaurus docs instance.
latest is generated from the schema repo's main on every build and served
at /schema/; released tags are snapshotted once into schema_versioned_docs/
and served at /schema/<tag>/. Adds scripts/add-schema-version.mjs plus
snapshots for v1.17.0, v1.18.0, and v2.0.0.

Closes OvertureMaps/docs#452

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Signed-off-by: John McCall <john@overturemaps.org>
---
 .gitattributes                                |   2 +
 .github/workflows/ci.yml                      |   2 +-
 .github/workflows/lint.yml                    |   2 +
 .../production_deploy_documentation.yml       |   2 +-
 .github/workflows/staging_deploy.yaml         |   2 +-
 .gitignore                                    |   4 +-
 .markdownlintignore                           |   3 +-
 README.md                                     |  33 ++-
 docusaurus.config.js                          | 152 ++++++----
 package.json                                  |   5 +-
 {docs/schema => schema}/index.md              |   2 +-
 .../version-v1.17.0/index.md                  |  58 ++++
 .../reference/addresses/_category_.json       |   4 +
 .../reference/addresses/address.md            |  76 +++++
 .../reference/addresses/types/_category_.json |   3 +
 .../addresses/types/address_level.md          |  26 ++
 .../reference/base/_category_.json            |   4 +
 .../reference/base/bathymetry.md              |  59 ++++
 .../reference/base/infrastructure.md          |  77 +++++
 .../version-v1.17.0/reference/base/land.md    |  87 ++++++
 .../reference/base/land_cover.md              |  66 +++++
 .../reference/base/land_use.md                |  82 ++++++
 .../reference/base/types/_category_.json      |   3 +
 .../reference/base/types/depth.md             |  15 +
 .../reference/base/types/elevation.md         |  16 +
 .../reference/base/types/height.md            |  13 +
 .../base/types/infrastructure_class.md        | 176 +++++++++++
 .../base/types/infrastructure_subtype.md      |  30 ++
 .../reference/base/types/land_class.md        |  54 ++++
 .../base/types/land_cover_subtype.md          |  20 ++
 .../reference/base/types/land_subtype.md      |  25 ++
 .../reference/base/types/land_use_class.md    | 121 ++++++++
 .../reference/base/types/land_use_subtype.md  |  36 +++
 .../reference/base/types/source_tags.md       |  15 +
 .../reference/base/types/surface_material.md  |  36 +++
 .../reference/base/types/water_class.md       |  47 +++
 .../reference/base/types/water_subtype.md     |  24 ++
 .../version-v1.17.0/reference/base/water.md   |  98 +++++++
 .../reference/buildings/_category_.json       |   4 +
 .../reference/buildings/building.md           | 102 +++++++
 .../reference/buildings/building_part.md      | 101 +++++++
 .../reference/buildings/types/_category_.json |   3 +
 .../buildings/types/building_class.md         |  99 +++++++
 .../buildings/types/building_subtype.md       |  25 ++
 .../buildings/types/facade_material.md        |  22 ++
 .../buildings/types/roof_material.md          |  25 ++
 .../buildings/types/roof_orientation.md       |  16 +
 .../reference/buildings/types/roof_shape.md   |  25 ++
 .../reference/common/_category_.json          |   4 +
 .../reference/common/cartographic_hints.md    |  18 ++
 .../reference/common/common_names.md          |  10 +
 .../reference/common/confidence_score.md      |  15 +
 .../reference/common/feature_version.md       |  27 ++
 .../reference/common/length_unit.md           |  19 ++
 .../version-v1.17.0/reference/common/level.md |  20 ++
 .../reference/common/max_zoom.md              |  23 ++
 .../reference/common/min_zoom.md              |  23 ++
 .../reference/common/name_rule.md             |  32 ++
 .../reference/common/name_variant.md          |  22 ++
 .../version-v1.17.0/reference/common/names.md |  33 +++
 .../reference/common/perspective_mode.md      |  12 +
 .../reference/common/perspectives.md          |  16 +
 .../reference/common/prominence.md            |  23 ++
 .../reference/common/scoping/_category_.json  |   3 +
 .../reference/common/scoping/heading.md       |  17 ++
 .../scoping/linearly_referenced_position.md   |  15 +
 .../scoping/linearly_referenced_range.md      |  26 ++
 .../reference/common/scoping/opening_hours.md |  12 +
 .../common/scoping/purpose_of_use.md          |  18 ++
 .../common/scoping/recognized_status.md       |  18 ++
 .../reference/common/scoping/side.md          |  15 +
 .../reference/common/scoping/travel_mode.md   |  25 ++
 .../scoping/vehicle_axle_count_selector.md    |  17 ++
 .../common/scoping/vehicle_height_selector.md |  18 ++
 .../common/scoping/vehicle_length_selector.md |  18 ++
 .../common/scoping/vehicle_relation.md        |  19 ++
 .../common/scoping/vehicle_weight_selector.md |  18 ++
 .../common/scoping/vehicle_width_selector.md  |  18 ++
 .../reference/common/sort_key.md              |  17 ++
 .../reference/common/source_item.md           |  34 +++
 .../reference/common/sources.md               |  28 ++
 .../reference/common/speed_unit.md            |  12 +
 .../reference/common/weight_unit.md           |  17 ++
 .../reference/divisions/_category_.json       |   4 +
 .../reference/divisions/division.md           | 132 +++++++++
 .../reference/divisions/division_area.md      |  88 ++++++
 .../reference/divisions/division_boundary.md  |  85 ++++++
 .../reference/divisions/types/_category_.json |   3 +
 .../reference/divisions/types/admin_level.md  |  19 ++
 .../reference/divisions/types/area_class.md   |  15 +
 .../divisions/types/boundary_class.md         |  13 +
 .../types/capital_of_division_item.md         |  14 +
 .../divisions/types/division_class.md         |  20 ++
 .../divisions/types/division_subtype.md       |  35 +++
 .../reference/divisions/types/hierarchy.md    |  21 ++
 .../divisions/types/hierarchy_item.md         |  16 +
 .../reference/divisions/types/norms.md        |  13 +
 .../reference/places/_category_.json          |   4 +
 .../version-v1.17.0/reference/places/place.md | 115 ++++++++
 .../reference/places/types/_category_.json    |   3 +
 .../reference/places/types/address.md         |  17 ++
 .../reference/places/types/brand.md           |  27 ++
 .../reference/places/types/categories.md      |  16 +
 .../places/types/operating_status.md          |  19 ++
 .../reference/places/types/taxonomy.md        |  17 ++
 .../reference/pydantic/_category_.json        |   4 +
 .../pydantic/networks/_category_.json         |   3 +
 .../reference/pydantic/networks/email_str.md  |   7 +
 .../reference/pydantic/networks/http_url.md   |   9 +
 .../reference/system/_category_.json          |   4 +
 .../reference/system/country_code_alpha2.md   |  18 ++
 .../reference/system/hex_color.md             |  20 ++
 .../reference/system/json_pointer.md          |  23 ++
 .../reference/system/language_tag.md          |  27 ++
 .../reference/system/no_whitespace_string.md  |  13 +
 .../reference/system/phone_number.md          |  13 +
 .../system/primitive/_category_.json          |   3 +
 .../reference/system/primitive/geometry.md    |  11 +
 .../reference/system/primitive/primitives.md  |  27 ++
 .../reference/system/ref/_category_.json      |   3 +
 .../reference/system/ref/id.md                |  33 +++
 .../reference/system/region_code.md           |  16 +
 .../reference/system/snake_case_string.md     |  15 +
 .../reference/system/stripped_string.md       |  22 ++
 .../reference/system/wikidata_id.md           |  23 ++
 .../reference/transportation/_category_.json  |   4 +
 .../reference/transportation/connector.md     |  49 ++++
 .../reference/transportation/segment.md       | 168 +++++++++++
 .../transportation/types/_category_.json      |   3 +
 .../types/access_restriction_rule.md          |  20 ++
 .../types/access_restriction_rule.when.md     |  22 ++
 .../transportation/types/access_rules.md      |  14 +
 .../transportation/types/access_type.md       |  11 +
 .../types/connector_reference.md              |  15 +
 .../types/destination_label_type.md           |  16 +
 .../types/destination_labels.md               |  14 +
 .../transportation/types/destination_rule.md  |  25 ++
 .../types/destination_rule.when.md            |  13 +
 .../types/destination_sign_symbol.md          |  31 ++
 .../transportation/types/destinations.md      |   9 +
 .../transportation/types/level_rule.md        |  16 +
 .../transportation/types/level_rules.md       |   9 +
 .../types/prohibited_transition_rule.md       |  23 ++
 .../types/prohibited_transition_rule.when.md  |  22 ++
 .../types/prohibited_transitions.md           |   9 +
 .../transportation/types/rail_class.md        |  18 ++
 .../transportation/types/rail_flag.md         |  20 ++
 .../transportation/types/rail_flag_rule.md    |  15 +
 .../transportation/types/rail_flags.md        |  14 +
 .../transportation/types/road_class.md        |  27 ++
 .../transportation/types/road_flag.md         |  19 ++
 .../transportation/types/road_flag_rule.md    |  15 +
 .../transportation/types/road_flags.md        |  14 +
 .../transportation/types/road_surface.md      |  17 ++
 .../transportation/types/route_reference.md   |  19 ++
 .../reference/transportation/types/routes.md  |   9 +
 .../transportation/types/sequence_entry.md    |  14 +
 .../reference/transportation/types/speed.md   |  14 +
 .../transportation/types/speed_limit_rule.md  |  32 ++
 .../types/speed_limit_rule.when.md            |  22 ++
 .../transportation/types/speed_limits.md      |  14 +
 .../transportation/types/speed_value.md       |  16 +
 .../transportation/types/subclass.md          |  18 ++
 .../transportation/types/subclass_rule.md     |  15 +
 .../transportation/types/subclass_rules.md    |   9 +
 .../reference/transportation/types/subtype.md |  13 +
 .../transportation/types/surface_rule.md      |  13 +
 .../transportation/types/surfaces.md          |  14 +
 .../reference/transportation/types/width.md   |  11 +
 .../transportation/types/width_rule.md        |  13 +
 .../transportation/types/width_rules.md       |  16 +
 .../version-v1.18.0/index.md                  |  58 ++++
 .../reference/addresses/_category_.json       |   4 +
 .../reference/addresses/address.md            |  82 ++++++
 .../reference/addresses/types/_category_.json |   3 +
 .../addresses/types/address_level.md          |  26 ++
 .../reference/base/_category_.json            |   4 +
 .../reference/base/bathymetry.md              |  65 ++++
 .../reference/base/infrastructure.md          |  83 ++++++
 .../version-v1.18.0/reference/base/land.md    |  93 ++++++
 .../reference/base/land_cover.md              |  72 +++++
 .../reference/base/land_use.md                |  88 ++++++
 .../reference/base/types/_category_.json      |   3 +
 .../reference/base/types/depth.md             |  15 +
 .../reference/base/types/elevation.md         |  16 +
 .../reference/base/types/height.md            |  13 +
 .../base/types/infrastructure_class.md        | 176 +++++++++++
 .../base/types/infrastructure_subtype.md      |  30 ++
 .../reference/base/types/land_class.md        |  54 ++++
 .../base/types/land_cover_subtype.md          |  20 ++
 .../reference/base/types/land_subtype.md      |  25 ++
 .../reference/base/types/land_use_class.md    | 121 ++++++++
 .../reference/base/types/land_use_subtype.md  |  36 +++
 .../reference/base/types/source_tags.md       |  15 +
 .../reference/base/types/surface_material.md  |  36 +++
 .../reference/base/types/water_class.md       |  47 +++
 .../reference/base/types/water_subtype.md     |  24 ++
 .../version-v1.18.0/reference/base/water.md   | 104 +++++++
 .../reference/buildings/_category_.json       |   4 +
 .../reference/buildings/building.md           | 108 +++++++
 .../reference/buildings/building_part.md      | 107 +++++++
 .../reference/buildings/types/_category_.json |   3 +
 .../buildings/types/building_class.md         |  99 +++++++
 .../buildings/types/building_subtype.md       |  25 ++
 .../buildings/types/facade_material.md        |  22 ++
 .../buildings/types/roof_material.md          |  25 ++
 .../buildings/types/roof_orientation.md       |  16 +
 .../reference/buildings/types/roof_shape.md   |  25 ++
 .../reference/common/_category_.json          |   4 +
 .../reference/common/cartographic_hints.md    |  18 ++
 .../reference/common/common_names.md          |  10 +
 .../reference/common/confidence_score.md      |  15 +
 .../reference/common/feature_version.md       |  27 ++
 .../reference/common/length_unit.md           |  19 ++
 .../version-v1.18.0/reference/common/level.md |  20 ++
 .../reference/common/max_zoom.md              |  23 ++
 .../reference/common/min_zoom.md              |  23 ++
 .../reference/common/name_rule.md             |  32 ++
 .../reference/common/name_variant.md          |  22 ++
 .../version-v1.18.0/reference/common/names.md |  33 +++
 .../reference/common/perspective_mode.md      |  12 +
 .../reference/common/perspectives.md          |  16 +
 .../reference/common/prominence.md            |  23 ++
 .../reference/common/scoping/_category_.json  |   3 +
 .../reference/common/scoping/heading.md       |  17 ++
 .../scoping/linearly_referenced_position.md   |  15 +
 .../scoping/linearly_referenced_range.md      |  26 ++
 .../reference/common/scoping/opening_hours.md |  12 +
 .../common/scoping/purpose_of_use.md          |  18 ++
 .../common/scoping/recognized_status.md       |  18 ++
 .../reference/common/scoping/side.md          |  15 +
 .../reference/common/scoping/travel_mode.md   |  25 ++
 .../scoping/vehicle_axle_count_selector.md    |  17 ++
 .../common/scoping/vehicle_height_selector.md |  18 ++
 .../common/scoping/vehicle_length_selector.md |  18 ++
 .../common/scoping/vehicle_relation.md        |  19 ++
 .../common/scoping/vehicle_weight_selector.md |  18 ++
 .../common/scoping/vehicle_width_selector.md  |  18 ++
 .../reference/common/sort_key.md              |  17 ++
 .../reference/common/source_item.md           |  37 +++
 .../reference/common/sources.md               |  28 ++
 .../reference/common/speed_unit.md            |  12 +
 .../reference/common/weight_unit.md           |  17 ++
 .../reference/divisions/_category_.json       |   4 +
 .../reference/divisions/division.md           | 138 +++++++++
 .../reference/divisions/division_area.md      |  94 ++++++
 .../reference/divisions/division_boundary.md  |  94 ++++++
 .../reference/divisions/types/_category_.json |   3 +
 .../reference/divisions/types/admin_level.md  |  19 ++
 .../reference/divisions/types/area_class.md   |  15 +
 .../divisions/types/boundary_class.md         |  13 +
 .../types/capital_of_division_item.md         |  14 +
 .../divisions/types/division_class.md         |  20 ++
 .../divisions/types/division_subtype.md       |  35 +++
 .../reference/divisions/types/hierarchy.md    |  21 ++
 .../divisions/types/hierarchy_item.md         |  16 +
 .../reference/divisions/types/norms.md        |  13 +
 .../reference/places/_category_.json          |   4 +
 .../version-v1.18.0/reference/places/place.md | 121 ++++++++
 .../reference/places/types/_category_.json    |   3 +
 .../reference/places/types/address.md         |  17 ++
 .../reference/places/types/brand.md           |  27 ++
 .../reference/places/types/categories.md      |  16 +
 .../places/types/operating_status.md          |  19 ++
 .../reference/places/types/taxonomy.md        |  17 ++
 .../reference/pydantic/_category_.json        |   4 +
 .../pydantic/networks/_category_.json         |   3 +
 .../reference/pydantic/networks/email_str.md  |   7 +
 .../reference/pydantic/networks/http_url.md   |   9 +
 .../reference/system/_category_.json          |   4 +
 .../reference/system/country_code_alpha2.md   |  18 ++
 .../reference/system/hex_color.md             |  20 ++
 .../reference/system/json_pointer.md          |  23 ++
 .../reference/system/language_tag.md          |  27 ++
 .../reference/system/no_whitespace_string.md  |  14 +
 .../reference/system/phone_number.md          |  13 +
 .../system/primitive/_category_.json          |   3 +
 .../reference/system/primitive/geometry.md    |  11 +
 .../reference/system/primitive/primitives.md  |  27 ++
 .../reference/system/ref/_category_.json      |   3 +
 .../reference/system/ref/id.md                |  33 +++
 .../reference/system/region_code.md           |  16 +
 .../reference/system/snake_case_string.md     |  16 +
 .../reference/system/stripped_string.md       |  22 ++
 .../reference/system/wikidata_id.md           |  23 ++
 .../reference/transportation/_category_.json  |   4 +
 .../reference/transportation/connector.md     |  55 ++++
 .../reference/transportation/segment.md       | 174 +++++++++++
 .../transportation/types/_category_.json      |   3 +
 .../types/access_restriction_rule.md          |  20 ++
 .../types/access_restriction_rule.when.md     |  22 ++
 .../transportation/types/access_rules.md      |  14 +
 .../transportation/types/access_type.md       |  11 +
 .../types/connector_reference.md              |  15 +
 .../types/destination_label_type.md           |  16 +
 .../types/destination_labels.md               |  14 +
 .../transportation/types/destination_rule.md  |  25 ++
 .../types/destination_rule.when.md            |  13 +
 .../types/destination_sign_symbol.md          |  31 ++
 .../transportation/types/destinations.md      |   9 +
 .../transportation/types/level_rule.md        |  16 +
 .../transportation/types/level_rules.md       |   9 +
 .../types/prohibited_transition_rule.md       |  23 ++
 .../types/prohibited_transition_rule.when.md  |  22 ++
 .../types/prohibited_transitions.md           |   9 +
 .../transportation/types/rail_class.md        |  18 ++
 .../transportation/types/rail_flag.md         |  20 ++
 .../transportation/types/rail_flag_rule.md    |  15 +
 .../transportation/types/rail_flags.md        |  14 +
 .../transportation/types/road_class.md        |  27 ++
 .../transportation/types/road_flag.md         |  19 ++
 .../transportation/types/road_flag_rule.md    |  15 +
 .../transportation/types/road_flags.md        |  14 +
 .../transportation/types/road_surface.md      |  17 ++
 .../transportation/types/route_reference.md   |  19 ++
 .../reference/transportation/types/routes.md  |   9 +
 .../transportation/types/sequence_entry.md    |  14 +
 .../reference/transportation/types/speed.md   |  14 +
 .../transportation/types/speed_limit_rule.md  |  32 ++
 .../types/speed_limit_rule.when.md            |  22 ++
 .../transportation/types/speed_limits.md      |  14 +
 .../transportation/types/speed_value.md       |  16 +
 .../transportation/types/subclass.md          |  18 ++
 .../transportation/types/subclass_rule.md     |  15 +
 .../transportation/types/subclass_rules.md    |   9 +
 .../reference/transportation/types/subtype.md |  13 +
 .../transportation/types/surface_rule.md      |  13 +
 .../transportation/types/surfaces.md          |  14 +
 .../reference/transportation/types/width.md   |  11 +
 .../transportation/types/width_rule.md        |  13 +
 .../transportation/types/width_rules.md       |  16 +
 schema_versioned_docs/version-v2.0.0/index.md |  58 ++++
 .../reference/addresses/_category_.json       |   4 +
 .../reference/addresses/address.md            |  82 ++++++
 .../reference/addresses/types/_category_.json |   3 +
 .../addresses/types/address_level.md          |  26 ++
 .../reference/base/_category_.json            |   4 +
 .../reference/base/bathymetry.md              |  65 ++++
 .../reference/base/infrastructure.md          |  83 ++++++
 .../version-v2.0.0/reference/base/land.md     |  93 ++++++
 .../reference/base/land_cover.md              |  72 +++++
 .../version-v2.0.0/reference/base/land_use.md |  88 ++++++
 .../reference/base/types/_category_.json      |   3 +
 .../reference/base/types/depth.md             |  15 +
 .../reference/base/types/elevation.md         |  16 +
 .../reference/base/types/height.md            |  13 +
 .../base/types/infrastructure_class.md        | 176 +++++++++++
 .../base/types/infrastructure_subtype.md      |  30 ++
 .../reference/base/types/land_class.md        |  54 ++++
 .../base/types/land_cover_subtype.md          |  20 ++
 .../reference/base/types/land_subtype.md      |  25 ++
 .../reference/base/types/land_use_class.md    | 121 ++++++++
 .../reference/base/types/land_use_subtype.md  |  36 +++
 .../reference/base/types/source_tags.md       |  15 +
 .../reference/base/types/surface_material.md  |  36 +++
 .../reference/base/types/water_class.md       |  47 +++
 .../reference/base/types/water_subtype.md     |  24 ++
 .../version-v2.0.0/reference/base/water.md    | 104 +++++++
 .../reference/buildings/_category_.json       |   4 +
 .../reference/buildings/building.md           | 108 +++++++
 .../reference/buildings/building_part.md      | 107 +++++++
 .../reference/buildings/types/_category_.json |   3 +
 .../buildings/types/building_class.md         | 100 +++++++
 .../buildings/types/building_subtype.md       |  25 ++
 .../buildings/types/facade_material.md        |  22 ++
 .../buildings/types/roof_material.md          |  25 ++
 .../buildings/types/roof_orientation.md       |  16 +
 .../reference/buildings/types/roof_shape.md   |  25 ++
 .../reference/common/_category_.json          |   4 +
 .../reference/common/cartographic_hints.md    |  18 ++
 .../reference/common/common_names.md          |  10 +
 .../reference/common/confidence_score.md      |  15 +
 .../reference/common/feature_version.md       |  27 ++
 .../reference/common/length_unit.md           |  19 ++
 .../version-v2.0.0/reference/common/level.md  |  20 ++
 .../reference/common/max_zoom.md              |  23 ++
 .../reference/common/min_zoom.md              |  23 ++
 .../reference/common/name_rule.md             |  32 ++
 .../reference/common/name_variant.md          |  22 ++
 .../version-v2.0.0/reference/common/names.md  |  33 +++
 .../reference/common/perspective_mode.md      |  12 +
 .../reference/common/perspectives.md          |  16 +
 .../reference/common/prominence.md            |  23 ++
 .../reference/common/scoping/_category_.json  |   3 +
 .../reference/common/scoping/heading.md       |  17 ++
 .../scoping/linearly_referenced_position.md   |  15 +
 .../scoping/linearly_referenced_range.md      |  26 ++
 .../reference/common/scoping/opening_hours.md |  12 +
 .../common/scoping/purpose_of_use.md          |  18 ++
 .../common/scoping/recognized_status.md       |  18 ++
 .../reference/common/scoping/side.md          |  15 +
 .../reference/common/scoping/travel_mode.md   |  25 ++
 .../scoping/vehicle_axle_count_selector.md    |  17 ++
 .../common/scoping/vehicle_height_selector.md |  18 ++
 .../common/scoping/vehicle_length_selector.md |  18 ++
 .../common/scoping/vehicle_relation.md        |  19 ++
 .../common/scoping/vehicle_weight_selector.md |  18 ++
 .../common/scoping/vehicle_width_selector.md  |  18 ++
 .../reference/common/sort_key.md              |  17 ++
 .../reference/common/source_item.md           |  37 +++
 .../reference/common/sources.md               |  28 ++
 .../reference/common/speed_unit.md            |  12 +
 .../reference/common/weight_unit.md           |  17 ++
 .../reference/divisions/_category_.json       |   4 +
 .../reference/divisions/division.md           | 132 +++++++++
 .../reference/divisions/division_area.md      |  99 +++++++
 .../reference/divisions/division_boundary.md  |  94 ++++++
 .../reference/divisions/types/_category_.json |   3 +
 .../reference/divisions/types/admin_level.md  |  19 ++
 .../reference/divisions/types/area_class.md   |  15 +
 .../divisions/types/boundary_class.md         |  13 +
 .../types/capital_of_division_item.md         |  14 +
 .../divisions/types/division_class.md         |  20 ++
 .../divisions/types/division_subtype.md       |  35 +++
 .../reference/divisions/types/hierarchy.md    |  21 ++
 .../divisions/types/hierarchy_item.md         |  16 +
 .../reference/divisions/types/norms.md        |  13 +
 .../reference/places/_category_.json          |   4 +
 .../version-v2.0.0/reference/places/place.md  | 118 ++++++++
 .../reference/places/types/_category_.json    |   3 +
 .../reference/places/types/address.md         |  17 ++
 .../reference/places/types/brand.md           |  27 ++
 .../places/types/operating_status.md          |  19 ++
 .../reference/places/types/taxonomy.md        |  17 ++
 .../reference/pydantic/_category_.json        |   4 +
 .../pydantic/networks/_category_.json         |   3 +
 .../reference/pydantic/networks/email_str.md  |   7 +
 .../reference/pydantic/networks/http_url.md   |   9 +
 .../reference/system/_category_.json          |   4 +
 .../reference/system/country_code_alpha2.md   |  18 ++
 .../reference/system/geometric.md             |  11 +
 .../reference/system/hex_color.md             |  20 ++
 .../reference/system/json_pointer.md          |  23 ++
 .../reference/system/language_tag.md          |  27 ++
 .../reference/system/no_whitespace_string.md  |  14 +
 .../reference/system/numeric.md               |  27 ++
 .../reference/system/phone_number.md          |  13 +
 .../reference/system/ref/_category_.json      |   3 +
 .../version-v2.0.0/reference/system/ref/id.md |  33 +++
 .../reference/system/region_code.md           |  16 +
 .../reference/system/snake_case_string.md     |  15 +
 .../reference/system/stripped_string.md       |  22 ++
 .../reference/system/wikidata_id.md           |  23 ++
 .../reference/transportation/_category_.json  |   4 +
 .../reference/transportation/connector.md     |  55 ++++
 .../reference/transportation/segment.md       | 277 ++++++++++++++++++
 .../transportation/types/_category_.json      |   3 +
 .../types/segment/_category_.json             |   3 +
 .../types/segment/access_rule.md              |  26 ++
 .../types/segment/access_rule.when.md         |  22 ++
 .../types/segment/access_rules.md             |  14 +
 .../types/segment/access_type.md              |  13 +
 .../types/segment/connector_reference.md      |  15 +
 .../types/segment/destination_label_type.md   |  16 +
 .../types/segment/destination_labels.md       |  14 +
 .../types/segment/destination_rule.md         |  32 ++
 .../types/segment/destination_rule.when.md    |  13 +
 .../types/segment/destination_sign_symbol.md  |  31 ++
 .../types/segment/destinations.md             |  13 +
 .../types/segment/level_rule.md               |  16 +
 .../types/segment/level_rules.md              |   9 +
 .../segment/prohibited_transition_rule.md     |  36 +++
 .../prohibited_transition_rule.when.md        |  22 ++
 .../prohibited_transition_sequence_entry.md   |  14 +
 .../types/segment/prohibited_transitions.md   |   9 +
 .../types/segment/rail_class.md               |  18 ++
 .../transportation/types/segment/rail_flag.md |  20 ++
 .../types/segment/rail_flag_rule.md           |  15 +
 .../types/segment/rail_flags.md               |  15 +
 .../types/segment/road_class.md               |  27 ++
 .../transportation/types/segment/road_flag.md |  19 ++
 .../types/segment/road_flag_rule.md           |  15 +
 .../types/segment/road_flags.md               |  15 +
 .../types/segment/road_subclass.md            |  18 ++
 .../types/segment/road_subclass_rule.md       |  15 +
 .../types/segment/road_subclass_rules.md      |   9 +
 .../types/segment/road_surface.md             |  17 ++
 .../types/segment/road_surface_rule.md        |  16 +
 .../types/segment/road_surfaces.md            |  15 +
 .../types/segment/route_reference.md          |  19 ++
 .../transportation/types/segment/routes.md    |   9 +
 .../types/segment/segment_subtype.md          |  13 +
 .../transportation/types/segment/speed.md     |  14 +
 .../types/segment/speed_limit_rule.md         |  32 ++
 .../types/segment/speed_limit_rule.when.md    |  22 ++
 .../types/segment/speed_limits.md             |  14 +
 .../types/segment/speed_value.md              |  16 +
 .../transportation/types/segment/width.md     |  11 +
 .../types/segment/width_rule.md               |  15 +
 .../types/segment/width_rules.md              |  20 ++
 .../version-v1.17.0-sidebars.json             |  14 +
 .../version-v1.18.0-sidebars.json             |  14 +
 .../version-v2.0.0-sidebars.json              |  14 +
 schema_versions.json                          |   5 +
 scripts/add-schema-version.mjs                |  91 ++++++
 sidebars-schema.js                            |  14 +
 sidebars.js                                   |   9 +-
 src/css/custom.css                            |   8 +
 498 files changed, 13404 insertions(+), 74 deletions(-)
 create mode 100644 .gitattributes
 rename {docs/schema => schema}/index.md (99%)
 create mode 100644 schema_versioned_docs/version-v1.17.0/index.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/addresses/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/addresses/address.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/addresses/types/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/addresses/types/address_level.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/bathymetry.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/infrastructure.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/land.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/land_cover.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/land_use.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/depth.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/elevation.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/height.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/infrastructure_class.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/infrastructure_subtype.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/land_class.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/land_cover_subtype.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/land_subtype.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/land_use_class.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/land_use_subtype.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/source_tags.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/surface_material.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/water_class.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/water_subtype.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/water.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/building.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/building_part.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/types/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/types/building_class.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/types/building_subtype.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/types/facade_material.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_material.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_orientation.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_shape.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/cartographic_hints.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/common_names.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/confidence_score.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/feature_version.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/length_unit.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/level.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/max_zoom.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/min_zoom.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/name_rule.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/name_variant.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/names.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/perspective_mode.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/perspectives.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/prominence.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/heading.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/linearly_referenced_position.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/linearly_referenced_range.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/opening_hours.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/purpose_of_use.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/recognized_status.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/side.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/travel_mode.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_axle_count_selector.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_height_selector.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_length_selector.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_relation.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_weight_selector.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_width_selector.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/sort_key.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/source_item.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/sources.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/speed_unit.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/weight_unit.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/division.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/division_area.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/division_boundary.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/admin_level.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/area_class.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/boundary_class.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/capital_of_division_item.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/division_class.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/division_subtype.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/hierarchy.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/hierarchy_item.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/norms.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/places/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/places/place.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/places/types/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/places/types/address.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/places/types/brand.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/places/types/categories.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/places/types/operating_status.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/places/types/taxonomy.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/pydantic/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/email_str.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/http_url.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/country_code_alpha2.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/hex_color.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/json_pointer.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/language_tag.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/no_whitespace_string.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/phone_number.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/primitive/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/primitive/geometry.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/primitive/primitives.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/ref/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/ref/id.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/region_code.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/snake_case_string.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/stripped_string.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/wikidata_id.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/connector.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/segment.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_restriction_rule.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_restriction_rule.when.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_rules.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_type.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/connector_reference.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_label_type.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_labels.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_rule.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_rule.when.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_sign_symbol.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/destinations.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/level_rule.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/level_rules.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transition_rule.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transition_rule.when.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transitions.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_class.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flag.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flag_rule.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flags.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_class.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flag.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flag_rule.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flags.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_surface.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/route_reference.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/routes.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/sequence_entry.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limit_rule.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limit_rule.when.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limits.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_value.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass_rule.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass_rules.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/subtype.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/surface_rule.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/surfaces.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/width.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/width_rule.md
 create mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/width_rules.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/index.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/addresses/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/addresses/address.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/addresses/types/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/addresses/types/address_level.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/bathymetry.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/infrastructure.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/land.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/land_cover.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/land_use.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/types/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/types/depth.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/types/elevation.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/types/height.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/types/infrastructure_class.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/types/infrastructure_subtype.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/types/land_class.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/types/land_cover_subtype.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/types/land_subtype.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/types/land_use_class.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/types/land_use_subtype.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/types/source_tags.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/types/surface_material.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/types/water_class.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/types/water_subtype.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/base/water.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/buildings/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/buildings/building.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/buildings/building_part.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/buildings/types/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/buildings/types/building_class.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/buildings/types/building_subtype.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/buildings/types/facade_material.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/buildings/types/roof_material.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/buildings/types/roof_orientation.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/buildings/types/roof_shape.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/cartographic_hints.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/common_names.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/confidence_score.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/feature_version.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/length_unit.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/level.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/max_zoom.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/min_zoom.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/name_rule.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/name_variant.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/names.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/perspective_mode.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/perspectives.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/prominence.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/scoping/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/scoping/heading.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/scoping/linearly_referenced_position.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/scoping/linearly_referenced_range.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/scoping/opening_hours.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/scoping/purpose_of_use.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/scoping/recognized_status.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/scoping/side.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/scoping/travel_mode.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_axle_count_selector.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_height_selector.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_length_selector.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_relation.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_weight_selector.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_width_selector.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/sort_key.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/source_item.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/sources.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/speed_unit.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/common/weight_unit.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/divisions/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/divisions/division.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/divisions/division_area.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/divisions/division_boundary.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/divisions/types/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/divisions/types/admin_level.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/divisions/types/area_class.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/divisions/types/boundary_class.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/divisions/types/capital_of_division_item.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/divisions/types/division_class.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/divisions/types/division_subtype.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/divisions/types/hierarchy.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/divisions/types/hierarchy_item.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/divisions/types/norms.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/places/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/places/place.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/places/types/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/places/types/address.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/places/types/brand.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/places/types/categories.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/places/types/operating_status.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/places/types/taxonomy.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/pydantic/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/pydantic/networks/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/pydantic/networks/email_str.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/pydantic/networks/http_url.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/system/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/system/country_code_alpha2.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/system/hex_color.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/system/json_pointer.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/system/language_tag.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/system/no_whitespace_string.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/system/phone_number.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/system/primitive/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/system/primitive/geometry.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/system/primitive/primitives.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/system/ref/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/system/ref/id.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/system/region_code.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/system/snake_case_string.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/system/stripped_string.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/system/wikidata_id.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/connector.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/segment.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/_category_.json
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/access_restriction_rule.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/access_restriction_rule.when.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/access_rules.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/access_type.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/connector_reference.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_label_type.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_labels.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_rule.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_rule.when.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_sign_symbol.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/destinations.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/level_rule.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/level_rules.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/prohibited_transition_rule.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/prohibited_transition_rule.when.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/prohibited_transitions.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/rail_class.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/rail_flag.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/rail_flag_rule.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/rail_flags.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_class.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_flag.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_flag_rule.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_flags.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_surface.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/route_reference.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/routes.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/sequence_entry.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed_limit_rule.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed_limit_rule.when.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed_limits.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed_value.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/subclass.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/subclass_rule.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/subclass_rules.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/subtype.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/surface_rule.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/surfaces.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/width.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/width_rule.md
 create mode 100644 schema_versioned_docs/version-v1.18.0/reference/transportation/types/width_rules.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/index.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/addresses/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/addresses/address.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/addresses/types/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/addresses/types/address_level.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/bathymetry.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/infrastructure.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/land.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/land_cover.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/land_use.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/types/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/types/depth.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/types/elevation.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/types/height.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/types/infrastructure_class.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/types/infrastructure_subtype.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/types/land_class.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/types/land_cover_subtype.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/types/land_subtype.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/types/land_use_class.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/types/land_use_subtype.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/types/source_tags.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/types/surface_material.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/types/water_class.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/types/water_subtype.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/base/water.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/buildings/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/buildings/building.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/buildings/building_part.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/buildings/types/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/buildings/types/building_class.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/buildings/types/building_subtype.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/buildings/types/facade_material.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/buildings/types/roof_material.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/buildings/types/roof_orientation.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/buildings/types/roof_shape.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/cartographic_hints.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/common_names.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/confidence_score.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/feature_version.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/length_unit.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/level.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/max_zoom.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/min_zoom.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/name_rule.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/name_variant.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/names.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/perspective_mode.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/perspectives.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/prominence.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/scoping/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/scoping/heading.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/scoping/linearly_referenced_position.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/scoping/linearly_referenced_range.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/scoping/opening_hours.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/scoping/purpose_of_use.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/scoping/recognized_status.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/scoping/side.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/scoping/travel_mode.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_axle_count_selector.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_height_selector.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_length_selector.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_relation.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_weight_selector.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_width_selector.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/sort_key.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/source_item.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/sources.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/speed_unit.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/common/weight_unit.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/divisions/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/divisions/division.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/divisions/division_area.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/divisions/division_boundary.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/divisions/types/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/divisions/types/admin_level.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/divisions/types/area_class.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/divisions/types/boundary_class.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/divisions/types/capital_of_division_item.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/divisions/types/division_class.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/divisions/types/division_subtype.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/divisions/types/hierarchy.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/divisions/types/hierarchy_item.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/divisions/types/norms.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/places/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/places/place.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/places/types/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/places/types/address.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/places/types/brand.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/places/types/operating_status.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/places/types/taxonomy.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/pydantic/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/pydantic/networks/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/pydantic/networks/email_str.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/pydantic/networks/http_url.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/system/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/system/country_code_alpha2.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/system/geometric.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/system/hex_color.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/system/json_pointer.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/system/language_tag.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/system/no_whitespace_string.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/system/numeric.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/system/phone_number.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/system/ref/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/system/ref/id.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/system/region_code.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/system/snake_case_string.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/system/stripped_string.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/system/wikidata_id.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/connector.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/segment.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/_category_.json
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/access_rule.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/access_rule.when.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/access_rules.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/access_type.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/connector_reference.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_label_type.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_labels.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_rule.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_rule.when.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_sign_symbol.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destinations.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/level_rule.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/level_rules.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/prohibited_transition_rule.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/prohibited_transition_rule.when.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/prohibited_transition_sequence_entry.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/prohibited_transitions.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/rail_class.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/rail_flag.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/rail_flag_rule.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/rail_flags.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_class.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_flag.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_flag_rule.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_flags.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_subclass.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_subclass_rule.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_subclass_rules.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_surface.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_surface_rule.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_surfaces.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/route_reference.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/routes.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/segment_subtype.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed_limit_rule.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed_limit_rule.when.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed_limits.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed_value.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/width.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/width_rule.md
 create mode 100644 schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/width_rules.md
 create mode 100644 schema_versioned_sidebars/version-v1.17.0-sidebars.json
 create mode 100644 schema_versioned_sidebars/version-v1.18.0-sidebars.json
 create mode 100644 schema_versioned_sidebars/version-v2.0.0-sidebars.json
 create mode 100644 schema_versions.json
 create mode 100644 scripts/add-schema-version.mjs
 create mode 100644 sidebars-schema.js

diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 000000000..2f0003bc2
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,2 @@
+# Generated schema snapshots; codegen emits CRLF on Windows
+schema_versioned_docs/** text eol=lf
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 9485fbb7d..5a2207485 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -59,7 +59,7 @@ jobs:
       - name: Generate schema markdown docs
         uses: OvertureMaps/workflows/.github/actions/generate-schema-docs@faa3fa4bbe01d85dc2e2139ff1f74ce70feb7df9 # zizmor: ignore[stale-action-refs] - main
         with:
-          output-dir: ${{ github.workspace }}/docs/schema/reference
+          output-dir: ${{ github.workspace }}/schema/reference
           schema-ref: 'main'
 
       - name: Build
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index b21a13aae..ccb4dbe80 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -37,6 +37,8 @@ jobs:
           ENABLE_GITHUB_PULL_REQUEST_SUMMARY_COMMENT: true
           ENABLE_GITHUB_ACTIONS_STEP_SUMMARY: true
           VALIDATE_ALL_CODEBASE: true
+          # Generated schema reference snapshots; fix upstream in OvertureMaps/schema
+          FILTER_REGEX_EXCLUDE: .*schema_versioned_docs/.*
           # Enable only Markdown (markdownlint), natural language (textlint),
           # and SQL (sqlfluff). Setting any VALIDATE_* to true causes all
           # other linters to default to false.
diff --git a/.github/workflows/production_deploy_documentation.yml b/.github/workflows/production_deploy_documentation.yml
index f057ad66f..47156096b 100644
--- a/.github/workflows/production_deploy_documentation.yml
+++ b/.github/workflows/production_deploy_documentation.yml
@@ -48,7 +48,7 @@ jobs:
       - name: Generate schema markdown docs
         uses: OvertureMaps/workflows/.github/actions/generate-schema-docs@faa3fa4bbe01d85dc2e2139ff1f74ce70feb7df9 # zizmor: ignore[stale-action-refs] - main
         with:
-          output-dir: ${{ github.workspace }}/docs/schema/reference
+          output-dir: ${{ github.workspace }}/schema/reference
           schema-ref: ${{ inputs['schema-ref'] || 'main' }}
 
       - name: Build Docusaurus Pages 🔧
diff --git a/.github/workflows/staging_deploy.yaml b/.github/workflows/staging_deploy.yaml
index 7c0ab2aa8..b6598c276 100644
--- a/.github/workflows/staging_deploy.yaml
+++ b/.github/workflows/staging_deploy.yaml
@@ -59,7 +59,7 @@ jobs:
         id: schema-docs
         uses: OvertureMaps/workflows/.github/actions/generate-schema-docs@faa3fa4bbe01d85dc2e2139ff1f74ce70feb7df9 # zizmor: ignore[stale-action-refs] - main
         with:
-          output-dir: ${{ github.workspace }}/docs/schema/reference
+          output-dir: ${{ github.workspace }}/schema/reference
           schema-ref: 'main'
 
       - name: Build Docusaurus website
diff --git a/.gitignore b/.gitignore
index 7880b1905..a67feca7f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -5,5 +5,5 @@ build/
 static/maplibre/
 
 # Schema reference docs are generated at build time by the
-# generate-schema-docs action; see docs/schema/index.md.
-docs/schema/reference/
+# generate-schema-docs action; see schema/index.md and README.
+schema/reference/
diff --git a/.markdownlintignore b/.markdownlintignore
index 6db204d22..2081b3b0c 100644
--- a/.markdownlintignore
+++ b/.markdownlintignore
@@ -1,2 +1,3 @@
 # Generated by OvertureMaps/schema — do not lint
-docs/schema/reference/
+schema/reference/
+schema_versioned_docs/
diff --git a/README.md b/README.md
index e604e9d37..339f05c3c 100644
--- a/README.md
+++ b/README.md
@@ -17,15 +17,41 @@ This repository uses [Docusaurus](https://docusaurus.io/) to publish the documen
   - `community-projects.json` - source data for all community project cards
   - `og-image-cache.json` - cached `og:image` URLs for entries without an explicit `image` field (see [OG Image Cache](#og-image-cache) below)
 - `docs/`: The main documentation pages available at docs.overturemaps.org/. The sidebar for these pages is manually curated in the `sidebars.js` file.
-- Notice there is no `schema reference` folder. See below.
+- `schema/`: The schema reference overview page and the build-time output of the schema doc generator. See below.
+- `schema_versioned_docs/`, `schema_versioned_sidebars/`, `schema_versions.json`: committed snapshots of the schema reference for each released schema tag. See below.
 
 ## Schema Reference (`docs.overturemaps.org/schema`)
 
 The Overture schema repository [OvertureMaps/schema](https://github.com/OvertureMaps/schema) maintains the official Overture schema as Pydantic models, and the reference pages under `docs.overturemaps.org/schema` are generated directly from those models. This keeps the schema and its documentation permanently in sync.
 
-Every build (CI, PR preview, and production) runs the [`generate-schema-docs`](https://github.com/OvertureMaps/workflows/tree/main/.github/actions/generate-schema-docs) action, which generates Markdown into `docs/schema/reference/` from the schema repository's `main` branch (or a specific `schema-ref` when triggered via `workflow_dispatch`, e.g. from an `overture-schema` release). `docs/schema/reference/` is gitignored and never committed here.
+The schema reference is its own [versioned Docusaurus docs instance](https://docusaurus.io/docs/versioning) (plugin id `schema`, config in `docusaurus.config.js`, sidebar in `sidebars-schema.js`), separate from the main `docs/` instance. A version dropdown appears in the navbar on schema pages only.
 
-**If you spot a typo or error under `docs.overturemaps.org/schema`, it is not fixable in this repository.** Open an issue or PR against the docstrings/models in [OvertureMaps/schema](https://github.com/OvertureMaps/schema) instead — any change here will be overwritten on the next build.
+| Version | Source | URL | Where it lives |
+|---------|--------|-----|----------------|
+| `latest` | schema repo `main`, generated on every build | `/schema/` | `schema/reference/` (gitignored, never committed) |
+| `vX.Y.Z` | schema release tag, generated once | `/schema/vX.Y.Z/` | `schema_versioned_docs/version-vX.Y.Z/` (committed) |
+
+Every build (CI, PR preview, and production) runs the [`generate-schema-docs`](https://github.com/OvertureMaps/workflows/tree/main/.github/actions/generate-schema-docs) action, which generates Markdown into `schema/reference/` from the schema repository's `main` branch (or a specific `schema-ref` when triggered via `workflow_dispatch`, e.g. from an `overture-schema` release).
+
+**If you spot a typo or error under `docs.overturemaps.org/schema`, it is not fixable in this repository.** Open an issue or PR against the docstrings/models in [OvertureMaps/schema](https://github.com/OvertureMaps/schema) instead. `latest` picks up the fix on the next build; a released version only changes if its snapshot is regenerated (delete the three version artifacts and re-run the script below).
+
+### Adding a schema version
+
+Run this after a `vX.Y.Z` tag is published in [OvertureMaps/schema](https://github.com/OvertureMaps/schema/releases). It needs `git`, [`uv`](https://docs.astral.sh/uv/), and `npm install` already done.
+
+```shell
+npm run add-schema-version -- v2.0.0
+```
+
+The script (`scripts/add-schema-version.mjs`) clones the schema repo at that tag, runs its `overture-codegen` into `schema/reference/`, then runs `docusaurus docs:version:schema <tag>`, which writes:
+
+- `schema_versioned_docs/version-<tag>/`
+- `schema_versioned_sidebars/version-<tag>-sidebars.json`
+- an entry in `schema_versions.json` (kept sorted newest-first)
+
+Commit those three and open a PR. `schema/reference/` is cleaned up afterwards.
+
+Only tags that ship the `overture-schema-codegen` package (v1.17.0 and later) can be added; earlier releases were JSON Schema and have no generator. The script refuses tags that don't match `vX.Y.Z` or are already in `schema_versions.json`.
 
 ## Developing
 
@@ -51,6 +77,7 @@ Now navigate to <http://localhost:3000> to see the live preview.
 - `npm run serve` - Serve the built site locally
 - `npm run deploy` - Deploy the site
 - `npm run fetch-og` - Fetch and cache `og:image` metadata for community project entries (see [OG Image Cache](#og-image-cache) below)
+- `npm run add-schema-version -- vX.Y.Z` - Snapshot the schema reference for a released schema tag (see [Adding a schema version](#adding-a-schema-version) above)
 - `npm run swizzle` - Customize Docusaurus components by "ejecting" them for modification
 - `npm run write-translations` - Generate translation files for internationalization
 - `npm run write-heading-ids` - Auto-generate heading IDs for better linking
diff --git a/docusaurus.config.js b/docusaurus.config.js
index 2da1c2fbb..3108909fd 100644
--- a/docusaurus.config.js
+++ b/docusaurus.config.js
@@ -2,6 +2,7 @@
 // Note: type annotations allow type checking and IDEs autocompletion
 
 const { themes } = require('prism-react-renderer');
+const schemaVersions = require('./schema_versions.json');
 
 // both modes use the dark palette — code blocks are forced dark bg in
 // light mode too (see custom.css), so light-theme token colors fail contrast.
@@ -40,6 +41,17 @@ function getLatestOvertureRelease() {
 
 const latestOvertureRelease = getLatestOvertureRelease();
 
+// Schema reference docs are a separate, versioned docs instance (see README
+// "Schema Reference"). `current` is generated at build time from the schema
+// repo's default branch into schema/reference and served at /schema/; released
+// tags live in schema_versioned_docs/ and are served at /schema/<tag>/. Released
+// versions are stable, so suppress the default "unmaintained" banner on them.
+// It can't live under docs/: nested docs instances get their MDX compiled twice.
+const schemaVersionConfig = {
+  current: { label: 'latest', path: '' },
+  ...Object.fromEntries(schemaVersions.map((v) => [v, { label: v, banner: 'none' }])),
+};
+
 /** @type {import('@docusaurus/types').Config} */
 const config = {
   title: 'Overture Documentation',
@@ -95,62 +107,83 @@ const config = {
 
   themes: [],
 
-  plugins: isSchemaPreview
-    ? []
-    : [
-        [
-          '@docusaurus/plugin-client-redirects',
-          {
-            redirects: [
-              {
-                from: '/releases',
-                to: '/release-calendar/',
-              },
-            ],
-          },
-        ],
-        [
-          '@docusaurus/plugin-content-pages',
-          {
-            id: 'community',
-            path: './community',
-            routeBasePath: 'community',
-            showLastUpdateTime: true,
-          },
-        ],
-        [
-          'docusaurus-plugin-llms',
-          {
-            generateLLMsTxt: true,
-            generateLLMsFullTxt: true,
-            excludeImports: true,
-            removeDuplicateHeadings: true,
-            includeBlog: true,
-            // Order docs from most introductory to most detailed
-            includeOrder: [
-              'getting-data/**',
-              'guides/**',
-              'schema/**',
-              'examples/**',
-              'gers/**',
-            ],
-            includeUnmatchedLast: true,
-            // Playground pages are interactive components, not useful for LLMs
-            ignoreFiles: ['playground/**'],
-            // Schema-only subset for LLMs focused on the data model
-            customLLMFiles: [
-              {
-                filename: 'llms-schema.txt',
-                includePatterns: ['schema/**'],
-                fullContent: true,
-                title: 'Overture Maps Schema Reference',
-                description:
-                  'Schema reference for all Overture Maps data types: addresses, base, buildings, divisions, places, and transportation.',
-              },
-            ],
-          },
-        ],
-      ],
+  plugins: [
+    [
+      '@docusaurus/plugin-content-docs',
+      /** @type {import('@docusaurus/plugin-content-docs').Options} */
+      ({
+        id: 'schema',
+        path: 'schema',
+        routeBasePath: 'schema',
+        sidebarPath: require.resolve('./sidebars-schema.js'),
+        showLastUpdateTime: true,
+        breadcrumbs: false,
+        lastVersion: 'current',
+        versions: schemaVersionConfig,
+      }),
+    ],
+    ...(isSchemaPreview
+      ? []
+      : [
+          [
+            '@docusaurus/plugin-client-redirects',
+            {
+              redirects: [
+                {
+                  from: '/releases',
+                  to: '/release-calendar/',
+                },
+              ],
+            },
+          ],
+          [
+            '@docusaurus/plugin-content-pages',
+            {
+              id: 'community',
+              path: './community',
+              routeBasePath: 'community',
+              showLastUpdateTime: true,
+            },
+          ],
+          [
+            'docusaurus-plugin-llms',
+            {
+              generateLLMsTxt: true,
+              generateLLMsFullTxt: true,
+              // Latest schema reference only; versioned snapshots are excluded
+              docsDir: [
+                { path: 'docs', routeBasePath: '/' },
+                { path: 'schema', routeBasePath: 'schema' },
+              ],
+              excludeImports: true,
+              removeDuplicateHeadings: true,
+              includeBlog: true,
+              // Order docs from most introductory to most detailed
+              includeOrder: [
+                'getting-data/**',
+                'guides/**',
+                'schema/**',
+                'examples/**',
+                'gers/**',
+              ],
+              includeUnmatchedLast: true,
+              // Playground pages are interactive components, not useful for LLMs
+              ignoreFiles: ['playground/**'],
+              // Schema-only subset for LLMs focused on the data model
+              customLLMFiles: [
+                {
+                  filename: 'llms-schema.txt',
+                  includePatterns: ['schema/**'],
+                  fullContent: true,
+                  title: 'Overture Maps Schema Reference',
+                  description:
+                    'Schema reference for all Overture Maps data types: addresses, base, buildings, divisions, places, and transportation.',
+                },
+              ],
+            },
+          ],
+        ]),
+  ],
 
   presets: [
     [
@@ -221,6 +254,13 @@ const config = {
                 },
               ]
             : []),
+          {
+            type: 'docsVersionDropdown',
+            docsPluginId: 'schema',
+            position: 'right',
+            // Only shown on schema pages; see custom.css
+            className: 'schema-version-dropdown',
+          },
           {
             to: 'https://github.com/OvertureMaps/docs',
             position: 'right',
diff --git a/package.json b/package.json
index 64d2e30ba..18f7ea47a 100644
--- a/package.json
+++ b/package.json
@@ -4,6 +4,7 @@
   "private": true,
   "scripts": {
     "fetch-og": "node scripts/fetch-og-images.mjs",
+    "add-schema-version": "node scripts/add-schema-version.mjs",
     "copy-maplibre-worker": "node scripts/copy-maplibre-worker.mjs",
     "docusaurus": "docusaurus",
     "start": "npm run copy-maplibre-worker && npm run docusaurus start",
@@ -16,8 +17,8 @@
     "write-heading-ids": "docusaurus write-heading-ids",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
-    "lint:md": "markdownlint 'docs/**/*.md' 'docs/**/*.mdx' 'blog/**/*.md' 'blog/**/*.mdx' --ignore node_modules",
-    "lint:md:fix": "markdownlint 'docs/**/*.md' 'docs/**/*.mdx' 'blog/**/*.md' 'blog/**/*.mdx' --ignore node_modules --fix",
+    "lint:md": "markdownlint 'docs/**/*.md' 'docs/**/*.mdx' 'schema/*.md' 'blog/**/*.md' 'blog/**/*.mdx' --ignore node_modules",
+    "lint:md:fix": "markdownlint 'docs/**/*.md' 'docs/**/*.mdx' 'schema/*.md' 'blog/**/*.md' 'blog/**/*.mdx' --ignore node_modules --fix",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "test": "vitest run",
diff --git a/docs/schema/index.md b/schema/index.md
similarity index 99%
rename from docs/schema/index.md
rename to schema/index.md
index bc5a62639..234c9dc12 100644
--- a/docs/schema/index.md
+++ b/schema/index.md
@@ -1,6 +1,6 @@
 ---
 id: index
-slug: /schema/
+slug: /
 title: Schema Reference
 sidebar_label: Overview
 description: Pydantic schemas for Overture Maps data
diff --git a/schema_versioned_docs/version-v1.17.0/index.md b/schema_versioned_docs/version-v1.17.0/index.md
new file mode 100644
index 000000000..234c9dc12
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/index.md
@@ -0,0 +1,58 @@
+---
+id: index
+slug: /
+title: Schema Reference
+sidebar_label: Overview
+description: Pydantic schemas for Overture Maps data
+pagination_label: Schema Reference Overview
+---
+
+# Overture Maps Schema
+
+:::note
+This section has been recently updated to reflect changes in our schema modeling. We welcome your feedback in [GitHub Discussions](https://github.com/OvertureMaps/data/discussions).
+:::
+
+The Overture Maps schema defines the structure, properties, and constraints for all features across six themes: addresses, base, buildings, divisions, places, and transportation. The reference pages in this section document the theme-based and shared modules in the schema.
+
+The schema is authored as [Pydantic](https://docs.pydantic.dev/) models and the reference documentation is generated from those models. The source code lives in the [OvertureMaps/schema](https://github.com/OvertureMaps/schema) repository on GitHub.
+
+:::tip[Found an error on this page?]
+This page is generated from the Pydantic models in [OvertureMaps/schema](https://github.com/OvertureMaps/schema/issues). Please file an issue there for changes.
+:::
+
+## Why Use Pydantic to Define Data Schemas?
+
+This project addresses a fundamental challenge in data consumption: bridging the semantic gap between raw data and human understanding while enabling machine-actionable workflows.
+
+## Why Schema at All: Beyond Raw Data
+
+Take a column like `pop_2020`. Is it total population? Population density per square kilometer? Working-age population? Without a schema, you're left sampling values and guessing from column names.
+
+Compare this to OpenStreetMap's approach: features use well-known key-value pairs like `building=residential` or `addr:housenumber=42` that have semantic meaning and can be looked up on the OSM wiki. This creates a step toward a schema — shared vocabulary with documented semantics used across a vast dataset. However, OSM tags remain free-form: multiple valid ways to express the same concept, no built-in validation, and complex downstream validation because of undocumented keys that might have meaning to someone, somewhere. A schema provides the structured alternative: explicit types, clear validation rules, and semantic meaning that both humans and systems can rely on.
+
+Data files containing only column names and values aren't fully documented. External metadata files typically focus on how data was collected and encoded, not on semantic meaning or validation rules. Data consumers struggle to understand what datasets contain and which columns they need for their goals.
+
+## Why Pydantic Over JSON Schema: Solving Multiple Problems
+
+We initially chose JSON Schema because it aligned with our mental model and promised to solve our problems as we understood them. But JSON Schema surfaced several pain points:
+
+- **Authoring difficulty:** Hard to write correctly, difficult to verify, limited IDE support, no refactoring capabilities
+- **Tooling gaps:** Generic tools can't tailor output for specific applications like ours
+- **Development friction:** Schema changes required manual coordination across multiple artifacts
+
+Pydantic addresses these systematically: author in Python with full IDE support, generate tailored documentation, and automatically produce the specific artifacts each workflow needs. Pydantic can also produce JSON Schema, so any application that requires it can use it while we gain all the Python benefits during authoring.
+
+## The Result: Faster Understanding, Higher Quality
+
+Instead of spending time deciphering what columns mean and whether data matches expectations, users can focus on their actual goals: analysis, visualization, integration. Quality improves because validation happens automatically rather than through manual inspection.
+
+The fundamental approach — human-readable authoring that generates machine-actionable outputs — has broader applications beyond Overture and geospatial data. We hope others will adapt these patterns for linking with Overture data or modeling their own domains entirely.
+
+## Schema Modules
+
+Browse the schema reference in the sidebar. Modules are organized by theme and shared components:
+
+**Themes:** Addresses, Base, Buildings, Divisions, Places, Transportation
+
+**Shared:** Core (names, sources, cartographic hints), System (country codes, language tags, geometry primitives)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/addresses/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/addresses/_category_.json
new file mode 100644
index 000000000..29c13add5
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/addresses/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Addresses",
+  "position": 1
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/addresses/address.md b/schema_versioned_docs/version-v1.17.0/reference/addresses/address.md
new file mode 100644
index 000000000..820a0d9aa
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/addresses/address.md
@@ -0,0 +1,76 @@
+---
+sidebar_position: 1
+---
+
+# Address
+
+Addresses are structured labels for the geographic locations where businesses and individuals
+reside.
+
+While address formats around the world have some general points in common, the specifics vary
+extensively from place to place. The rules for dividing an address up into parts or fields vary,
+as do the names of those parts or fields.
+
+The address schema uses a simplified approach to capture the common structure of addresses
+worldwide while accommodating local variance. The schema is heavily based on the OpenAddresses
+([www.openaddresses.io](https://www.openaddresses.io)) project.
+
+For sub-country administrative levels (and non-administrative levels such as neighborhoods), the
+schema provides the `address_levels` field. This is where the names of cities and towns,
+provinces, state, and regions, and similar addressing units are found.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Position of the address. Addresses are point geometries.<br/><br/>*Allowed geometry types: Point* |
+| `theme` | `"addresses"` | |
+| `type` | `"address"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `address_levels[]` | `list<`[`AddressLevel`](types/address_level.md)`>` (optional) | Names of the sub-country addressing areas the address belongs to, including the city or locality, in descending order of generality.<br/><br/>The list is sorted so that the highest, or most general, level comes first (*e.g.*, region) and the lowest, or most particular level, comes last (*e.g.*, city or town).<br/><br/>The number of items in this list and their meaning is country-dependent. For example, in the United States, we expect two items: the state, and the locality or municipality within the state. Other countries might have as few as one, or even three or more.<br/><br/>When a specific level that is required for a country is not known. most likely because the data provider has not supplied it and we have not derived it from another source, the list item corresponding to that level must be present, but its `value` field should be omitted.<br/><br/>*Minimum length: 1*<br/>*Maximum length: 5* |
+| `address_levels[].value` | [`StrippedString`](../system/stripped_string.md) (optional) | A string without leading or trailing whitespace |
+| `country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) | The country the address belongs to, as an ISO 3166-1 alpha-2 country code. |
+| `number` | [`StrippedString`](../system/stripped_string.md) (optional) | The house number.<br/><br/>This field does not necessarily contain an integer or even a number. Values such as "74B", "189 1/2", and "208.5", where the non-integer or non-number part is part of the house number, not a unit number, are in common use.<br/><br/>*Minimum length: 1* |
+| `postal_city` | [`StrippedString`](../system/stripped_string.md) (optional) | The postal authority designated city name, if applicable.<br/><br/>In some countries or regions, a mailing address may need to specify a different city name than the city that actually contains the address coordinates. This optional field can be used to specify the alternate city name to use.<br/><br/>For example:<br/><br/>- The postal city for the US address *716 East County Road, Winchester, Indiana*   is Ridgeville. - The postal city for the Slovenian address *Tomaj 71, 6221 Tomaj, Slovenia* is   Dutovlje.<br/><br/>*Minimum length: 1* |
+| `postcode` | [`StrippedString`](../system/stripped_string.md) (optional) | The postal code.<br/><br/>*Minimum length: 1* |
+| `street` | [`StrippedString`](../system/stripped_string.md) (optional) | The street name.<br/><br/>The street name can include a type (*e.g.*, "Street" or "St", "Boulevard" or "Blvd", *etc.*) and a directional (*e.g.*, "NW" or "Northwest", "S" or "Sud"). Both type and directional, if present, may be either a prefix or a suffix to the primary name. They may either be fully spelled-out or abbreviated.<br/><br/>*Minimum length: 1* |
+| `unit` | [`StrippedString`](../system/stripped_string.md) (optional) | The secondary address unit designator.<br/><br/>In the case where the primary street address is divided into secondary units, which may be apartments, floors, or even buildings if the primary street address is a campus, this field names the specific secondary unit being addressed.<br/><br/>*Minimum length: 1* |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `416ab01c-d836-4c4f-aedc-2f30941ce94d` |
+| `bbox.xmin` | `-176.56381225585938` |
+| `bbox.ymin` | `-43.94719696044922` |
+| `bbox.xmax` | `-176.56378173828125` |
+| `bbox.ymax` | `-43.94718933105469` |
+| `geometry` | `POINT (-176.5637854 -43.9471955)` |
+| `theme` | `addresses` |
+| `type` | `address` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenAddresses/LINZ` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `null` |
+| `sources[0].update_time` | `null` |
+| `sources[0].confidence` | `null` |
+| `sources[0].between` | `null` |
+| `address_levels[0].value` | `Chatham Islands` |
+| `address_levels[1].value` | `Chatham Island` |
+| `country` | `NZ` |
+| `number` | `54` |
+| `postal_city` | `null` |
+| `postcode` | `null` |
+| `street` | `Tikitiki Hill Road` |
+| `unit` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/addresses/types/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/addresses/types/_category_.json
new file mode 100644
index 000000000..a3ec08974
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/addresses/types/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Types"
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/addresses/types/address_level.md b/schema_versioned_docs/version-v1.17.0/reference/addresses/types/address_level.md
new file mode 100644
index 000000000..b0762021c
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/addresses/types/address_level.md
@@ -0,0 +1,26 @@
+# AddressLevel
+
+A sub-country addressing unit, such as a region, city, or neighborhood, that is less specific
+than a street name and not a postal code.
+
+In the following address, the terms `Montréal` and `QC` are address levels:
+
+```
+3998 Rue De Bullion, Montréal, QC H2W 2E4
+```
+
+The number of address levels per address is country-dependent.
+
+Other addressing systems may use the terms "administrative level" or "admin level"  for the
+same concept. We have chosen the term "address level" to communicate the fact that in some
+countries and regions, address levels do not necessarily correspond to administrative units.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`StrippedString`](../../system/stripped_string.md) (optional) | A string without leading or trailing whitespace<br/><br/>*Minimum length: 1* |
+
+## Used By
+
+- [`Address`](../address.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/base/_category_.json
new file mode 100644
index 000000000..b6b444780
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Base",
+  "position": 2
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/bathymetry.md b/schema_versioned_docs/version-v1.17.0/reference/base/bathymetry.md
new file mode 100644
index 000000000..19039a8eb
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/bathymetry.md
@@ -0,0 +1,59 @@
+---
+sidebar_position: 1
+---
+
+# Bathymetry
+
+Bathymetry features provide topographic representations of underwater areas, such as parts of
+lake beds or ocean floors.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Shape of the underwater area, which may be a polygon or multi-polygon.<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
+| `theme` | `"base"` | |
+| `type` | `"bathymetry"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `depth` | [`Depth`](types/depth.md) | Depth below surface level of the feature in meters. |
+| `cartography` | [`CartographicHints`](../common/cartographic_hints.md) (optional) | Cartographic hints useful when including the feature in maps |
+| `cartography.prominence` | [`Prominence`](../common/prominence.md) (optional) | Subjective scale of feature significance or importance, with 1 being the least, and 100 being the most, significant.<br/><br/>This value can be used to help drive decisions about how and when to display a feature, and how to treat it relative to neighboring features.<br/><br/>When populated by Overture, this value is derived from various factors including, but not limited to: feature and subtype, population, and capital status. |
+| `cartography.min_zoom` | [`MinZoom`](../common/min_zoom.md) (optional) | Recommended minimum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels below this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `cartography.max_zoom` | [`MaxZoom`](../common/max_zoom.md) (optional) | Recommended maximum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels above this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `cartography.sort_key` | [`SortKey`](../common/sort_key.md) (optional) | Integer indicating the recommended order in which to draw features.<br/><br/>Features with a lower number should be drawn "in front" of features with a higher number. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `5d40bd6c-db14-5492-b29f-5e25a59032bc` |
+| `bbox.xmin` | `-175.12791442871094` |
+| `bbox.ymin` | `-77.9718246459961` |
+| `bbox.xmax` | `-170.05111694335938` |
+| `bbox.ymax` | `-75.64299774169922` |
+| `geometry` | `MULTIPOLYGON (((-170.71296928 -76.744313428, -170.719841483 -76.757076376, -170.731061124 -76.761...` |
+| `theme` | `base` |
+| `type` | `bathymetry` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `ETOPO/GLOBathy` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `2024-12-09T00:00:00.000Z` |
+| `sources[0].update_time` | `null` |
+| `sources[0].confidence` | `null` |
+| `sources[0].between` | `null` |
+| `depth` | `500` |
+| `cartography.prominence` | `null` |
+| `cartography.min_zoom` | `null` |
+| `cartography.max_zoom` | `null` |
+| `cartography.sort_key` | `12` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/infrastructure.md b/schema_versioned_docs/version-v1.17.0/reference/base/infrastructure.md
new file mode 100644
index 000000000..7e97a4f38
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/infrastructure.md
@@ -0,0 +1,77 @@
+---
+sidebar_position: 1
+---
+
+# Infrastructure
+
+Infrastructure features provide basic information about real-world infrastructure entitites
+such as bridges, airports, runways, aerialways, communication towers, and power lines.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Geometry of the infrastructure feature, which may be a point, line string, polygon, or multi-polygon.<br/><br/>*Allowed geometry types: LineString, MultiPolygon, Point, Polygon* |
+| `theme` | `"base"` | |
+| `type` | `"infrastructure"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `class` | [`InfrastructureClass`](types/infrastructure_class.md) | |
+| `subtype` | [`InfrastructureSubtype`](types/infrastructure_subtype.md) | |
+| `height` | [`Height`](types/height.md) (optional) | Height of the feature in meters. |
+| `surface` | [`SurfaceMaterial`](types/surface_material.md) (optional) | |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level |
+| `source_tags` | [`SourceTags`](types/source_tags.md) (map, optional) | Key/value pairs imported directly from the source data without change.<br/><br/>This field provides access to raw OSM entity tags for features sourced from OpenStreetMap. |
+| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `e9e3d506-89c0-3473-8cee-5e5ac6596d6c` |
+| `bbox.xmin` | `-180.0` |
+| `bbox.ymin` | `-82.42408752441406` |
+| `bbox.xmax` | `-179.99998474121094` |
+| `bbox.ymax` | `-82.42407989501953` |
+| `geometry` | `POINT (-179.9999994 -82.42408)` |
+| `theme` | `base` |
+| `type` | `infrastructure` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `n7674174803@2` |
+| `sources[0].update_time` | `2023-04-07T17:37:48+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].between` | `null` |
+| `class` | `information` |
+| `subtype` | `pedestrian` |
+| `height` | `null` |
+| `surface` | `null` |
+| `names.primary` | `1306 km to South Pole` |
+| `names.common` | `null` |
+| `names.rules` | `null` |
+| `level` | `0` |
+| `source_tags` | `{"description": "1036 km to South Pole.", "information": "route_marker", "note": "The road contin...` |
+| `wikidata` | `Q800558` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/land.md b/schema_versioned_docs/version-v1.17.0/reference/base/land.md
new file mode 100644
index 000000000..82cc28a19
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/land.md
@@ -0,0 +1,87 @@
+---
+sidebar_position: 1
+---
+
+# Land
+
+Land features are representations of physical land surfaces.
+
+In Overture data releases, land features are sourced from OpenStreetMap. TODO. Finish this when
+I get more info from Jennings.
+
+
+
+Physical representations of land surfaces.
+
+Global land derived from the inverse of OSM Coastlines. Translates `natural` tags from OpenStreetMap.
+
+TODO: Update this description when the relationship to `land_cover` is better understood.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Geometry of the land feature, which may be a point, line string, polygon, or multi-polygon.<br/><br/>*Allowed geometry types: LineString, MultiPolygon, Point, Polygon* |
+| `theme` | `"base"` | |
+| `type` | `"land"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `class` | [`LandClass`](types/land_class.md) (optional) | |
+| `subtype` | [`LandSubtype`](types/land_subtype.md) (optional) | |
+| `elevation` | [`Elevation`](types/elevation.md) (optional) | Elevation above sea level of the feature in meters. |
+| `surface` | [`SurfaceMaterial`](types/surface_material.md) (optional) | |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level |
+| `source_tags` | [`SourceTags`](types/source_tags.md) (map, optional) | Key/value pairs imported directly from the source data without change.<br/><br/>This field provides access to raw OSM entity tags for features sourced from OpenStreetMap. |
+| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `70fc3596-a987-3fea-820c-c016c0a2f0da` |
+| `bbox.xmin` | `-178.7000274658203` |
+| `bbox.ymin` | `-85.45001220703125` |
+| `bbox.xmax` | `-178.6999969482422` |
+| `bbox.ymax` | `-85.44999694824219` |
+| `geometry` | `POINT (-178.7 -85.45)` |
+| `theme` | `base` |
+| `type` | `land` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `n11693475112@1` |
+| `sources[0].update_time` | `2024-03-05T09:23:39+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].between` | `null` |
+| `class` | `cliff` |
+| `subtype` | `physical` |
+| `elevation` | `null` |
+| `surface` | `null` |
+| `names.primary` | `Dismal Buttress` |
+| `names.common` | `null` |
+| `names.rules` | `null` |
+| `level` | `0` |
+| `source_tags` | `{"natural": "cliff", "ref:linz:place_id": "12318", "wikipedia": "en:Dismal Buttress"}` |
+| `wikidata` | `Q5282342` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/land_cover.md b/schema_versioned_docs/version-v1.17.0/reference/base/land_cover.md
new file mode 100644
index 000000000..3452c29cc
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/land_cover.md
@@ -0,0 +1,66 @@
+---
+sidebar_position: 1
+---
+
+# LandCover
+
+Land cover features indicate the primary natural or artificial surface material covering a land
+area on the earth, including vegetation types like forests and crops, built environments like
+cities, and natural surfaces like wetlands or barren ground.
+
+Land cover features relate to `LandUse` features in the following way: land cover is the
+physical thing covering the land, while land use is the human use to which the land is being
+put.
+
+TODO: Explain relationship to `Land` features.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Shape of the covered land area, which may be a polygon or multi-polygon.<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
+| `theme` | `"base"` | |
+| `type` | `"land_cover"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `subtype` | [`LandCoverSubtype`](types/land_cover_subtype.md) | |
+| `cartography` | [`CartographicHints`](../common/cartographic_hints.md) (optional) | Cartographic hints useful when including the feature in maps |
+| `cartography.prominence` | [`Prominence`](../common/prominence.md) (optional) | Subjective scale of feature significance or importance, with 1 being the least, and 100 being the most, significant.<br/><br/>This value can be used to help drive decisions about how and when to display a feature, and how to treat it relative to neighboring features.<br/><br/>When populated by Overture, this value is derived from various factors including, but not limited to: feature and subtype, population, and capital status. |
+| `cartography.min_zoom` | [`MinZoom`](../common/min_zoom.md) (optional) | Recommended minimum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels below this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `cartography.max_zoom` | [`MaxZoom`](../common/max_zoom.md) (optional) | Recommended maximum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels above this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `cartography.sort_key` | [`SortKey`](../common/sort_key.md) (optional) | Integer indicating the recommended order in which to draw features.<br/><br/>Features with a lower number should be drawn "in front" of features with a higher number. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `c347312d-012b-5e73-8bd3-a10d04b2981d` |
+| `bbox.xmin` | `-180.0001983642578` |
+| `bbox.ymin` | `65.95172119140625` |
+| `bbox.xmax` | `-179.99313354492188` |
+| `bbox.ymax` | `65.96218872070312` |
+| `geometry` | `POLYGON ((-179.99877531181616 65.95172539425603, -179.99740705536922 65.95265577758867, -179.9975...` |
+| `theme` | `base` |
+| `type` | `land_cover` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `ESA WorldCover` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `null` |
+| `sources[0].update_time` | `2024-11-07T00:00:00+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].between` | `null` |
+| `subtype` | `barren` |
+| `cartography.prominence` | `null` |
+| `cartography.min_zoom` | `8` |
+| `cartography.max_zoom` | `15` |
+| `cartography.sort_key` | `3` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/land_use.md b/schema_versioned_docs/version-v1.17.0/reference/base/land_use.md
new file mode 100644
index 000000000..db5bccc6a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/land_use.md
@@ -0,0 +1,82 @@
+---
+sidebar_position: 1
+---
+
+# LandUse
+
+Land use features specify the predominant human use of an area of land, for example commercial
+activity, recreation, farming, housing, education, or military use.
+
+Land use features relate to `LandCover` features in the following way: land use is the human
+human activity being done with the land, while land cover is the physical thing that covers it.
+
+TODO: Explain relationship to `Land` features.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Geometry of the land use area, which may be a point, line string, polygon, or multi-polygon.<br/><br/>*Allowed geometry types: LineString, MultiPolygon, Point, Polygon* |
+| `theme` | `"base"` | |
+| `type` | `"land_use"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `class` | [`LandUseClass`](types/land_use_class.md) | |
+| `subtype` | [`LandUseSubtype`](types/land_use_subtype.md) | |
+| `elevation` | [`Elevation`](types/elevation.md) (optional) | Elevation above sea level of the feature in meters. |
+| `surface` | [`SurfaceMaterial`](types/surface_material.md) (optional) | |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level |
+| `source_tags` | [`SourceTags`](types/source_tags.md) (map, optional) | Key/value pairs imported directly from the source data without change.<br/><br/>This field provides access to raw OSM entity tags for features sourced from OpenStreetMap. |
+| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `1e1f6095-5bd2-3fdb-a422-41351b848e9d` |
+| `bbox.xmin` | `-176.56825256347656` |
+| `bbox.ymin` | `-43.96001052856445` |
+| `bbox.xmax` | `-176.56231689453125` |
+| `bbox.ymax` | `-43.95420837402344` |
+| `geometry` | `POLYGON ((-176.5623454 -43.9567812, -176.5627644 -43.9561272, -176.5626898 -43.9557432, -176.5624...` |
+| `theme` | `base` |
+| `type` | `land_use` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `w56117029@3` |
+| `sources[0].update_time` | `2010-04-24T22:35:13+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].between` | `null` |
+| `class` | `golf_course` |
+| `subtype` | `golf` |
+| `elevation` | `null` |
+| `surface` | `null` |
+| `names.primary` | `Chatham Islands Golf Club` |
+| `names.common` | `null` |
+| `names.rules` | `null` |
+| `level` | `0` |
+| `source_tags` | `{"LINZ:source_version": "V16", "attribution": "http://wiki.osm.org/wiki/Attribution#LINZ", "leisu...` |
+| `wikidata` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/base/types/_category_.json
new file mode 100644
index 000000000..a3ec08974
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/types/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Types"
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/depth.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/depth.md
new file mode 100644
index 000000000..f6b96f3ed
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/types/depth.md
@@ -0,0 +1,15 @@
+# Depth
+
+Depth below surface level of the feature in meters.
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 0`
+- `≥ -2147483648` (from [`int32`](../../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../../system/primitive/primitives.md))
+
+## Used By
+
+- [`Bathymetry`](../bathymetry.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/elevation.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/elevation.md
new file mode 100644
index 000000000..2bfb7d128
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/types/elevation.md
@@ -0,0 +1,16 @@
+# Elevation
+
+Elevation above sea level of the feature in meters.
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≤ 9000`
+- `≥ -2147483648` (from [`int32`](../../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../../system/primitive/primitives.md))
+
+## Used By
+
+- [`Land`](../land.md)
+- [`LandUse`](../land_use.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/height.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/height.md
new file mode 100644
index 000000000..6a4b542fb
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/types/height.md
@@ -0,0 +1,13 @@
+# Height
+
+Height of the feature in meters.
+
+Underlying type: `float64`
+
+## Constraints
+
+- `> 0`
+
+## Used By
+
+- [`Infrastructure`](../infrastructure.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/infrastructure_class.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/infrastructure_class.md
new file mode 100644
index 000000000..b8cc4043a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/types/infrastructure_class.md
@@ -0,0 +1,176 @@
+# InfrastructureClass
+
+Further classification of the type of infrastructure.
+
+The infrastructure class adds detail to the broad classification of `InfrastructureSubtype`.
+
+## Values
+
+- `aerialway_station`
+- `airport`
+- `airport_gate`
+- `airstrip`
+- `apron`
+- `aqueduct`
+- `artwork`
+- `atm`
+- `barrier`
+- `bell_tower`
+- `bench`
+- `bicycle_parking`
+- `bicycle_rental`
+- `block`
+- `boardwalk`
+- `bollard`
+- `border_control`
+- `breakwater`
+- `bridge`
+- `bridge_support`
+- `bump_gate`
+- `bus_route`
+- `bus_station`
+- `bus_stop`
+- `bus_trap`
+- `cable`
+- `cable_barrier`
+- `cable_car`
+- `cable_distribution`
+- `camp_site`
+- `cantilever`
+- `catenary_mast`
+- `cattle_grid`
+- `chain`
+- `chair_lift`
+- `charging_station`
+- `city_wall`
+- `communication_line`
+- `communication_pole`
+- `communication_tower`
+- `connection`
+- `cooling`
+- `covered`
+- `crossing`
+- `cutline`
+- `cycle_barrier`
+- `dam`
+- `defensive`
+- `ditch`
+- `diving`
+- `drag_lift`
+- `drain`
+- `drinking_water`
+- `entrance`
+- `fence`
+- `ferry_terminal`
+- `fire_hydrant`
+- `fountain`
+- `full-height_turnstile`
+- `gasometer`
+- `gate`
+- `generator`
+- `give_way`
+- `gondola`
+- `goods`
+- `guard_rail`
+- `hampshire_gate`
+- `handrail`
+- `hedge`
+- `height_restrictor`
+- `heliostat`
+- `helipad`
+- `heliport`
+- `hose`
+- `information`
+- `insulator`
+- `international_airport`
+- `j-bar`
+- `jersey_barrier`
+- `kerb`
+- `kissing_gate`
+- `launchpad`
+- `lift_gate`
+- `lighting`
+- `lightning_protection`
+- `magic_carpet`
+- `manhole`
+- `milestone`
+- `military_airport`
+- `minaret`
+- `minor_line`
+- `mixed_lift`
+- `mobile_phone_tower`
+- `monitoring`
+- `motorcycle_parking`
+- `motorway_junction`
+- `movable`
+- `municipal_airport`
+- `observation`
+- `parking`
+- `parking_entrance`
+- `parking_space`
+- `pedestrian_crossing`
+- `picnic_table`
+- `pier`
+- `pipeline`
+- `plant`
+- `planter`
+- `platform`
+- `platter`
+- `portal`
+- `post_box`
+- `power_line`
+- `power_pole`
+- `power_tower`
+- `private_airport`
+- `pylon`
+- `quay`
+- `radar`
+- `railway_halt`
+- `railway_station`
+- `recycling`
+- `regional_airport`
+- `reservoir_covered`
+- `retaining_wall`
+- `roller_coaster`
+- `rope_tow`
+- `runway`
+- `sally_port`
+- `seaplane_airport`
+- `sewer`
+- `silo`
+- `siren`
+- `stile`
+- `stop`
+- `stop_position`
+- `stopway`
+- `storage_tank`
+- `street_cabinet`
+- `street_lamp`
+- `substation`
+- `subway_station`
+- `swing_gate`
+- `switch`
+- `t-bar`
+- `taxilane`
+- `taxiway`
+- `terminal`
+- `toilets`
+- `toll_booth`
+- `traffic_signals`
+- `transformer`
+- `trestle`
+- `utility_pole`
+- `vending_machine`
+- `viaduct`
+- `viewpoint`
+- `wall`
+- `waste_basket`
+- `waste_disposal`
+- `watchtower`
+- `water_tower`
+- `weir`
+- `zip_line`
+
+## Used By
+
+- [`Infrastructure`](../infrastructure.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/infrastructure_subtype.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/infrastructure_subtype.md
new file mode 100644
index 000000000..c7432d702
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/types/infrastructure_subtype.md
@@ -0,0 +1,30 @@
+# InfrastructureSubtype
+
+Broadest classification of the type of infrastructure.
+
+This broad classification can be refined by `InfrastructureClass`.
+
+## Values
+
+- `aerialway`
+- `airport`
+- `barrier`
+- `bridge`
+- `communication`
+- `emergency`
+- `manhole`
+- `pedestrian`
+- `pier`
+- `power`
+- `quay`
+- `recreation`
+- `tower`
+- `transit`
+- `transportation`
+- `utility`
+- `waste_management`
+- `water`
+
+## Used By
+
+- [`Infrastructure`](../infrastructure.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/land_class.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/land_class.md
new file mode 100644
index 000000000..8c63ddaf1
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/types/land_class.md
@@ -0,0 +1,54 @@
+# LandClass
+
+Further classification of the land.
+
+The land class adds detail to the broad classification of `LandSubtype`.
+
+## Values
+
+- `archipelago`
+- `bare_rock`
+- `beach`
+- `cave_entrance`
+- `cliff`
+- `desert`
+- `dune`
+- `fell`
+- `forest`
+- `glacier`
+- `grass`
+- `grassland`
+- `heath`
+- `hill`
+- `island`
+- `islet`
+- `land`
+- `meadow`
+- `meteor_crater`
+- `mountain_range`
+- `peak`
+- `peninsula`
+- `plateau`
+- `reef`
+- `ridge`
+- `rock`
+- `saddle`
+- `sand`
+- `scree`
+- `scrub`
+- `shingle`
+- `shrub`
+- `shrubbery`
+- `stone`
+- `tree`
+- `tree_row`
+- `tundra`
+- `valley`
+- `volcanic_caldera_rim`
+- `volcano`
+- `wetland`
+- `wood`
+
+## Used By
+
+- [`Land`](../land.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/land_cover_subtype.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/land_cover_subtype.md
new file mode 100644
index 000000000..8a9676ae8
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/types/land_cover_subtype.md
@@ -0,0 +1,20 @@
+# LandCoverSubtype
+
+Primary or dominant material covering the land.
+
+## Values
+
+- `barren`
+- `crop`
+- `forest`
+- `grass`
+- `mangrove`
+- `moss`
+- `shrub`
+- `snow`
+- `urban`
+- `wetland`
+
+## Used By
+
+- [`LandCover`](../land_cover.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/land_subtype.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/land_subtype.md
new file mode 100644
index 000000000..9e92c91af
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/types/land_subtype.md
@@ -0,0 +1,25 @@
+# LandSubtype
+
+Broadest classification of the land.
+
+This broad classification can be refined by `LandClass`.
+
+## Values
+
+- `crater`
+- `desert`
+- `forest`
+- `glacier`
+- `grass`
+- `land`
+- `physical`
+- `reef`
+- `rock`
+- `sand`
+- `shrub`
+- `tree`
+- `wetland`
+
+## Used By
+
+- [`Land`](../land.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/land_use_class.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/land_use_class.md
new file mode 100644
index 000000000..5c9531d89
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/types/land_use_class.md
@@ -0,0 +1,121 @@
+# LandUseClass
+
+Further classification of the land use.
+
+The land use class adds detail to the broad classification of `LandUseSubtype`.
+
+## Values
+
+- `aboriginal_land`
+- `airfield`
+- `allotments`
+- `animal_keeping`
+- `aquaculture`
+- `barracks`
+- `base`
+- `beach_resort`
+- `brownfield`
+- `bunker`
+- `camp_site`
+- `cemetery`
+- `clinic`
+- `college`
+- `commercial`
+- `connection`
+- `construction`
+- `danger_area`
+- `doctors`
+- `dog_park`
+- `downhill`
+- `driving_range`
+- `driving_school`
+- `education`
+- `environmental`
+- `fairway`
+- `farmland`
+- `farmyard`
+- `fatbike`
+- `flowerbed`
+- `forest`
+- `garages`
+- `garden`
+- `golf_course`
+- `grass`
+- `grave_yard`
+- `green`
+- `greenfield`
+- `greenhouse_horticulture`
+- `highway`
+- `hike`
+- `hospital`
+- `ice_skate`
+- `industrial`
+- `institutional`
+- `kindergarten`
+- `landfill`
+- `lateral_water_hazard`
+- `logging`
+- `marina`
+- `meadow`
+- `military`
+- `military_hospital`
+- `military_school`
+- `music_school`
+- `national_park`
+- `natural_monument`
+- `nature_reserve`
+- `naval_base`
+- `nordic`
+- `nuclear_explosion_site`
+- `obstacle_course`
+- `orchard`
+- `park`
+- `peat_cutting`
+- `pedestrian`
+- `pitch`
+- `plant_nursery`
+- `playground`
+- `plaza`
+- `protected`
+- `protected_landscape_seascape`
+- `quarry`
+- `railway`
+- `range`
+- `recreation_ground`
+- `religious`
+- `residential`
+- `resort`
+- `retail`
+- `rough`
+- `salt_pond`
+- `school`
+- `schoolyard`
+- `ski_jump`
+- `skitour`
+- `sled`
+- `sleigh`
+- `snow_park`
+- `species_management_area`
+- `stadium`
+- `state_park`
+- `static_caravan`
+- `strict_nature_reserve`
+- `tee`
+- `theme_park`
+- `track`
+- `traffic_island`
+- `training_area`
+- `trench`
+- `university`
+- `village_green`
+- `vineyard`
+- `water_hazard`
+- `water_park`
+- `wilderness_area`
+- `winter_sports`
+- `works`
+- `zoo`
+
+## Used By
+
+- [`LandUse`](../land_use.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/land_use_subtype.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/land_use_subtype.md
new file mode 100644
index 000000000..3acc75d21
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/types/land_use_subtype.md
@@ -0,0 +1,36 @@
+# LandUseSubtype
+
+Broadest classification of the land use.
+
+This broad classification can be refined by `LandUseClass`.
+
+## Values
+
+- `agriculture`
+- `aquaculture`
+- `campground`
+- `cemetery`
+- `construction`
+- `developed`
+- `education`
+- `entertainment`
+- `golf`
+- `grass`
+- `horticulture`
+- `landfill`
+- `managed`
+- `medical`
+- `military`
+- `park`
+- `pedestrian`
+- `protected`
+- `recreation`
+- `religious`
+- `residential`
+- `resource_extraction`
+- `transportation`
+- `winter_sports`
+
+## Used By
+
+- [`LandUse`](../land_use.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/source_tags.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/source_tags.md
new file mode 100644
index 000000000..41f50ae8f
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/types/source_tags.md
@@ -0,0 +1,15 @@
+# SourceTags
+
+Key/value pairs imported directly from the source data without change.
+
+This field provides access to raw OSM entity tags for features sourced from
+OpenStreetMap.
+
+Underlying type: `map<string, Any>`
+
+## Used By
+
+- [`Infrastructure`](../infrastructure.md)
+- [`Land`](../land.md)
+- [`LandUse`](../land_use.md)
+- [`Water`](../water.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/surface_material.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/surface_material.md
new file mode 100644
index 000000000..707f5a6a2
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/types/surface_material.md
@@ -0,0 +1,36 @@
+# SurfaceMaterial
+
+Material that makes up the surface of `Infrastructure` and `Land` features.
+
+## Values
+
+- `asphalt`
+- `cobblestone`
+- `compacted`
+- `concrete`
+- `concrete_plates`
+- `dirt`
+- `earth`
+- `fine_gravel`
+- `grass`
+- `gravel`
+- `ground`
+- `paved`
+- `paving_stones`
+- `pebblestone`
+- `recreation_grass`
+- `recreation_paved`
+- `recreation_sand`
+- `rubber`
+- `sand`
+- `sett`
+- `tartan`
+- `unpaved`
+- `wood`
+- `woodchips`
+
+## Used By
+
+- [`Infrastructure`](../infrastructure.md)
+- [`Land`](../land.md)
+- [`LandUse`](../land_use.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/water_class.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/water_class.md
new file mode 100644
index 000000000..def472f93
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/types/water_class.md
@@ -0,0 +1,47 @@
+# WaterClass
+
+Further description of the type of water body.
+
+The water class adds detail to the broad classification of `WaterSubtype`.
+
+## Values
+
+- `basin`
+- `bay`
+- `blowhole`
+- `canal`
+- `cape`
+- `ditch`
+- `dock`
+- `drain`
+- `fairway`
+- `fish_pass`
+- `fishpond`
+- `geyser`
+- `hot_spring`
+- `lagoon`
+- `lake`
+- `moat`
+- `ocean`
+- `oxbow`
+- `pond`
+- `reflecting_pool`
+- `reservoir`
+- `river`
+- `salt_pond`
+- `sea`
+- `sewage`
+- `shoal`
+- `spring`
+- `strait`
+- `stream`
+- `swimming_pool`
+- `tidal_channel`
+- `wastewater`
+- `water`
+- `water_storage`
+- `waterfall`
+
+## Used By
+
+- [`Water`](../water.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/water_subtype.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/water_subtype.md
new file mode 100644
index 000000000..987dc1af3
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/types/water_subtype.md
@@ -0,0 +1,24 @@
+# WaterSubtype
+
+The broad classification of water body such as river, ocean or lake.
+
+This broad classification can be refined using `WaterClass`.
+
+## Values
+
+- `canal`
+- `human_made`
+- `lake`
+- `ocean`
+- `physical`
+- `pond`
+- `reservoir`
+- `river`
+- `spring`
+- `stream`
+- `wastewater`
+- `water`
+
+## Used By
+
+- [`Water`](../water.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/water.md b/schema_versioned_docs/version-v1.17.0/reference/base/water.md
new file mode 100644
index 000000000..7d02c6007
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/base/water.md
@@ -0,0 +1,98 @@
+---
+sidebar_position: 1
+---
+
+# Water
+
+Water features represent ocean and inland water bodies.
+
+In Overture data releases, water features are sourced from OpenStreetMap. There are two main
+categories of water feature: ocean and inland water bodies.
+
+Ocean
+-----
+The `subytpe` value `"ocean"` indicates an ocean area feature whose geometry represents the
+surface area of an ocean or part of an ocean. Ocean area may be tiled into many small polygons
+of consistent complexity to ensure manageable geometry. In Overture data releases, ocean area
+features are created from OpenStreetMap coastlines data (`natural=coastline`) using a QA'd
+version of the output from the OSMCoastline tool. In aggregate, all the ocean area features
+represent the inverse of the land features with subtype `"land"` and class `"land"`.
+
+The names and recommended label position for oceans and seas can be found in features with the
+subtype `"physical"` and the class `"ocean"` or `"sea"`.
+
+Inland Water
+------------
+Subtypes other than `"ocean"` (and `"physical"`) represent inland water bodies. In Overture data
+releases, these features are sourced from the OpenStreetMap tag `natural=*` where the tag value
+indicates a water body, as well as the tags `natural=water`,  `waterway=*`,
+and `water=*`.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Geometry of the water feature, which may be a point, line string, polygon, or multi-polygon.<br/><br/>*Allowed geometry types: LineString, MultiPolygon, Point, Polygon* |
+| `theme` | `"base"` | |
+| `type` | `"water"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `class` | [`WaterClass`](types/water_class.md) (optional) | |
+| `subtype` | [`WaterSubtype`](types/water_subtype.md) (optional) | |
+| `is_intermittent` | `boolean` (optional) | Whether the water body exists intermittently, not permanently<br/><br/>*`strict=True`* |
+| `is_salt` | `boolean` (optional) | Whether the water body contains salt water<br/><br/>*`strict=True`* |
+| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `source_tags` | [`SourceTags`](types/source_tags.md) (map, optional) | Key/value pairs imported directly from the source data without change.<br/><br/>This field provides access to raw OSM entity tags for features sourced from OpenStreetMap. |
+| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `6bbb5fe5-bf26-3efa-b120-0a7079b60840` |
+| `bbox.xmin` | `-177.03179931640625` |
+| `bbox.ymin` | `-84.93480682373047` |
+| `bbox.xmax` | `-177.0317840576172` |
+| `bbox.ymax` | `-84.9347915649414` |
+| `geometry` | `POINT (-177.031799 -84.934793)` |
+| `theme` | `base` |
+| `type` | `water` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `n11109190647@2` |
+| `sources[0].update_time` | `2024-02-11T05:52:05+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].between` | `null` |
+| `class` | `cape` |
+| `subtype` | `physical` |
+| `is_intermittent` | `null` |
+| `is_salt` | `null` |
+| `level` | `0` |
+| `names.primary` | `Thanksgiving Point` |
+| `names.common` | `null` |
+| `names.rules` | `null` |
+| `source_tags` | `{"natural": "cape", "ref:linz:place_id": "13433"}` |
+| `wikidata` | `Q33140589` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/buildings/_category_.json
new file mode 100644
index 000000000..3e85a3e78
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/buildings/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Buildings",
+  "position": 3
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/building.md b/schema_versioned_docs/version-v1.17.0/reference/buildings/building.md
new file mode 100644
index 000000000..2e0b63e35
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/buildings/building.md
@@ -0,0 +1,102 @@
+---
+sidebar_position: 1
+---
+
+# Building
+
+Buildings are man-made structures with roofs that exist permanently in one place.
+
+A building's geometry represents the two-dimensional footprint of the building as viewed from
+directly above, looking down. Fields such as `height` and `num_floors` allow the
+three-dimensional shape to be approximated. Some buildings, identified by the `has_parts` field,
+have associated `BuildingPart` features which can be used to generate a more representative 3D
+model of the building.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | The building's footprint or roofprint (if traced from aerial/satellite imagery).<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
+| `theme` | `"buildings"` | |
+| `type` | `"building"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `subtype` | [`BuildingSubtype`](types/building_subtype.md) (optional) | A broad classification of the current use and purpose of the building.<br/><br/>If the current use of the building no longer accords with the original built purpose, the current use should be specified. For example, a building built as a train station but later converted into a shopping mall would have the value `"commercial"` rather than `"transportation"`. |
+| `class` | [`BuildingClass`](types/building_class.md) (optional) | A more specific classification of the current use and purpose of the building.<br/><br/>If the current use of the building no longer accords with the original built purpose, the current use should be specified. |
+| `has_parts` | `boolean` (optional) | Whether the building has associated building part features<br/><br/>*`strict=True`* |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level |
+| `height` | [`float64`](../system/primitive/primitives.md) (optional) | Height of the building or part in meters.<br/><br/>This is the distance from the lowest point to the highest point.<br/><br/>*`> 0`* |
+| `is_underground` | `boolean` (optional) | Whether the entire building or part is completely below ground.<br/><br/>The underground flag is useful for display purposes. Buildings and building parts that are entirely below ground can be styled differently or omitted from the rendered image.<br/><br/>This flag is conceptually different from the `level` field, which indicates relative z-ordering and, notably, can be negative even if the building is entirely above-ground.<br/><br/>*`strict=True`* |
+| `num_floors` | [`int32`](../system/primitive/primitives.md) (optional) | Number of above-ground floors of the building or part.<br/><br/>*`> 0`* |
+| `num_floors_underground` | [`int32`](../system/primitive/primitives.md) (optional) | Number of below-ground floors of the building or part.<br/><br/>*`> 0`* |
+| `min_height` | [`float64`](../system/primitive/primitives.md) (optional) | Altitude above ground where the bottom of the building or building part starts.<br/><br/>If present, this value indicates that the lowest part of the building or building part starts is above ground level. |
+| `min_floor` | [`int32`](../system/primitive/primitives.md) (optional) | Start floor of this building or part.<br/><br/>If present, this value indicates that the building or part is "floating" and its bottom-most floor is above ground level, usually because it is part of a larger building in which some parts do reach down to ground level. An example is a building that has an entry road or driveway at ground level into an interior courtyard, where part of the building bridges above the entry road. This property may sometimes be populated when `min_height` is missing and in these cases can be used as a proxy for `min_height`.<br/><br/>*`> 0`* |
+| `facade_color` | [`HexColor`](../system/hex_color.md) (optional) | Facade color in `#rgb` or `#rrggbb` hex notation |
+| `facade_material` | [`FacadeMaterial`](types/facade_material.md) (optional) | Outer surface material of the facade |
+| `roof_material` | [`RoofMaterial`](types/roof_material.md) (optional) | Outer surface material of the roof |
+| `roof_shape` | [`RoofShape`](types/roof_shape.md) (optional) | Shape of the roof |
+| `roof_direction` | [`float64`](../system/primitive/primitives.md) (optional) | Bearing of the roof ridge line in degrees<br/><br/>*`≥ 0`*<br/>*`< 360`* |
+| `roof_orientation` | [`RoofOrientation`](types/roof_orientation.md) (optional) | Orientation of the roof shape relative to the footprint shape |
+| `roof_color` | [`HexColor`](../system/hex_color.md) (optional) | The roof color in `#rgb` or `#rrggbb` hex notation |
+| `roof_height` | [`float64`](../system/primitive/primitives.md) (optional) | Height of the roof in meters.<br/><br/>This is the distance from the base of the roof to its highest point. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `148f35b1-7bc1-4180-9280-10d39b13883b` |
+| `bbox.xmin` | `-176.643798828125` |
+| `bbox.ymin` | `-43.9938850402832` |
+| `bbox.xmax` | `-176.64349365234375` |
+| `bbox.ymax` | `-43.993709564208984` |
+| `geometry` | `POLYGON ((-176.6435004 -43.9938042, -176.6435738 -43.9937107, -176.6437726 -43.9937913, -176.6436...` |
+| `theme` | `buildings` |
+| `type` | `building` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `w519166507@1` |
+| `sources[0].update_time` | `2017-08-27T21:39:50+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].between` | `null` |
+| `subtype` | `null` |
+| `class` | `null` |
+| `has_parts` | `false` |
+| `names` | `null` |
+| `level` | `0` |
+| `height` | `null` |
+| `is_underground` | `false` |
+| `num_floors` | `null` |
+| `num_floors_underground` | `null` |
+| `min_height` | `null` |
+| `min_floor` | `null` |
+| `facade_color` | `null` |
+| `facade_material` | `null` |
+| `roof_material` | `null` |
+| `roof_shape` | `null` |
+| `roof_direction` | `null` |
+| `roof_orientation` | `null` |
+| `roof_color` | `null` |
+| `roof_height` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/building_part.md b/schema_versioned_docs/version-v1.17.0/reference/buildings/building_part.md
new file mode 100644
index 000000000..845670209
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/buildings/building_part.md
@@ -0,0 +1,101 @@
+---
+sidebar_position: 1
+---
+
+# BuildingPart
+
+Building parts represent parts of larger building features. They allow buildings to be modeled
+in rich detail suitable for creating realistic 3D models.
+
+Every building part is associated with a parent `Building` feature via the `building_id` field.
+In addition, a building part has a footprint geometry and may include additional details such as
+its height, the number of floors, and the color and material of its facade and roof.
+
+Building parts can float or be stacked on top of each other. The `min_height`, `min_floor`,
+`height`, and `num_floors`, fields can be used to arrange the parts correctly along the
+vertical dimension.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | The footprint or roofprint of the building part.<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
+| `theme` | `"buildings"` | |
+| `type` | `"building_part"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `building_id` | [`Id`](../system/ref/id.md) | The building to which this part belongs<br/><br/>*References [`Building`](building.md) (composition, part of)* |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level |
+| `height` | [`float64`](../system/primitive/primitives.md) (optional) | Height of the building or part in meters.<br/><br/>This is the distance from the lowest point to the highest point.<br/><br/>*`> 0`* |
+| `is_underground` | `boolean` (optional) | Whether the entire building or part is completely below ground.<br/><br/>The underground flag is useful for display purposes. Buildings and building parts that are entirely below ground can be styled differently or omitted from the rendered image.<br/><br/>This flag is conceptually different from the `level` field, which indicates relative z-ordering and, notably, can be negative even if the building is entirely above-ground.<br/><br/>*`strict=True`* |
+| `num_floors` | [`int32`](../system/primitive/primitives.md) (optional) | Number of above-ground floors of the building or part.<br/><br/>*`> 0`* |
+| `num_floors_underground` | [`int32`](../system/primitive/primitives.md) (optional) | Number of below-ground floors of the building or part.<br/><br/>*`> 0`* |
+| `min_height` | [`float64`](../system/primitive/primitives.md) (optional) | Altitude above ground where the bottom of the building or building part starts.<br/><br/>If present, this value indicates that the lowest part of the building or building part starts is above ground level. |
+| `min_floor` | [`int32`](../system/primitive/primitives.md) (optional) | Start floor of this building or part.<br/><br/>If present, this value indicates that the building or part is "floating" and its bottom-most floor is above ground level, usually because it is part of a larger building in which some parts do reach down to ground level. An example is a building that has an entry road or driveway at ground level into an interior courtyard, where part of the building bridges above the entry road. This property may sometimes be populated when `min_height` is missing and in these cases can be used as a proxy for `min_height`.<br/><br/>*`> 0`* |
+| `facade_color` | [`HexColor`](../system/hex_color.md) (optional) | Facade color in `#rgb` or `#rrggbb` hex notation |
+| `facade_material` | [`FacadeMaterial`](types/facade_material.md) (optional) | Outer surface material of the facade |
+| `roof_material` | [`RoofMaterial`](types/roof_material.md) (optional) | Outer surface material of the roof |
+| `roof_shape` | [`RoofShape`](types/roof_shape.md) (optional) | Shape of the roof |
+| `roof_direction` | [`float64`](../system/primitive/primitives.md) (optional) | Bearing of the roof ridge line in degrees<br/><br/>*`≥ 0`*<br/>*`< 360`* |
+| `roof_orientation` | [`RoofOrientation`](types/roof_orientation.md) (optional) | Orientation of the roof shape relative to the footprint shape |
+| `roof_color` | [`HexColor`](../system/hex_color.md) (optional) | The roof color in `#rgb` or `#rrggbb` hex notation |
+| `roof_height` | [`float64`](../system/primitive/primitives.md) (optional) | Height of the roof in meters.<br/><br/>This is the distance from the base of the roof to its highest point. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `19412d64-51ac-3d6a-ac2f-8a8c8b91bb60` |
+| `bbox.xmin` | `-73.24630737304688` |
+| `bbox.ymin` | `-39.81101608276367` |
+| `bbox.xmax` | `-73.24613952636719` |
+| `bbox.ymax` | `-39.81088638305664` |
+| `geometry` | `POLYGON ((-73.2462509 -39.8108937, -73.2462755 -39.8109047, -73.246291 -39.8109182, -73.2463022 -...` |
+| `theme` | `buildings` |
+| `type` | `building_part` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `w223076787@2` |
+| `sources[0].update_time` | `2014-10-31T22:55:36+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].between` | `null` |
+| `building_id` | `bd663bd4-1844-4d7d-a400-114de051cf49` |
+| `names` | `null` |
+| `level` | `3` |
+| `height` | `null` |
+| `is_underground` | `false` |
+| `num_floors` | `null` |
+| `num_floors_underground` | `null` |
+| `min_height` | `null` |
+| `min_floor` | `null` |
+| `facade_color` | `null` |
+| `facade_material` | `null` |
+| `roof_material` | `null` |
+| `roof_shape` | `null` |
+| `roof_direction` | `null` |
+| `roof_orientation` | `null` |
+| `roof_color` | `null` |
+| `roof_height` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/_category_.json
new file mode 100644
index 000000000..a3ec08974
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Types"
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/building_class.md b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/building_class.md
new file mode 100644
index 000000000..7cdc52c0a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/building_class.md
@@ -0,0 +1,99 @@
+# BuildingClass
+
+Further classification of the type and purpose of a building.
+
+The building class adds detail to the broad classification of `BuildingSubtype`.
+
+## Values
+
+- `agricultural`
+- `allotment_house`
+- `apartments`
+- `barn`
+- `beach_hut`
+- `boathouse`
+- `bridge_structure`
+- `bungalow`
+- `bunker`
+- `cabin`
+- `carport`
+- `cathedral`
+- `chapel`
+- `church`
+- `civic`
+- `college`
+- `commercial`
+- `cowshed`
+- `detached`
+- `digester`
+- `dormitory`
+- `dwelling_house`
+- `factory`
+- `farm`
+- `farm_auxiliary`
+- `fire_station`
+- `garage`
+- `garages`
+- `ger`
+- `glasshouse`
+- `government`
+- `grandstand`
+- `greenhouse`
+- `guardhouse`
+- `hangar`
+- `hospital`
+- `hotel`
+- `house`
+- `houseboat`
+- `hut`
+- `industrial`
+- `kindergarten`
+- `kiosk`
+- `library`
+- `manufacture`
+- `military`
+- `monastery`
+- `mosque`
+- `office`
+- `outbuilding`
+- `parking`
+- `pavilion`
+- `post_office`
+- `presbytery`
+- `public`
+- `religious`
+- `residential`
+- `retail`
+- `roof`
+- `school`
+- `semi`
+- `semidetached_house`
+- `service`
+- `shed`
+- `shrine`
+- `silo`
+- `slurry_tank`
+- `sports_centre`
+- `sports_hall`
+- `stable`
+- `stadium`
+- `static_caravan`
+- `stilt_house`
+- `storage_tank`
+- `sty`
+- `supermarket`
+- `synagogue`
+- `temple`
+- `terrace`
+- `toilets`
+- `train_station`
+- `transformer_tower`
+- `transportation`
+- `trullo`
+- `university`
+- `warehouse`
+- `wayside_shrine`
+
+## Used By
+
+- [`Building`](../building.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/building_subtype.md b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/building_subtype.md
new file mode 100644
index 000000000..7069cf95e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/building_subtype.md
@@ -0,0 +1,25 @@
+# BuildingSubtype
+
+Broadest classification of the type and purpose of a building.
+
+This broad classification can be refined by `BuildingClass`.
+
+## Values
+
+- `agricultural`
+- `civic`
+- `commercial`
+- `education`
+- `entertainment`
+- `industrial`
+- `medical`
+- `military`
+- `outbuilding`
+- `religious`
+- `residential`
+- `service`
+- `transportation`
+
+## Used By
+
+- [`Building`](../building.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/facade_material.md b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/facade_material.md
new file mode 100644
index 000000000..13a5a8c41
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/facade_material.md
@@ -0,0 +1,22 @@
+# FacadeMaterial
+
+The outer surface material of building facade.
+
+## Values
+
+- `brick`
+- `cement_block`
+- `clay`
+- `concrete`
+- `glass`
+- `metal`
+- `plaster`
+- `plastic`
+- `stone`
+- `timber_framing`
+- `wood`
+
+## Used By
+
+- [`Building`](../building.md)
+- [`BuildingPart`](../building_part.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_material.md b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_material.md
new file mode 100644
index 000000000..1efc1f022
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_material.md
@@ -0,0 +1,25 @@
+# RoofMaterial
+
+The outermost material of the roof.
+
+## Values
+
+- `concrete`
+- `copper`
+- `eternit`
+- `glass`
+- `grass`
+- `gravel`
+- `metal`
+- `plastic`
+- `roof_tiles`
+- `slate`
+- `solar_panels`
+- `tar_paper`
+- `thatch`
+- `wood`
+
+## Used By
+
+- [`Building`](../building.md)
+- [`BuildingPart`](../building_part.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_orientation.md b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_orientation.md
new file mode 100644
index 000000000..443af22a2
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_orientation.md
@@ -0,0 +1,16 @@
+# RoofOrientation
+
+Orientation of the roof shape relative to the footprint shape.
+
+The members of this enumeration, `"across"` and `"along"`, are borrowed from the OpenStreetMap
+`roof:orientation=*` tag and have the same meanings as they do in OSM.
+
+## Values
+
+- `across` - The roof ridge runs perpendicular to the longer of the two building edges, parallel to the shorter
+- `along` - The roof ridge runs parallel to the longer of the two building edges
+
+## Used By
+
+- [`Building`](../building.md)
+- [`BuildingPart`](../building_part.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_shape.md b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_shape.md
new file mode 100644
index 000000000..f1271e095
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_shape.md
@@ -0,0 +1,25 @@
+# RoofShape
+
+The shape of the roof.
+
+## Values
+
+- `dome`
+- `flat`
+- `gabled`
+- `gambrel`
+- `half_hipped`
+- `hipped`
+- `mansard`
+- `onion`
+- `pyramidal`
+- `round`
+- `saltbox`
+- `sawtooth`
+- `skillion`
+- `spherical`
+
+## Used By
+
+- [`Building`](../building.md)
+- [`BuildingPart`](../building_part.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/common/_category_.json
new file mode 100644
index 000000000..44fea45e2
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Common",
+  "position": 7
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/cartographic_hints.md b/schema_versioned_docs/version-v1.17.0/reference/common/cartographic_hints.md
new file mode 100644
index 000000000..33c58438b
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/cartographic_hints.md
@@ -0,0 +1,18 @@
+# CartographicHints
+
+Cartographic hints for optimal use of Overture features in map-making.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `prominence` | [`Prominence`](prominence.md) (optional) | Subjective scale of feature significance or importance, with 1 being the least, and 100 being the most, significant.<br/><br/>This value can be used to help drive decisions about how and when to display a feature, and how to treat it relative to neighboring features.<br/><br/>When populated by Overture, this value is derived from various factors including, but not limited to: feature and subtype, population, and capital status. |
+| `min_zoom` | [`MinZoom`](min_zoom.md) (optional) | Recommended minimum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels below this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `max_zoom` | [`MaxZoom`](max_zoom.md) (optional) | Recommended maximum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels above this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `sort_key` | [`SortKey`](sort_key.md) (optional) | Integer indicating the recommended order in which to draw features.<br/><br/>Features with a lower number should be drawn "in front" of features with a higher number. |
+
+## Used By
+
+- [`Bathymetry`](../base/bathymetry.md)
+- [`Division`](../divisions/division.md)
+- [`LandCover`](../base/land_cover.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/common_names.md b/schema_versioned_docs/version-v1.17.0/reference/common/common_names.md
new file mode 100644
index 000000000..2d1950d78
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/common_names.md
@@ -0,0 +1,10 @@
+# CommonNames
+
+A mapping from language to the most commonly used or recognized name in that language.
+
+Underlying type: `map<`[`LanguageTag`](../system/language_tag.md)`,`[`StrippedString`](../system/stripped_string.md)`>`
+
+## Used By
+
+- [`Division`](../divisions/division.md)
+- [`Names`](names.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/confidence_score.md b/schema_versioned_docs/version-v1.17.0/reference/common/confidence_score.md
new file mode 100644
index 000000000..42256524e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/confidence_score.md
@@ -0,0 +1,15 @@
+# ConfidenceScore
+
+Confidence score between 0.0 and 1.0
+
+Underlying type: `float64`
+
+## Constraints
+
+- `≥ 0.0`
+- `≤ 1.0`
+
+## Used By
+
+- [`Place`](../places/place.md)
+- [`SourceItem`](source_item.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/feature_version.md b/schema_versioned_docs/version-v1.17.0/reference/common/feature_version.md
new file mode 100644
index 000000000..969394483
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/feature_version.md
@@ -0,0 +1,27 @@
+# FeatureVersion
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 0`
+- `≥ -2147483648` (from [`int32`](../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../system/primitive/primitives.md))
+
+## Used By
+
+- [`Address`](../addresses/address.md)
+- [`Bathymetry`](../base/bathymetry.md)
+- [`Building`](../buildings/building.md)
+- [`BuildingPart`](../buildings/building_part.md)
+- [`Connector`](../transportation/connector.md)
+- [`Division`](../divisions/division.md)
+- [`DivisionArea`](../divisions/division_area.md)
+- [`DivisionBoundary`](../divisions/division_boundary.md)
+- [`Infrastructure`](../base/infrastructure.md)
+- [`Land`](../base/land.md)
+- [`LandCover`](../base/land_cover.md)
+- [`LandUse`](../base/land_use.md)
+- [`Place`](../places/place.md)
+- [`Segment`](../transportation/segment.md)
+- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/length_unit.md b/schema_versioned_docs/version-v1.17.0/reference/common/length_unit.md
new file mode 100644
index 000000000..44750a380
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/length_unit.md
@@ -0,0 +1,19 @@
+# LengthUnit
+
+Unit of length.
+
+## Values
+
+- `in` - One inch in the imperial and US customary systems
+- `ft` - One foot in the imperial and US customary systems (12 inches)
+- `yd` - One yard in the imperial and US customary systems (three feet)
+- `mi` - One mile in the imperial and US customary systems (1,760 yards)
+- `cm` - One centimeter in the metric and SI systems
+- `m` - One meter in the metric and SI systems
+- `km` - One kilometer in the metric and SI systems
+
+## Used By
+
+- [`VehicleHeightSelector`](scoping/vehicle_height_selector.md)
+- [`VehicleLengthSelector`](scoping/vehicle_length_selector.md)
+- [`VehicleWidthSelector`](scoping/vehicle_width_selector.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/level.md b/schema_versioned_docs/version-v1.17.0/reference/common/level.md
new file mode 100644
index 000000000..dff9ca8a0
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/level.md
@@ -0,0 +1,20 @@
+# Level
+
+Z-order of the feature where 0 is visual level
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ -2147483648` (from [`int32`](../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../system/primitive/primitives.md))
+
+## Used By
+
+- [`Building`](../buildings/building.md)
+- [`BuildingPart`](../buildings/building_part.md)
+- [`Infrastructure`](../base/infrastructure.md)
+- [`Land`](../base/land.md)
+- [`LandUse`](../base/land_use.md)
+- [`LevelRule`](../transportation/types/level_rule.md)
+- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/max_zoom.md b/schema_versioned_docs/version-v1.17.0/reference/common/max_zoom.md
new file mode 100644
index 000000000..6f06fba07
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/max_zoom.md
@@ -0,0 +1,23 @@
+# MaxZoom
+
+Recommended maximum tile zoom level in which this feature should be displayed.
+
+It is recommended that the feature be hidden at zoom levels above this value.
+
+Zoom levels follow the Slippy Maps convention, documented in the following
+references:
+- [https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames](https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames)
+- [https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection](https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection)
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 0`
+- `≤ 23`
+- `≥ -2147483648` (from [`int32`](../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../system/primitive/primitives.md))
+
+## Used By
+
+- [`CartographicHints`](cartographic_hints.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/min_zoom.md b/schema_versioned_docs/version-v1.17.0/reference/common/min_zoom.md
new file mode 100644
index 000000000..f309c1e03
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/min_zoom.md
@@ -0,0 +1,23 @@
+# MinZoom
+
+Recommended minimum tile zoom level in which this feature should be displayed.
+
+It is recommended that the feature be hidden at zoom levels below this value.
+
+Zoom levels follow the Slippy Maps convention, documented in the following
+references:
+- [https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames](https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames)
+- [https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection](https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection)
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 0`
+- `≤ 23`
+- `≥ -2147483648` (from [`int32`](../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../system/primitive/primitives.md))
+
+## Used By
+
+- [`CartographicHints`](cartographic_hints.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/name_rule.md b/schema_versioned_docs/version-v1.17.0/reference/common/name_rule.md
new file mode 100644
index 000000000..4b1c0308b
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/name_rule.md
@@ -0,0 +1,32 @@
+# NameRule
+
+A rule that can be evaluated to determine the name in advanced scenarios.
+
+Name rules are used for cases where the primary name is not sufficient; the common name is not
+the right fit for the use case and another variant is needed; or where the name only applies in
+certain specific circumstances.
+
+Examples might include:
+- An official, alternate, or short name.
+- A name that only applies to part of a linear path like a road segment (geometric range
+  scoping).
+- A name that only applies to the left or right side of a linear path like a road segment (side
+  scoping).
+- A name that is only accepted by some political perspectives.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`StrippedString`](../system/stripped_string.md) | The actual name value.<br/><br/>*Minimum length: 1* |
+| `variant` | [`NameVariant`](name_variant.md) | The name variant for this name rule. |
+| `language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `perspectives` | [`Perspectives`](perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `perspectives.mode` | [`PerspectiveMode`](perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `between` | [`LinearlyReferencedRange`](scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `side` | [`Side`](scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+
+## Used By
+
+- [`Names`](names.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/name_variant.md b/schema_versioned_docs/version-v1.17.0/reference/common/name_variant.md
new file mode 100644
index 000000000..ea9fa475c
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/name_variant.md
@@ -0,0 +1,22 @@
+# NameVariant
+
+Name variant used in a `NameRule`.
+
+## Values
+
+- `common` - The most commonly used or recognized name for a feature in the specified language.
+
+In a `Names` value, most common names will appear in the `Names.common` field and will
+not need to be specified as `NameRule` values in `Names.rules`. This member of the
+enumeration should only be used to construct a `NameRule` if the common name needs to
+be scoped in some way and therefore cannot be accurately represented in `CommonNames`.
+- `official` - The legally or administratively recognized name, often used by government agencies or
+official documents.
+- `alternate` - An alternative name, which may be a historical name, a local colloquial name, or some
+other well-known name is not the common name.
+- `short` - An abbreviated or shortened version of the name, which may be an acronym or some other
+commonly-used short form. An example is "NYC" for New York City.
+
+## Used By
+
+- [`NameRule`](name_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/names.md b/schema_versioned_docs/version-v1.17.0/reference/common/names.md
new file mode 100644
index 000000000..220658c59
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/names.md
@@ -0,0 +1,33 @@
+# Names
+
+Multilingual names container.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name.<br/><br/>*Minimum length: 1* |
+| `common` | [`CommonNames`](common_names.md) (map, optional) | |
+| `rules[]` | `list<`[`NameRule`](name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `rules[].variant` | [`NameVariant`](name_variant.md) | The name variant for this name rule. |
+| `rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `rules[].perspectives` | [`Perspectives`](perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `rules[].perspectives.mode` | [`PerspectiveMode`](perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `rules[].between` | [`LinearlyReferencedRange`](scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `rules[].side` | [`Side`](scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+
+## Used By
+
+- [`Brand`](../places/types/brand.md)
+- [`Building`](../buildings/building.md)
+- [`BuildingPart`](../buildings/building_part.md)
+- [`Division`](../divisions/division.md)
+- [`DivisionArea`](../divisions/division_area.md)
+- [`Infrastructure`](../base/infrastructure.md)
+- [`Land`](../base/land.md)
+- [`LandUse`](../base/land_use.md)
+- [`Place`](../places/place.md)
+- [`Segment`](../transportation/segment.md)
+- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/perspective_mode.md b/schema_versioned_docs/version-v1.17.0/reference/common/perspective_mode.md
new file mode 100644
index 000000000..af2f597ff
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/perspective_mode.md
@@ -0,0 +1,12 @@
+# PerspectiveMode
+
+Perspective mode for disputed names.
+
+## Values
+
+- `accepted_by`
+- `disputed_by`
+
+## Used By
+
+- [`Perspectives`](perspectives.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/perspectives.md b/schema_versioned_docs/version-v1.17.0/reference/common/perspectives.md
new file mode 100644
index 000000000..b5e634d91
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/perspectives.md
@@ -0,0 +1,16 @@
+# Perspectives
+
+Political perspectives container.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `mode` | [`PerspectiveMode`](perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+
+## Used By
+
+- [`Division`](../divisions/division.md)
+- [`DivisionBoundary`](../divisions/division_boundary.md)
+- [`NameRule`](name_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/prominence.md b/schema_versioned_docs/version-v1.17.0/reference/common/prominence.md
new file mode 100644
index 000000000..524ec9790
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/prominence.md
@@ -0,0 +1,23 @@
+# Prominence
+
+Subjective scale of feature significance or importance, with 1 being the least, and
+100 being the most, significant.
+
+This value can be used to help drive decisions about how and when to display a
+feature, and how to treat it relative to neighboring features.
+
+When populated by Overture, this value is derived from various factors including,
+but not limited to: feature and subtype, population, and capital status.
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 1`
+- `≤ 100`
+- `≥ -2147483648` (from [`int32`](../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../system/primitive/primitives.md))
+
+## Used By
+
+- [`CartographicHints`](cartographic_hints.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/_category_.json
new file mode 100644
index 000000000..155d669bb
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Scoping"
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/heading.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/heading.md
new file mode 100644
index 000000000..e59a4600d
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/heading.md
@@ -0,0 +1,17 @@
+# Heading
+
+Travel direction along an oriented path: forward or backward.
+
+## Values
+
+- `forward`
+- `backward`
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`DestinationRule`](../../transportation/types/destination_rule.md)
+- [`DestinationRule.When`](../../transportation/types/destination_rule.when.md)
+- [`ProhibitedTransitionRule`](../../transportation/types/prohibited_transition_rule.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/linearly_referenced_position.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/linearly_referenced_position.md
new file mode 100644
index 000000000..605af6ee2
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/linearly_referenced_position.md
@@ -0,0 +1,15 @@
+# LinearlyReferencedPosition
+
+Represents a linearly-referenced position between 0% and 100% of the distance along a path such as a road segment or a river center-line segment.
+
+Underlying type: `float64`
+
+## Constraints
+
+- `≥ 0.0`
+- `≤ 1.0`
+
+## Used By
+
+- [`ConnectorReference`](../../transportation/types/connector_reference.md)
+- [`LinearlyReferencedRange`](linearly_referenced_range.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/linearly_referenced_range.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/linearly_referenced_range.md
new file mode 100644
index 000000000..b08f04917
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/linearly_referenced_range.md
@@ -0,0 +1,26 @@
+# LinearlyReferencedRange
+
+Represents a non-empty range of positions along a path as a pair linearly-referenced positions. For example, the pair [0.25, 0.5] represents the range beginning 25% of the distance from the start of the path and ending 50% of the distance from the path
+
+Underlying type: `list<float64>`
+
+## Constraints
+
+- Linear reference range constraint (0.0 to 1.0). (`LinearReferenceRangeConstraint`)
+- `≥ 0.0` (from [`LinearlyReferencedPosition`](linearly_referenced_position.md))
+- `≤ 1.0` (from [`LinearlyReferencedPosition`](linearly_referenced_position.md))
+
+## Used By
+
+- [`AccessRestrictionRule`](../../transportation/types/access_restriction_rule.md)
+- [`LevelRule`](../../transportation/types/level_rule.md)
+- [`NameRule`](../name_rule.md)
+- [`ProhibitedTransitionRule`](../../transportation/types/prohibited_transition_rule.md)
+- [`RailFlagRule`](../../transportation/types/rail_flag_rule.md)
+- [`RoadFlagRule`](../../transportation/types/road_flag_rule.md)
+- [`RouteReference`](../../transportation/types/route_reference.md)
+- [`SourceItem`](../source_item.md)
+- [`SpeedLimitRule`](../../transportation/types/speed_limit_rule.md)
+- [`SubclassRule`](../../transportation/types/subclass_rule.md)
+- [`SurfaceRule`](../../transportation/types/surface_rule.md)
+- [`WidthRule`](../../transportation/types/width_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/opening_hours.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/opening_hours.md
new file mode 100644
index 000000000..da30697ee
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/opening_hours.md
@@ -0,0 +1,12 @@
+# OpeningHours
+
+Time span or time spans during which something is open or active, specified in the OpenStreetMap
+opening hours specification: [https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification](https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification).
+
+Underlying type: `string`
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/purpose_of_use.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/purpose_of_use.md
new file mode 100644
index 000000000..a91e74f92
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/purpose_of_use.md
@@ -0,0 +1,18 @@
+# PurposeOfUse
+
+Reason why a person or entity travelling on the transportation network is using a particular
+location.
+
+## Values
+
+- `as_customer`
+- `at_destination`
+- `to_deliver`
+- `to_farm`
+- `for_forestry`
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/recognized_status.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/recognized_status.md
new file mode 100644
index 000000000..52ce0c78c
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/recognized_status.md
@@ -0,0 +1,18 @@
+# RecognizedStatus
+
+Status of the person or entity travelling as recognized by authorities controlling the particular
+location.
+
+## Values
+
+- `as_permitted`
+- `as_private`
+- `as_disabled`
+- `as_employee`
+- `as_student`
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/side.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/side.md
new file mode 100644
index 000000000..e8a269ef7
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/side.md
@@ -0,0 +1,15 @@
+# Side
+
+The side, left or right, on which something appears relative to a facing or heading direction
+(*e.g.*, the side of a road relative to the road orientation), or relative to the direction of
+travel of a person or vehicle.
+
+## Values
+
+- `left` - On the left relative to the facing direction
+- `right` - On the right side relative to the facing direction
+
+## Used By
+
+- [`NameRule`](../name_rule.md)
+- [`Norms`](../../divisions/types/norms.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/travel_mode.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/travel_mode.md
new file mode 100644
index 000000000..1a2aa0b55
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/travel_mode.md
@@ -0,0 +1,25 @@
+# TravelMode
+
+Enumerates possible travel modes.
+
+Some modes represent groups of modes.
+
+## Values
+
+- `vehicle`
+- `motor_vehicle`
+- `car`
+- `truck`
+- `motorcycle`
+- `foot`
+- `bicycle`
+- `bus`
+- `hgv`
+- `hov`
+- `emergency`
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_axle_count_selector.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_axle_count_selector.md
new file mode 100644
index 000000000..461dd926a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_axle_count_selector.md
@@ -0,0 +1,17 @@
+# VehicleAxleCountSelector
+
+Selects vehicles based on the number of axles they have.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `dimension` | `"axle_count"` | |
+| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
+| `value` | [`uint8`](../../system/primitive/primitives.md) | Number of axles on the vehicle |
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_height_selector.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_height_selector.md
new file mode 100644
index 000000000..ba56f33d7
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_height_selector.md
@@ -0,0 +1,18 @@
+# VehicleHeightSelector
+
+Selects vehicles based on their height.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `dimension` | `"height"` | |
+| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
+| `value` | [`float64`](../../system/primitive/primitives.md) | Vehicle height selection threshold in the given `unit`<br/><br/>*`≥ 0`* |
+| `unit` | [`LengthUnit`](../length_unit.md) | Height unit in which `value` is expressed |
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_length_selector.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_length_selector.md
new file mode 100644
index 000000000..5a6e1c017
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_length_selector.md
@@ -0,0 +1,18 @@
+# VehicleLengthSelector
+
+Selects vehicles based on their length.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `dimension` | `"length"` | |
+| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
+| `value` | [`float64`](../../system/primitive/primitives.md) | Vehicle length selection threshold in the given `unit`<br/><br/>*`≥ 0`* |
+| `unit` | [`LengthUnit`](../length_unit.md) | Length unit in which `value` is expressed |
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_relation.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_relation.md
new file mode 100644
index 000000000..0ac89eddd
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_relation.md
@@ -0,0 +1,19 @@
+# VehicleRelation
+
+Relational operator, such as less than or equal to.
+
+## Values
+
+- `greater_than`
+- `greater_than_equal`
+- `equal`
+- `less_than`
+- `less_than_equal`
+
+## Used By
+
+- [`VehicleAxleCountSelector`](vehicle_axle_count_selector.md)
+- [`VehicleHeightSelector`](vehicle_height_selector.md)
+- [`VehicleLengthSelector`](vehicle_length_selector.md)
+- [`VehicleWeightSelector`](vehicle_weight_selector.md)
+- [`VehicleWidthSelector`](vehicle_width_selector.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_weight_selector.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_weight_selector.md
new file mode 100644
index 000000000..3e42bdce1
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_weight_selector.md
@@ -0,0 +1,18 @@
+# VehicleWeightSelector
+
+Selects vehicles based on their weight.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `dimension` | `"weight"` | |
+| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
+| `value` | [`float64`](../../system/primitive/primitives.md) | Vehicle weight selection threshold in the given `unit`<br/><br/>*`≥ 0`* |
+| `unit` | [`WeightUnit`](../weight_unit.md) | Weight unit in which `value` is expressed |
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_width_selector.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_width_selector.md
new file mode 100644
index 000000000..f86e41b3b
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_width_selector.md
@@ -0,0 +1,18 @@
+# VehicleWidthSelector
+
+Selects vehicles based on their width.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `dimension` | `"width"` | |
+| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
+| `value` | [`float64`](../../system/primitive/primitives.md) | Vehicle width selection threshold in the given `unit`<br/><br/>*`≥ 0`* |
+| `unit` | [`LengthUnit`](../length_unit.md) | Width unit in which `value` is expressed |
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/sort_key.md b/schema_versioned_docs/version-v1.17.0/reference/common/sort_key.md
new file mode 100644
index 000000000..1c1187168
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/sort_key.md
@@ -0,0 +1,17 @@
+# SortKey
+
+Integer indicating the recommended order in which to draw features.
+
+Features with a lower number should be drawn "in front" of features with a higher
+number.
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ -2147483648` (from [`int32`](../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../system/primitive/primitives.md))
+
+## Used By
+
+- [`CartographicHints`](cartographic_hints.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/source_item.md b/schema_versioned_docs/version-v1.17.0/reference/common/source_item.md
new file mode 100644
index 000000000..c4acca0d8
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/source_item.md
@@ -0,0 +1,34 @@
+# SourceItem
+
+Specifies the source of the data used for a feature or one of its properties.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `dataset` | `string` | Name of the dataset where the source data can be found. |
+| `license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `confidence` | [`ConfidenceScore`](confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `between` | [`LinearlyReferencedRange`](scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+
+## Used By
+
+- [`Address`](../addresses/address.md)
+- [`Bathymetry`](../base/bathymetry.md)
+- [`Building`](../buildings/building.md)
+- [`BuildingPart`](../buildings/building_part.md)
+- [`Connector`](../transportation/connector.md)
+- [`Division`](../divisions/division.md)
+- [`DivisionArea`](../divisions/division_area.md)
+- [`DivisionBoundary`](../divisions/division_boundary.md)
+- [`Infrastructure`](../base/infrastructure.md)
+- [`Land`](../base/land.md)
+- [`LandCover`](../base/land_cover.md)
+- [`LandUse`](../base/land_use.md)
+- [`Place`](../places/place.md)
+- [`Segment`](../transportation/segment.md)
+- [`Water`](../base/water.md)
+- [`Sources`](sources.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/sources.md b/schema_versioned_docs/version-v1.17.0/reference/common/sources.md
new file mode 100644
index 000000000..ac48419ef
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/sources.md
@@ -0,0 +1,28 @@
+# Sources
+
+Information about the source data used to assemble the feature.
+
+Underlying type: `list<`[`SourceItem`](source_item.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Address`](../addresses/address.md)
+- [`Bathymetry`](../base/bathymetry.md)
+- [`Building`](../buildings/building.md)
+- [`BuildingPart`](../buildings/building_part.md)
+- [`Connector`](../transportation/connector.md)
+- [`Division`](../divisions/division.md)
+- [`DivisionArea`](../divisions/division_area.md)
+- [`DivisionBoundary`](../divisions/division_boundary.md)
+- [`Infrastructure`](../base/infrastructure.md)
+- [`Land`](../base/land.md)
+- [`LandCover`](../base/land_cover.md)
+- [`LandUse`](../base/land_use.md)
+- [`Place`](../places/place.md)
+- [`Segment`](../transportation/segment.md)
+- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/speed_unit.md b/schema_versioned_docs/version-v1.17.0/reference/common/speed_unit.md
new file mode 100644
index 000000000..acfd44ac0
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/speed_unit.md
@@ -0,0 +1,12 @@
+# SpeedUnit
+
+Unit of speed.
+
+## Values
+
+- `mph` - Miles per hour
+- `km/h` - Kilometers per hour
+
+## Used By
+
+- [`Speed`](../transportation/types/speed.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/weight_unit.md b/schema_versioned_docs/version-v1.17.0/reference/common/weight_unit.md
new file mode 100644
index 000000000..f53cb2977
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/common/weight_unit.md
@@ -0,0 +1,17 @@
+# WeightUnit
+
+Unit of weight.
+
+## Values
+
+- `oz` - One ounce in the imperial and US customary systems
+- `lb` - One pound in the imperial and US customary systems
+- `st` - One short ton, or one ton in the US customary system (2,000 pounds)
+- `lt` - One long ton, or one ton in the imperial system (2,400 pounds)
+- `g` - One gram in the metric and SI systems
+- `kg` - One kilogram in the metric and SI systems
+- `t` - One tonne in the metric and SI systems
+
+## Used By
+
+- [`VehicleWeightSelector`](scoping/vehicle_weight_selector.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/divisions/_category_.json
new file mode 100644
index 000000000..51eecd257
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/divisions/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Divisions",
+  "position": 4
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/division.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/division.md
new file mode 100644
index 000000000..94981f754
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/divisions/division.md
@@ -0,0 +1,132 @@
+---
+sidebar_position: 1
+---
+
+# Division
+
+Divisions are recognized official or non-official organizations of people as seen from a given
+political perspective.
+
+Examples include countries, provinces, cities, towns, neighborhoods, etc.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `cartography` | [`CartographicHints`](../common/cartographic_hints.md) (optional) | Cartographic hints useful when including the feature in maps |
+| `cartography.prominence` | [`Prominence`](../common/prominence.md) (optional) | Subjective scale of feature significance or importance, with 1 being the least, and 100 being the most, significant.<br/><br/>This value can be used to help drive decisions about how and when to display a feature, and how to treat it relative to neighboring features.<br/><br/>When populated by Overture, this value is derived from various factors including, but not limited to: feature and subtype, population, and capital status. |
+| `cartography.min_zoom` | [`MinZoom`](../common/min_zoom.md) (optional) | Recommended minimum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels below this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `cartography.max_zoom` | [`MaxZoom`](../common/max_zoom.md) (optional) | Recommended maximum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels above this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `cartography.sort_key` | [`SortKey`](../common/sort_key.md) (optional) | Integer indicating the recommended order in which to draw features.<br/><br/>Features with a lower number should be drawn "in front" of features with a higher number. |
+| `names` | [`Names`](../common/names.md) | All known names by which the division is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Approximate location of a position commonly associated with the real-world entity modeled by the division feature.<br/><br/>*Allowed geometry types: Point* |
+| `theme` | `"divisions"` | |
+| `type` | `"division"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `subtype` | [`DivisionSubtype`](types/division_subtype.md) | A broad classification of the division (e.g., country, region, locality, etc.).<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`*<br/>*`parent_division_id` is required when `subtype` ≠ `country`*<br/>*`parent_division_id` is forbidden when `subtype` = `country`* |
+| `country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) | ISO 3166-1 alpha-2 country code of the country or country-like entity, that this division represents or belongs to.<br/><br/>If the entity this division represents has a country code, the country property contains it. If it does not, the country property contains the country code of the first division encountered by traversing the parent_division_id chain to the root.<br/><br/>For example: - The country value for the United States is 'US' - The country value for New York City is 'US' - The country value for Puerto Rico, a dependency of the US, is 'PR'. - The country value for San Juan, Puerto Rico is 'PR'.<br/><br/>If an entity has an internationally-recognized ISO 3166-1 alpha-2 country code, it should always be used. In cases where the schema requires the code but no internationally-recognized code is available, a synthetic code may be used provided it does not conflict with any internationally-recognized codes. |
+| `hierarchies[][]` | `list<`[`Hierarchy`](types/hierarchy.md)`>` | Hierarchies in which this division participates.<br/><br/>Every division participates in at least one hierarchy. Most participate in only one. Some divisions may participate in more than one hierarchy, for example if they are claimed by different parent divisions from different political perspectives; or if there are other real-world reasons why the division or one of its ancestors has multiple parents.<br/><br/>The first hierarchy in the list is the default hierarchy, and the second-to-last entry in the default hierarchy (if there is such an entry) always corresponds to the `parent_division_id` property. The ordering of hierarchies after the first one is arbitrary.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `hierarchies[][].division_id` | [`Id`](../system/ref/id.md) | ID of a division that is an ancestor of the current division.<br/><br/>In the context of division hierarchies, the ancestor divisions of a division include the division itself, and any other division that is an ancestor of the division's parent. |
+| `hierarchies[][].subtype` | [`DivisionSubtype`](types/division_subtype.md) | |
+| `hierarchies[][].name` | [`StrippedString`](../system/stripped_string.md) | Primary name of the division |
+| `parent_division_id` | [`Id`](../system/ref/id.md) (optional) | Division ID of this division's parent division.<br/><br/>Not allowed for top-level divisions (countries) and required for all other divisions.<br/><br/>The default parent division is the parent division as seen from the default political perspective, if there is one, and is otherwise chosen somewhat arbitrarily. The hierarchies property can be used to inspect the exhaustive list of parent divisions.<br/><br/>*References `Division` (hierarchy, child of)*<br/><br/>*`parent_division_id` is required when `subtype` ≠ `country`*<br/>*`parent_division_id` is forbidden when `subtype` = `country`* |
+| `admin_level` | [`AdminLevel`](types/admin_level.md) (optional) | Integer representing the division's position in its country's administrative hierarchy, where lower numbers correspond to higher level administrative units.<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`* |
+| `class` | [`DivisionClass`](types/division_class.md) (optional) | A more specific classification of the division than is provided by `subtype`. |
+| `local_type` | [`CommonNames`](../common/common_names.md) (map, optional) | Local name for the subtype property, optionally localized.<br/><br/>For example, the Canadian province of Quebec has the subtype `"region"`, but in the local administrative hierarchy it is referred to as a province. Similarly, the Canadian Yukon territory also has subtype `"region"`, but is locally called a territory.<br/><br/>This property is localized using a standard Overture names structure. So for example, in Switzerland the top-level administrative subdivision corresponding to subtype 'region' is the canton, which may be translated in each of Switzerland's official languages as, 'canton' in French, 'kanton' in German, 'cantone' in Italian, and 'chantun' in Romansh. |
+| `region` | [`RegionCode`](../system/region_code.md) (optional) | ISO 3166-2 principal subdivision code of the subdivision-like entity this division represents or belongs to.<br/><br/>If the entity this division represents has a principal subdivision code, the region property contains it. If it does not, the region property contains the principal subdivision code of the first division encountered by traversing the `parent_division_id` chain to the root.<br/><br/>For example: - The region value for the United States is omitted. - The region value for the U.S. state of New York is 'US-NY'. - The region value for New York City is 'US-NY', which it inherits from the state   of New York. - The region value for Puerto Rico is 'US-PR'. |
+| `perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which this division is considered to be an accurate representation.<br/><br/>If this property is absent, then this division is not known to be disputed from any political perspective. Consequently, there is only one division feature representing the entire real world entity.<br/><br/>If this property is present, it means the division represents one of several alternative perspectives on the same real-world entity.<br/><br/>There are two modes of perspective:<br/><br/>1. `accepted_by` means the representation of the division is accepted by the    listed entities and would be included on a map drawn from their perspective.<br/><br/>2. `disputed_by` means the representation of the division is disputed by the    listed entities and would be excluded from a map drawn from their perspective.<br/><br/>When drawing a map from the perspective of a given country, one would start by gathering all the undisputed divisions (with no `perspectives` property), and then adding to that first all divisions explicitly accepted by the country, and second all divisions not explicitly disputed by the country. |
+| `perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `norms` | [`Norms`](types/norms.md) (optional) | Collects information about local norms and rules within the division that are generally useful for mapping and map-related use cases.<br/><br/>If the norms property or a desired sub-property of the norms property is missing on a division, but at least one of its ancestor divisions has the norms property and the desired sub-property, then the value from the nearest ancestor division may be assumed. |
+| `norms.driving_side` | [`Side`](../common/scoping/side.md) (optional) | Side of the road on which vehicles drive in the division. |
+| `population` | [`int32`](../system/primitive/primitives.md) (optional) | Population of the division<br/><br/>*`≥ 0`* |
+| `capital_division_ids` | `list<`[`Id`](../system/ref/id.md)`>` (optional) | Division IDs of this division's capital divisions. If present, this property will refer to the division IDs of the capital cities, county seats, etc. of a division.<br/><br/>*References `Division` (hierarchy, has as capital)*<br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `capital_of_divisions[]` | `list<`[`CapitalOfDivisionItem`](types/capital_of_division_item.md)`>` (optional) | Division IDs and subtypes of divisions this division is a capital of.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `capital_of_divisions[].division_id` | [`Id`](../system/ref/id.md) | ID of the division whose capital is the current division. |
+| `capital_of_divisions[].subtype` | [`DivisionSubtype`](types/division_subtype.md) | |
+| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+
+## Constraints
+
+- `admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`
+- `parent_division_id` is required when `subtype` ≠ `country`
+- `parent_division_id` is forbidden when `subtype` = `country`
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `cartography.prominence` | `29` |
+| `cartography.min_zoom` | `null` |
+| `cartography.max_zoom` | `null` |
+| `cartography.sort_key` | `null` |
+| `names.primary` | `Sia'atoutai` |
+| `names.common` | `null` |
+| `id` | `350e85f6-68ba-4114-9906-c2844815988b` |
+| `bbox.xmin` | `-175.25515747070312` |
+| `bbox.ymin` | `-21.1353702545166` |
+| `bbox.xmax` | `-175.255126953125` |
+| `bbox.ymax` | `-21.13536834716797` |
+| `geometry` | `POINT (-175.2551522 -21.1353686)` |
+| `theme` | `divisions` |
+| `type` | `division` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `n3173231082@4` |
+| `sources[0].update_time` | `2014-12-18T09:17:03+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].between` | `null` |
+| `subtype` | `locality` |
+| `country` | `TO` |
+| `hierarchies[0][0].division_id` | `fef8748b-0c91-46ad-9f2d-976d8d2de3e9` |
+| `hierarchies[0][0].subtype` | `country` |
+| `hierarchies[0][0].name` | `Tonga` |
+| `hierarchies[0][1].division_id` | `4d67561a-2292-41bd-8996-7853d276a42c` |
+| `hierarchies[0][1].subtype` | `region` |
+| `hierarchies[0][1].name` | `Tongatapu` |
+| `hierarchies[0][2].division_id` | `8730f0cc-d436-4f11-a7d3-49085813ef44` |
+| `hierarchies[0][2].subtype` | `county` |
+| `hierarchies[0][2].name` | `Vahe Kolomotu'a` |
+| `hierarchies[0][3].division_id` | `350e85f6-68ba-4114-9906-c2844815988b` |
+| `hierarchies[0][3].subtype` | `locality` |
+| `hierarchies[0][3].name` | `Sia'atoutai` |
+| `parent_division_id` | `8730f0cc-d436-4f11-a7d3-49085813ef44` |
+| `admin_level` | `null` |
+| `class` | `village` |
+| `local_type` | `{"en": "village"}` |
+| `region` | `TO-04` |
+| `perspectives` | `null` |
+| `norms` | `null` |
+| `population` | `534` |
+| `capital_division_ids` | `null` |
+| `capital_of_divisions` | `null` |
+| `wikidata` | `null` |
+| `names.rules[0].value` | `Nafualu` |
+| `names.rules[0].variant` | `alternate` |
+| `names.rules[0].language` | `null` |
+| `names.rules[0].perspectives` | `null` |
+| `names.rules[0].between` | `null` |
+| `names.rules[0].side` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/division_area.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/division_area.md
new file mode 100644
index 000000000..0fa1c5c60
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/divisions/division_area.md
@@ -0,0 +1,88 @@
+---
+sidebar_position: 1
+---
+
+# DivisionArea
+
+Division areas are polygon features that represent the land or maritime area covered by a
+division.
+
+Each division area belongs to a division which it references by ID, and for which the division
+area provides an area polygon. For ease of use, every division area repeats the subtype, names,
+country, and region properties of the division it belongs to.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `names` | [`Names`](../common/names.md) | All known names by which the owning division is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | The area covered by the division with which this area feature is associated.<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
+| `theme` | `"divisions"` | |
+| `type` | `"division_area"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `subtype` | [`DivisionSubtype`](types/division_subtype.md) | A broad classification of the division this area belongs to (e.g., country, region, locality, etc.).<br/><br/>This value is the same as the owning division's `subtype`.<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`* |
+| `class` | [`AreaClass`](types/area_class.md) | A more specific classification of the division area than is provided by `subtype`. |
+| `is_land` | `boolean` (optional) | Flag indicating whether or not the feature geometry represents the land-clipped, non-maritime boundary. The geometry can be used for map rendering, cartographic display, and similar purposes.<br/><br/>*`strict=True`*<br/><br/>*Exactly one of `is_land`, `is_territorial` must be `true`* |
+| `is_territorial` | `boolean` (optional) | Flag indicating whether or not the feature geometry represents Overture's best approximation of the division's territorial boundary. For coastal places, this will tend to include the water area. The geometry can be used for data processing, reverse-geocoding, and similar purposes.<br/><br/>*`strict=True`*<br/><br/>*Exactly one of `is_land`, `is_territorial` must be `true`* |
+| `division_id` | [`Id`](../system/ref/id.md) | Division ID of the parent division of this area.<br/><br/>*References [`Division`](division.md) (hierarchy, child of)* |
+| `country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) | ISO 3166-1 alpha-2 country code of the division this area belongs to. |
+| `region` | [`RegionCode`](../system/region_code.md) (optional) | ISO 3166-2 principal subdivision code of the division this area belongs to. |
+| `admin_level` | [`AdminLevel`](types/admin_level.md) (optional) | Integer representing the division's position in its country's administrative hierarchy, where lower numbers correspond to higher level administrative units.<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`* |
+
+## Constraints
+
+- Exactly one of `is_land`, `is_territorial` must be `true`
+- `admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `names.primary` | `ʻEua` |
+| `names.common` | `null` |
+| `names.rules` | `null` |
+| `id` | `eb9b112f-ec3c-47f7-b519-6f9f2e6fc2bd` |
+| `bbox.xmin` | `-174.97535705566406` |
+| `bbox.ymin` | `-21.473018646240234` |
+| `bbox.xmax` | `-174.90040588378906` |
+| `bbox.ymax` | `-21.283489227294922` |
+| `geometry` | `MULTIPOLYGON (((-174.9553949 -21.4730179, -174.9514163 -21.4719978, -174.9520108 -21.4681253, -17...` |
+| `theme` | `divisions` |
+| `type` | `division_area` |
+| `version` | `2` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `r7247527@3` |
+| `sources[0].update_time` | `2020-12-30T18:41:56+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].between` | `null` |
+| `subtype` | `region` |
+| `class` | `land` |
+| `is_land` | `true` |
+| `is_territorial` | `false` |
+| `division_id` | `21597af0-b564-463c-a356-42c29e712b7d` |
+| `country` | `TO` |
+| `region` | `TO-01` |
+| `admin_level` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/division_boundary.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/division_boundary.md
new file mode 100644
index 000000000..8988cc6ce
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/divisions/division_boundary.md
@@ -0,0 +1,85 @@
+---
+sidebar_position: 1
+---
+
+# DivisionBoundary
+
+Boundaries represent borders between divisions of the same subtype.
+
+Some boundaries may be disputed by the divisions on one or both sides.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Boundary line or lines<br/><br/>*Allowed geometry types: LineString, MultiLineString* |
+| `theme` | `"divisions"` | |
+| `type` | `"division_boundary"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `subtype` | [`DivisionSubtype`](types/division_subtype.md) | A broad classification of the divisions this boundary separates (e.g., country, region, locality, etc.).<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`*<br/>*`country` is required when `subtype` ≠ `country`*<br/>*`country` is forbidden when `subtype` = `country`* |
+| `class` | [`BoundaryClass`](types/boundary_class.md) | The kind of boundary: land or maritime. |
+| `is_land` | `boolean` (optional) | Flag indicating whether or not the feature geometry represents the land-clipped, non-maritime boundary. The geometry can be used for map rendering, cartographic display, and similar purposes.<br/><br/>*`strict=True`*<br/><br/>*Exactly one of `is_land`, `is_territorial` must be `true`* |
+| `is_territorial` | `boolean` (optional) | Flag indicating whether or not the feature geometry represents Overture's best approximation of the division's territorial boundary. For coastal places, this will tend to include the water area. The geometry can be used for data processing, reverse-geocoding, and similar purposes.<br/><br/>*`strict=True`*<br/><br/>*Exactly one of `is_land`, `is_territorial` must be `true`* |
+| `division_ids` | `list<`[`Id`](../system/ref/id.md)`>` | Identifies the two divisions to the left and right, respectively, of the boundary line. The left- and right-hand sides of the boundary are considered from the perspective of a person standing on the line facing in the direction in which the geometry is oriented, i.e. facing toward the end of the line.<br/><br/>The first array element is the Overture ID of the left division. The second element is the Overture ID of the right division.<br/><br/>*References [`Division`](division.md) (composition, boundary of)*<br/>*Minimum length: 2*<br/>*Maximum length: 2*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) (optional) | ISO 3166-1 alpha-2 country code of the country or country-like entity that both sides of the boundary share.<br/><br/>This property will be present on boundaries between two regions, counties, or similar entities within the same country, but will not be present on boundaries between two countries or country-like entities.<br/><br/>*`country` is required when `subtype` ≠ `country`*<br/>*`country` is forbidden when `subtype` = `country`* |
+| `region` | [`RegionCode`](../system/region_code.md) (optional) | ISO 3166-2 principal subdivision code of the subdivision-like entity that both sides of the boundary share.<br/><br/>This property will be present on boundaries between two counties, localadmins or similar entities within the same principal subdivision, but will not be present on boundaries between different principal subdivisions or countries. |
+| `admin_level` | [`AdminLevel`](types/admin_level.md) (optional) | Integer representing the division's position in its country's administrative hierarchy, where lower numbers correspond to higher level administrative units.<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`* |
+| `is_disputed` | `boolean` (optional) | Flag indicating whether this boundary is either disputed outright or is a "best guess" in a case where the boundary between two divisions is unclear.<br/><br/>If the boundary is disputed outright, this flag is true and the entities disputing it are listed in the `perspectives` property. If the boundary is simply a "best guess", this flag is true but no disputing entities are listed in `perspectives`.<br/><br/>*`strict=True`* |
+| `perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which this division boundary is considered to be an accurate representation.<br/><br/>If this property is absent, then this boundary is not known to be disputed from any political perspective. Consequently, there is only one boundary feature representing the entire real world entity.<br/><br/>If this property is present, it means the boundary represents one of several alternative perspectives on the same real-world entity.<br/><br/>There are two modes of perspective:<br/><br/>1. `accepted_by` means the representation of the boundary is accepted by the    listed entities and would be included on a map drawn from their perspective.<br/><br/>2. `disputed_by` means the representation of the boundary is disputed by the    listed entities and would be excluded from a map drawn from their    perspective.<br/><br/>When drawing a map from the perspective of a given country, one would start by gathering all the undisputed boundaries (those with no `perspectives` value); and then adding to that: first, all boundaries explicitly accepted by the country, and second, all boundaries not explicitly disputed by the country. |
+| `perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+
+## Constraints
+
+- Exactly one of `is_land`, `is_territorial` must be `true`
+- `admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`
+- `country` is required when `subtype` ≠ `country`
+- `country` is forbidden when `subtype` = `country`
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `2bdf68e4-860d-3d8c-a472-ccf439a5302a` |
+| `bbox.xmin` | `-147.06483459472656` |
+| `bbox.ymin` | `-15.4231538772583` |
+| `bbox.xmax` | `-147.04847717285156` |
+| `bbox.ymax` | `-15.151169776916504` |
+| `geometry` | `LINESTRING (-147.064823 -15.4231537, -147.0519131 -15.2885069, -147.048482 -15.1511701)` |
+| `theme` | `divisions` |
+| `type` | `division_boundary` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `r6063055@9` |
+| `sources[0].update_time` | `2023-07-20T00:28:40+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].between` | `null` |
+| `sources[1].property` |  |
+| `sources[1].dataset` | `OpenStreetMap` |
+| `sources[1].license` | `null` |
+| `sources[1].record_id` | `r6063063@12` |
+| `sources[1].update_time` | `2023-07-20T00:28:40+00:00` |
+| `sources[1].confidence` | `null` |
+| `sources[1].between` | `null` |
+| `subtype` | `county` |
+| `class` | `maritime` |
+| `is_land` | `false` |
+| `is_territorial` | `true` |
+| `division_ids` | `["ae266459-63a4-4508-8295-0101e27d039b", "d4a6873d-885a-4f2a-bc0f-37e9d9e874e4"]` |
+| `country` | `PF` |
+| `region` | `null` |
+| `admin_level` | `null` |
+| `is_disputed` | `false` |
+| `perspectives` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/_category_.json
new file mode 100644
index 000000000..a3ec08974
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Types"
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/admin_level.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/admin_level.md
new file mode 100644
index 000000000..98e38c849
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/admin_level.md
@@ -0,0 +1,19 @@
+# AdminLevel
+
+Integer representing the division's position in its country's administrative
+hierarchy, where lower numbers correspond to higher level administrative units.
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 0`
+- `≤ 16`
+- `≥ -2147483648` (from [`int32`](../../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../../system/primitive/primitives.md))
+
+## Used By
+
+- [`Division`](../division.md)
+- [`DivisionArea`](../division_area.md)
+- [`DivisionBoundary`](../division_boundary.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/area_class.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/area_class.md
new file mode 100644
index 000000000..b0367b2ca
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/area_class.md
@@ -0,0 +1,15 @@
+# AreaClass
+
+Further classification of a division area that is more specific than its `subtype`.
+
+A division area's `class` adds detail to the broad classification found in `DivisionSubtype`.
+
+## Values
+
+- `land` - The area does not extend beyond the coastline.
+- `maritime` - The area extends beyond the coastline, in most cases to the extent of the division's
+territorial sea, if it has one.
+
+## Used By
+
+- [`DivisionArea`](../division_area.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/boundary_class.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/boundary_class.md
new file mode 100644
index 000000000..9b2d103da
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/boundary_class.md
@@ -0,0 +1,13 @@
+# BoundaryClass
+
+The kind of boundary: land or maritime.
+
+## Values
+
+- `land` - None of the boundary geometry extends beyond the coastline of either associated
+division.
+- `maritime` - All the boundary geometry extends beyond the coastline of both associated divisions.
+
+## Used By
+
+- [`DivisionBoundary`](../division_boundary.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/capital_of_division_item.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/capital_of_division_item.md
new file mode 100644
index 000000000..f7c5f1c78
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/capital_of_division_item.md
@@ -0,0 +1,14 @@
+# CapitalOfDivisionItem
+
+A division of which the owning division is the capital, together with its subtype.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `division_id` | [`Id`](../../system/ref/id.md) | ID of the division whose capital is the current division.<br/><br/>*References [`Division`](../division.md) (hierarchy, capital of)* |
+| `subtype` | [`DivisionSubtype`](division_subtype.md) | |
+
+## Used By
+
+- [`Division`](../division.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/division_class.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/division_class.md
new file mode 100644
index 000000000..f7cac4560
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/division_class.md
@@ -0,0 +1,20 @@
+# DivisionClass
+
+Further classification of a division that is more specific than its `subtype`.
+
+A division's `class` adds detail to the broad classification found in `DivisionSubtype`.
+
+## Values
+
+- `megacity` - A very large city or metropolitan area, typically having a population of 10 million or
+more. Example: Tokyo, Japan.
+- `city` - A large, permanent human settlement. Example: Guadalajara, Mexico.
+- `town` - A medium-sized permanent human settlement that is smaller than a city, but larger than a
+village. Example: Walldürn, Germany.
+- `village` - A smallish permanent human settlement that is smaller than a town, but larger than a
+hamlet. Example: Wadi El Karm, Lebanon.
+- `hamlet` - A very small, isolated human settlement in a rural area. Example: Tjarnabyggð, Iceland.
+
+## Used By
+
+- [`Division`](../division.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/division_subtype.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/division_subtype.md
new file mode 100644
index 000000000..ad061cd7e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/division_subtype.md
@@ -0,0 +1,35 @@
+# DivisionSubtype
+
+Category of the division from a finite, hierarchical, ordered list of categories (e.g., country,
+region, locality, etc.) similar to a Who's on First placetype.
+
+## Values
+
+- `country` - Largest unit of independent sovereignty, e.g., the United States, France.
+- `dependency` - A place that is not exactly a sub-region of a country but is dependent on a parent
+country for defence, passport control, etc., e.g., Puerto Rico.
+- `macroregion` - A bundle of regions, e.g., England, Scotland, Île-de-France. These exist mainly in
+Europe.
+- `region` - A state, province, region, etc. Largest sub-country administrative unit in most
+countries, except those that have dependencies or macro-regions.
+- `macrocounty` - A bundle of counties, e.g. Inverness. These exist mainly in Europe.
+- `county` - Largest sub-region administrative unit in most countries, unless they have
+macrocounties.
+- `localadmin` - An administrative unit existing in some parts of the world that contains localities
+or populated places, e.g. département de Paris. Often the contained places do not
+have independent authority. Often, but not exclusively, found in Europe.
+- `locality` - A populated place that may or may not have its own administrative authority.
+- `borough` - A local government unit subordinate to a locality.
+- `macrohood` - A super-neighborhood that contains smaller divisions of type neighborhood, e.g.
+BoCaCa (Boerum Hill, Cobble Hill, and Carroll Gardens).
+- `neighborhood` - A neighborhood. Most neighborhoods will be just this, unless there's enough granular
+detail to justify introducing macrohood or microhood divisions.
+- `microhood` - A mini-neighborhood that is contained within a division of type neighborhood.
+
+## Used By
+
+- [`CapitalOfDivisionItem`](capital_of_division_item.md)
+- [`Division`](../division.md)
+- [`DivisionArea`](../division_area.md)
+- [`DivisionBoundary`](../division_boundary.md)
+- [`HierarchyItem`](hierarchy_item.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/hierarchy.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/hierarchy.md
new file mode 100644
index 000000000..22098138b
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/hierarchy.md
@@ -0,0 +1,21 @@
+# Hierarchy
+
+A hierarchy of divisions, with the first entry being a country; each subsequent
+entry, if any, being a division that is a direct child of the previous entry; and
+the last entry representing the division that contains the hierarchy.
+
+For example, a hierarchy for the United States is simply [United States]. A
+hierarchy for the U.S. state of New Hampshire would be
+[United States, New Hampshire], and a hierarchy for the city of Concord, NH would be
+[United States, New Hampshire, Merrimack County, Concord].
+
+Underlying type: `list<`[`HierarchyItem`](hierarchy_item.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Division`](../division.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/hierarchy_item.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/hierarchy_item.md
new file mode 100644
index 000000000..ffcf3aa94
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/hierarchy_item.md
@@ -0,0 +1,16 @@
+# HierarchyItem
+
+One division in a hierarchy.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `division_id` | [`Id`](../../system/ref/id.md) | ID of a division that is an ancestor of the current division.<br/><br/>In the context of division hierarchies, the ancestor divisions of a division include the division itself, and any other division that is an ancestor of the division's parent.<br/><br/>*References [`Division`](../division.md) (hierarchy, descendant of)* |
+| `subtype` | [`DivisionSubtype`](division_subtype.md) | |
+| `name` | [`StrippedString`](../../system/stripped_string.md) | Primary name of the division<br/><br/>*Minimum length: 1* |
+
+## Used By
+
+- [`Division`](../division.md)
+- [`Hierarchy`](hierarchy.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/norms.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/norms.md
new file mode 100644
index 000000000..be619f59c
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/norms.md
@@ -0,0 +1,13 @@
+# Norms
+
+Local norms and standards.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `driving_side` | [`Side`](../../common/scoping/side.md) (optional) | Side of the road on which vehicles drive in the division. |
+
+## Used By
+
+- [`Division`](../division.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/places/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/places/_category_.json
new file mode 100644
index 000000000..69d3715d6
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/places/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Places",
+  "position": 5
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/places/place.md b/schema_versioned_docs/version-v1.17.0/reference/places/place.md
new file mode 100644
index 000000000..25911a72a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/places/place.md
@@ -0,0 +1,115 @@
+---
+sidebar_position: 1
+---
+
+# Place
+
+Places are point representations of real-world facilities, businesses, services, or amenities.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Position of the place. Places are point geometries.<br/><br/>*Allowed geometry types: Point* |
+| `theme` | `"places"` | |
+| `type` | `"place"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `operating_status` | [`OperatingStatus`](types/operating_status.md) (optional) | An indication of whether a place is: in continued operation, in a temporary operating hiatus, or closed permanently.<br/><br/>This is not an indication of opening hours or that the place is open/closed at the current time-of-day or day-of-week.<br/><br/>When `operating_status` is `"permanently_closed"`, the `confidence` field will be set to 0. |
+| `categories` | [`Categories`](types/categories.md) (optional) | |
+| `categories.primary` | [`SnakeCaseString`](../system/snake_case_string.md) | The primary or main category of the place. |
+| `categories.alternate` | `list<`[`SnakeCaseString`](../system/snake_case_string.md)`>` (optional) | Alternate categories of the place.<br/><br/>Some places might fit into two categories, e.g., a book store and a coffee shop. In these cases, the primary category can be augmented with additional categories. |
+| `basic_category` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The basic level category of a place.<br/><br/>This field classifies places into categories at a level that most people find intuitive. The full list of possible values it may hold can be found at (TODO).<br/><br/>The basic level category, or simply basic category, is based on a cognitive science model use in taxonomy and ontology development. The idea is to provide the category name at the level of generality that is preferred by humans in learning and memory tasks. This category to be roughly in the middle of the general-to-specific category hierarchy.<br/><br/>The full list of basic level categories is available at https://docs.overturemaps.org/guides/places/ |
+| `taxonomy` | [`Taxonomy`](types/taxonomy.md) (optional) | A structured representation of the place's category within the Overture taxonomy.<br/><br/>Provides the primary classification, full hierarchy path, and alternate categories. |
+| `taxonomy.primary` | [`SnakeCaseString`](../system/snake_case_string.md) | The primary, or most specific, category known about this place.<br/><br/>The `primary` category value must always equal the last or rightmost entry in the `hierarchy` field. |
+| `taxonomy.hierarchy` | `list<`[`SnakeCaseString`](../system/snake_case_string.md)`>` | The full primary hierarchy of categories known for this place, ordered from most general to most specific. An example hierarchy might be: `["food_and_drink", "restaurant", "casual_eatery", "gas_station_sushi"]`.<br/><br/>The rightmost, or most specific, value in the `hierarchy` must always be equal to the `primary` field. The basic level category of the place will typically be found in the middle of the primary hierarchy. The primary hierarchy does not include any of the alternate categories found in the `alternates` field. |
+| `taxonomy.alternates` | `list<`[`SnakeCaseString`](../system/snake_case_string.md)`>` (optional) | Unordered list of additional categories that are known for this place but that are not part of the primary category hierarchy.<br/><br/>Alternate categories allow a more complete picture of the place to be surfaced when it fits multiple unconnected branches in the taxonomy. For example a gas station that also sells groceries might have primary category of "gas_station" with an alternate of "grocery_store".<br/><br/>Alternate categories are not part of the primary hierarchy or another alternate category's hierarchy. In other words, if a category is a parent in the hierarchy of another category, that category can't be a primary or alternate category itself.<br/><br/>Note as well that this field is an unordered list of extra categories and does not represent a hierarchy. |
+| `confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | A score between 0 and 1 indicating how confident we are that the place exists.<br/><br/>A confidence score of 0 indicates that we are certain the place doesn't exist anymore and will always be paired with an `operating_status` of `"permanently_closed"`.<br/><br/>A confidence score of 1 indicates that we are certain the place does exist.<br/><br/>If there is no value for confidence, it means we don't have enough information on which to estimate our confidence level. |
+| `websites` | `list<`[`HttpUrl`](../pydantic/networks/http_url.md)`>` (optional) | The websites of the place.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `socials` | `list<`[`HttpUrl`](../pydantic/networks/http_url.md)`>` (optional) | The social media URLs of the place.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `emails` | `list<`[`EmailStr`](../pydantic/networks/email_str.md)`>` (optional) | The email addresses of the place.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `phones` | `list<`[`PhoneNumber`](../system/phone_number.md)`>` (optional) | The phone numbers of the place.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `brand` | [`Brand`](types/brand.md) (optional) | The brand associated with the place. |
+| `brand.names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `brand.names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `brand.names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `brand.names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `brand.names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `brand.names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `brand.names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `brand.names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `brand.names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `brand.names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `brand.names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `brand.names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `brand.wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+| `addresses[]` | `list<`[`Address`](types/address.md)`>` (optional) | The address or addresses of the place<br/><br/>*Minimum length: 1* |
+| `addresses[].freeform` | `string` (optional) | Free-form address that contains street name, house number and other address info |
+| `addresses[].locality` | `string` (optional) | City, town, or neighborhood component of the place address |
+| `addresses[].postcode` | `string` (optional) | Postal code component of the place address |
+| `addresses[].region` | [`RegionCode`](../system/region_code.md) (optional) | An ISO 3166-2 principal subdivision code |
+| `addresses[].country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) (optional) | An ISO 3166-1 alpha-2 country code |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `99003ee6-e75b-4dd6-8a8a-53a5a716c50d` |
+| `bbox.xmin` | `-150.46875` |
+| `bbox.ymin` | `-79.17134094238281` |
+| `bbox.xmax` | `-150.46875` |
+| `bbox.ymax` | `-79.17133331298828` |
+| `geometry` | `POINT (-150.46875 -79.1713346)` |
+| `theme` | `places` |
+| `type` | `place` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `meta` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `107663894904826` |
+| `sources[0].update_time` | `2025-06-30T07:00:00+00:00` |
+| `sources[0].confidence` | `0.7337175792507205` |
+| `sources[0].between` | `null` |
+| `operating_status` | `open` |
+| `categories.primary` | `hotel` |
+| `categories.alternate` | `null` |
+| `basic_category` | `null` |
+| `taxonomy` | `null` |
+| `confidence` | `0.7337175792507205` |
+| `websites` | `["https://www.superhotel.co.jp/s_hotels/beppu/"]` |
+| `socials` | `["https://www.facebook.com/107663894904826"]` |
+| `emails` | `null` |
+| `phones` | `["+81977009000"]` |
+| `brand.names.primary` | `SUPER HOTEL` |
+| `brand.names.common` | `null` |
+| `brand.names.rules` | `null` |
+| `brand.wikidata` | `null` |
+| `addresses[0].freeform` | `秋田県横手市駅前町１３−８` |
+| `addresses[0].locality` | `横手市` |
+| `addresses[0].postcode` | `013-0036` |
+| `addresses[0].region` | `null` |
+| `addresses[0].country` | `JP` |
+| `names.primary` | `スーパーホテル別府駅前` |
+| `names.common` | `null` |
+| `names.rules` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/places/types/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/places/types/_category_.json
new file mode 100644
index 000000000..a3ec08974
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/places/types/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Types"
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/places/types/address.md b/schema_versioned_docs/version-v1.17.0/reference/places/types/address.md
new file mode 100644
index 000000000..b64d5be16
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/places/types/address.md
@@ -0,0 +1,17 @@
+# Address
+
+An address associated with a place.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `freeform` | `string` (optional) | Free-form address that contains street name, house number and other address info |
+| `locality` | `string` (optional) | City, town, or neighborhood component of the place address |
+| `postcode` | `string` (optional) | Postal code component of the place address |
+| `region` | [`RegionCode`](../../system/region_code.md) (optional) | An ISO 3166-2 principal subdivision code |
+| `country` | [`CountryCodeAlpha2`](../../system/country_code_alpha2.md) (optional) | An ISO 3166-1 alpha-2 country code |
+
+## Used By
+
+- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/places/types/brand.md b/schema_versioned_docs/version-v1.17.0/reference/places/types/brand.md
new file mode 100644
index 000000000..65ebf269d
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/places/types/brand.md
@@ -0,0 +1,27 @@
+# Brand
+
+A brand associated with a place.
+
+A location with multiple brands is modeled as multiple separate places, each with its own brand.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `names` | [`Names`](../../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `wikidata` | [`WikidataId`](../../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+
+## Used By
+
+- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/places/types/categories.md b/schema_versioned_docs/version-v1.17.0/reference/places/types/categories.md
new file mode 100644
index 000000000..fbb5a64d2
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/places/types/categories.md
@@ -0,0 +1,16 @@
+# Categories
+
+Categories a place belongs to.
+
+Complete list is available on GitHub: [https://github.com/OvertureMaps/schema/blob/main/docs/schema/concepts/by-theme/places/overture_categories.csv](https://github.com/OvertureMaps/schema/blob/main/docs/schema/concepts/by-theme/places/overture_categories.csv)
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `primary` | [`SnakeCaseString`](../../system/snake_case_string.md) | The primary or main category of the place. |
+| `alternate` | `list<`[`SnakeCaseString`](../../system/snake_case_string.md)`>` (optional) | Alternate categories of the place.<br/><br/>Some places might fit into two categories, e.g., a book store and a coffee shop. In these cases, the primary category can be augmented with additional categories.<br/><br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+
+## Used By
+
+- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/places/types/operating_status.md b/schema_versioned_docs/version-v1.17.0/reference/places/types/operating_status.md
new file mode 100644
index 000000000..61b17c7fe
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/places/types/operating_status.md
@@ -0,0 +1,19 @@
+# OperatingStatus
+
+General indication of whether a place is: in continued operation, in a temporary operating
+hiatus, or closed permanently.
+
+Operating status should not be confused with opening hours or operating hours. In particular,
+the status `"open"` does not mean the place is open *right now*, it means that in general the
+place is continuing to operate normally, as opposed to being in an operating hiatus
+(`"temporarily_closed"`) or shuttered (`"permanently_closed"`).
+
+## Values
+
+- `open`
+- `permanently_closed`
+- `temporarily_closed`
+
+## Used By
+
+- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/places/types/taxonomy.md b/schema_versioned_docs/version-v1.17.0/reference/places/types/taxonomy.md
new file mode 100644
index 000000000..33f5b4da9
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/places/types/taxonomy.md
@@ -0,0 +1,17 @@
+# Taxonomy
+
+A structured representation of the place's category within the Overture taxonomy.
+
+Provides the primary classification, full hierarchy path, and alternate categories.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `primary` | [`SnakeCaseString`](../../system/snake_case_string.md) | The primary, or most specific, category known about this place.<br/><br/>The `primary` category value must always equal the last or rightmost entry in the `hierarchy` field. |
+| `hierarchy` | `list<`[`SnakeCaseString`](../../system/snake_case_string.md)`>` | The full primary hierarchy of categories known for this place, ordered from most general to most specific. An example hierarchy might be: `["food_and_drink", "restaurant", "casual_eatery", "gas_station_sushi"]`.<br/><br/>The rightmost, or most specific, value in the `hierarchy` must always be equal to the `primary` field. The basic level category of the place will typically be found in the middle of the primary hierarchy. The primary hierarchy does not include any of the alternate categories found in the `alternates` field.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `alternates` | `list<`[`SnakeCaseString`](../../system/snake_case_string.md)`>` (optional) | Unordered list of additional categories that are known for this place but that are not part of the primary category hierarchy.<br/><br/>Alternate categories allow a more complete picture of the place to be surfaced when it fits multiple unconnected branches in the taxonomy. For example a gas station that also sells groceries might have primary category of "gas_station" with an alternate of "grocery_store".<br/><br/>Alternate categories are not part of the primary hierarchy or another alternate category's hierarchy. In other words, if a category is a parent in the hierarchy of another category, that category can't be a primary or alternate category itself.<br/><br/>Note as well that this field is an unordered list of extra categories and does not represent a hierarchy.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+
+## Used By
+
+- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/pydantic/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/pydantic/_category_.json
new file mode 100644
index 000000000..6bc65c372
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/pydantic/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Pydantic",
+  "position": 8
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/_category_.json
new file mode 100644
index 000000000..8dc67bc4c
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Networks"
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/email_str.md b/schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/email_str.md
new file mode 100644
index 000000000..3bf99260b
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/email_str.md
@@ -0,0 +1,7 @@
+# EmailStr
+
+See: [Pydantic docs](https://docs.pydantic.dev/latest/api/networks/#pydantic.networks.EmailStr)
+
+## Used By
+
+- [`Place`](../../places/place.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/http_url.md b/schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/http_url.md
new file mode 100644
index 000000000..b4b25f0ef
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/http_url.md
@@ -0,0 +1,9 @@
+# HttpUrl
+
+A type that will accept any http or https URL.
+
+See: [Pydantic docs](https://docs.pydantic.dev/latest/api/networks/#pydantic.networks.HttpUrl)
+
+## Used By
+
+- [`Place`](../../places/place.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/system/_category_.json
new file mode 100644
index 000000000..22378997a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/system/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "System",
+  "position": 9
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/country_code_alpha2.md b/schema_versioned_docs/version-v1.17.0/reference/system/country_code_alpha2.md
new file mode 100644
index 000000000..815aaacfa
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/system/country_code_alpha2.md
@@ -0,0 +1,18 @@
+# CountryCodeAlpha2
+
+An ISO-3166-1 alpha-2 country code.
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only ISO 3166-1 alpha-2 country codes. (`CountryCodeAlpha2Constraint`, pattern: `^[A-Z]{2}$`)
+
+## Used By
+
+- [`Address`](../addresses/address.md)
+- [`Address`](../places/types/address.md)
+- [`Division`](../divisions/division.md)
+- [`DivisionArea`](../divisions/division_area.md)
+- [`DivisionBoundary`](../divisions/division_boundary.md)
+- [`Perspectives`](../common/perspectives.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/hex_color.md b/schema_versioned_docs/version-v1.17.0/reference/system/hex_color.md
new file mode 100644
index 000000000..a22c9c1fb
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/system/hex_color.md
@@ -0,0 +1,20 @@
+# HexColor
+
+A color represented as an #RRGGBB or #RGB hexadecimal string.
+
+For example:
+
+- `"#ff0000"` or `#f00` for pure red 🟥
+- `"#ffa500"` for bright orange 🟧
+- `"#000000"` or `"#000"` for black ⬛
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only hexadecimal color codes (e.g., #FF0000 or #FFF). (`HexColorConstraint`, pattern: `^#[0-9A-Fa-f]{3}([0-9A-Fa-f]{3})?$`)
+
+## Used By
+
+- [`Building`](../buildings/building.md)
+- [`BuildingPart`](../buildings/building_part.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/json_pointer.md b/schema_versioned_docs/version-v1.17.0/reference/system/json_pointer.md
new file mode 100644
index 000000000..6363abdc1
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/system/json_pointer.md
@@ -0,0 +1,23 @@
+# JsonPointer
+
+A JSON Pointer
+
+As described in `the JSON Pointer specification, RFC-6901`_.
+
+.. _the JSON Pointer specification, RFC-6901: [https://rfc-editor.org/rfc/rfc6901.html](https://rfc-editor.org/rfc/rfc6901.html)
+
+For example:
+
+- `""` (root value)
+- `"/connectors/"`
+- `"/connectors/0/at"`
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only valid JSON Pointer values (RFC 6901). (`JsonPointerConstraint`)
+
+## Used By
+
+- [`SourceItem`](../common/source_item.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/language_tag.md b/schema_versioned_docs/version-v1.17.0/reference/system/language_tag.md
new file mode 100644
index 000000000..c3145671a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/system/language_tag.md
@@ -0,0 +1,27 @@
+# LanguageTag
+
+A BCP-47 language tag.
+
+As described in `Tags for Identifying Languages, BCP-47`_.
+
+.. _Tags for Identifying Languages, BCP-47: [https://www.rfc-editor.org/rfc/bcp/bcp47.txt](https://www.rfc-editor.org/rfc/bcp/bcp47.txt)
+
+For example:
+
+- `"en"`
+- `"en-US"`
+- `"fr-CA"`
+- `"zh-Hant-TW"`
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only `BCP-47`_ language tags. (`LanguageTagConstraint`, pattern: `^(?:(?:[A-Za-z]{2,3}(?:-[A-Za-z]{3}){0,3}?)|(?:[A-Za-z]{4,8}))(?:-[A-Za-z]{4})?(?:-[A-Za-z]{2}|[0-9]{3})?(?:-(?:[A-Za-z0-9]{5,8}|[0-9][A-Za-z0-9]{3}))*(?:-[A-WY-Za-wy-z0-9](?:-[A-Za-z0-9]{2,8})+)*$`)
+
+## Used By
+
+- [`Division`](../divisions/division.md)
+- [`NameRule`](../common/name_rule.md)
+- [`Names`](../common/names.md)
+- [`CommonNames`](../common/common_names.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/no_whitespace_string.md b/schema_versioned_docs/version-v1.17.0/reference/system/no_whitespace_string.md
new file mode 100644
index 000000000..ad2deca9b
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/system/no_whitespace_string.md
@@ -0,0 +1,13 @@
+# NoWhitespaceString
+
+A string that contains no whitespace characters.
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only strings that contain no whitespace characters. (`NoWhitespaceConstraint`, pattern: `^\S+$`)
+
+## Used By
+
+- [`Id`](ref/id.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/phone_number.md b/schema_versioned_docs/version-v1.17.0/reference/system/phone_number.md
new file mode 100644
index 000000000..8bfed0469
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/system/phone_number.md
@@ -0,0 +1,13 @@
+# PhoneNumber
+
+An international phone number.
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only international phone numbers. (`PhoneNumberConstraint`, pattern: `^\+\d{1,3}[\s\-\(\)0-9]+$`)
+
+## Used By
+
+- [`Place`](../places/place.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/primitive/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/system/primitive/_category_.json
new file mode 100644
index 000000000..ee6c4309a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/system/primitive/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Primitive"
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/primitive/geometry.md b/schema_versioned_docs/version-v1.17.0/reference/system/primitive/geometry.md
new file mode 100644
index 000000000..25d26fde7
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/system/primitive/geometry.md
@@ -0,0 +1,11 @@
+# Geometry Types
+
+Spatial types for representing geographic features.
+
+## Types
+
+| Type | Description |
+| -----: | ------------- |
+| `Geometry` | GeoJSON geometry value (Point, LineString, Polygon, etc.) |
+| `BBox` | Bounding box as 4 or 6 coordinate values: [west, south, east, north] or [west, south, min-altitude, east, north, max-altitude] |
+| `GeometryType` | Enumeration of geometry types: `geometry_collection`, `line_string`, `multi_line_string`, `multi_point`, `multi_polygon`, `point`, `polygon` |
\ No newline at end of file
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/primitive/primitives.md b/schema_versioned_docs/version-v1.17.0/reference/system/primitive/primitives.md
new file mode 100644
index 000000000..8b0415a7d
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/system/primitive/primitives.md
@@ -0,0 +1,27 @@
+# Primitive Types
+
+Numeric types used for schema field definitions.
+
+## Integer Types
+
+| Type | Range | Description |
+| -----: | :-----: | ------------- |
+| `int8` | -128 to 127 | Portable 8-bit signed integer. |
+| `int16` | -32,768 to 32,767 | Portable 16-bit signed integer. |
+| `int32` | -2,147,483,648 to 2,147,483,647 | Portable 32-bit signed integer. |
+| `int64` | -2^63 to 2^63-1 | Portable 64-bit signed integer. |
+
+## Unsigned Integer Types
+
+| Type | Range | Description |
+| -----: | :-----: | ------------- |
+| `uint8` | 0 to 255 | Portable 8-bit unsigned integer. |
+| `uint16` | 0 to 65,535 | Portable 16-bit unsigned integer. |
+| `uint32` | 0 to 4,294,967,295 | Portable 32-bit unsigned integer. |
+
+## Floating Point Types
+
+| Type | Precision | Description |
+| -----: | :---------: | ------------- |
+| `float32` | ~7 decimal digits | Portable IEEE 32-bit floating point number. |
+| `float64` | ~15 decimal digits | Portable IEEE 64-bit floating point number. |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/ref/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/system/ref/_category_.json
new file mode 100644
index 000000000..a3d90fc8f
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/system/ref/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Ref"
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/ref/id.md b/schema_versioned_docs/version-v1.17.0/reference/system/ref/id.md
new file mode 100644
index 000000000..59a1fc75a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/system/ref/id.md
@@ -0,0 +1,33 @@
+# Id
+
+A unique identifier.
+
+Underlying type: `string`
+
+## Constraints
+
+- Minimum length: 1
+- Allows only strings that contain no whitespace characters. (`NoWhitespaceConstraint`, pattern: `^\S+$`) (from [`NoWhitespaceString`](../no_whitespace_string.md))
+
+## Used By
+
+- [`Address`](../../addresses/address.md)
+- [`Bathymetry`](../../base/bathymetry.md)
+- [`Building`](../../buildings/building.md)
+- [`BuildingPart`](../../buildings/building_part.md)
+- [`CapitalOfDivisionItem`](../../divisions/types/capital_of_division_item.md)
+- [`Connector`](../../transportation/connector.md)
+- [`ConnectorReference`](../../transportation/types/connector_reference.md)
+- [`DestinationRule`](../../transportation/types/destination_rule.md)
+- [`Division`](../../divisions/division.md)
+- [`DivisionArea`](../../divisions/division_area.md)
+- [`DivisionBoundary`](../../divisions/division_boundary.md)
+- [`HierarchyItem`](../../divisions/types/hierarchy_item.md)
+- [`Infrastructure`](../../base/infrastructure.md)
+- [`Land`](../../base/land.md)
+- [`LandCover`](../../base/land_cover.md)
+- [`LandUse`](../../base/land_use.md)
+- [`Place`](../../places/place.md)
+- [`Segment`](../../transportation/segment.md)
+- [`SequenceEntry`](../../transportation/types/sequence_entry.md)
+- [`Water`](../../base/water.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/region_code.md b/schema_versioned_docs/version-v1.17.0/reference/system/region_code.md
new file mode 100644
index 000000000..bf2f016ee
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/system/region_code.md
@@ -0,0 +1,16 @@
+# RegionCode
+
+An ISO 3166-2 principal subdivision code.
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only ISO 3166-2 principal subdivision codes. (`RegionCodeConstraint`, pattern: `^[A-Z]{2}-[A-Z0-9]{1,3}$`)
+
+## Used By
+
+- [`Address`](../places/types/address.md)
+- [`Division`](../divisions/division.md)
+- [`DivisionArea`](../divisions/division_area.md)
+- [`DivisionBoundary`](../divisions/division_boundary.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/snake_case_string.md b/schema_versioned_docs/version-v1.17.0/reference/system/snake_case_string.md
new file mode 100644
index 000000000..de08e7608
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/system/snake_case_string.md
@@ -0,0 +1,15 @@
+# SnakeCaseString
+
+A string that looks like a snake case identifier, like a Python variable name (*e.g.*, `foo_bar`).
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only strings that look like snake case identifiers, *e.g.* `"foo_bar"`. (`SnakeCaseConstraint`, pattern: `^[a-z0-9]+(_[a-z0-9]+)*$`)
+
+## Used By
+
+- [`Categories`](../places/types/categories.md)
+- [`Place`](../places/place.md)
+- [`Taxonomy`](../places/types/taxonomy.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/stripped_string.md b/schema_versioned_docs/version-v1.17.0/reference/system/stripped_string.md
new file mode 100644
index 000000000..5600ca2d7
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/system/stripped_string.md
@@ -0,0 +1,22 @@
+# StrippedString
+
+A string without leading or trailing whitespace.
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only strings that have no leading/trailing whitespace. (`StrippedConstraint`, pattern: `^(\S(.*\S)?)?\Z`)
+
+## Used By
+
+- [`Address`](../addresses/address.md)
+- [`AddressLevel`](../addresses/types/address_level.md)
+- [`DestinationLabels`](../transportation/types/destination_labels.md)
+- [`Division`](../divisions/division.md)
+- [`HierarchyItem`](../divisions/types/hierarchy_item.md)
+- [`NameRule`](../common/name_rule.md)
+- [`Names`](../common/names.md)
+- [`RouteReference`](../transportation/types/route_reference.md)
+- [`SourceItem`](../common/source_item.md)
+- [`CommonNames`](../common/common_names.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/wikidata_id.md b/schema_versioned_docs/version-v1.17.0/reference/system/wikidata_id.md
new file mode 100644
index 000000000..ebef7cee6
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/system/wikidata_id.md
@@ -0,0 +1,23 @@
+# WikidataId
+
+A wikidata ID, as found on [https://www.wikidata.org/](https://www.wikidata.org/).
+
+- `"Q42"`
+- `"Q11643"`
+- `"Q116257497"`
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only Wikidata identifiers (Q followed by digits). (`WikidataIdConstraint`, pattern: `^Q\d+$`)
+
+## Used By
+
+- [`Brand`](../places/types/brand.md)
+- [`Division`](../divisions/division.md)
+- [`Infrastructure`](../base/infrastructure.md)
+- [`Land`](../base/land.md)
+- [`LandUse`](../base/land_use.md)
+- [`RouteReference`](../transportation/types/route_reference.md)
+- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/transportation/_category_.json
new file mode 100644
index 000000000..597025adb
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Transportation",
+  "position": 6
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/connector.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/connector.md
new file mode 100644
index 000000000..206899f2e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/connector.md
@@ -0,0 +1,49 @@
+---
+sidebar_position: 1
+---
+
+# Connector
+
+Connectors create physical connections between segments.
+
+Connectors are compatible with GeoJSON Point features.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Position of the connector<br/><br/>*Allowed geometry types: Point* |
+| `theme` | `"transportation"` | |
+| `type` | `"connector"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `39542bee-230f-4b91-b7e5-a9b58e0c59b1` |
+| `bbox.xmin` | `-176.54730224609375` |
+| `bbox.ymin` | `-43.96794891357422` |
+| `bbox.xmax` | `-176.54727172851562` |
+| `bbox.ymax` | `-43.96794128417969` |
+| `geometry` | `POINT (-176.5472979 -43.9679472)` |
+| `theme` | `transportation` |
+| `type` | `connector` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `null` |
+| `sources[0].update_time` | `null` |
+| `sources[0].confidence` | `null` |
+| `sources[0].between` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/segment.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/segment.md
new file mode 100644
index 000000000..1db0d2c4a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/segment.md
@@ -0,0 +1,168 @@
+---
+sidebar_position: 1
+---
+
+# Segment
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Segment centerline<br/><br/>*Allowed geometry types: LineString* |
+| `theme` | `"transportation"` | |
+| `type` | `"segment"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `subtype` | [`Subtype`](types/subtype.md) | Broad category of transportation segment. |
+| `access_restrictions[]` | [`AccessRules`](types/access_rules.md) (list, optional) | Rules governing access to this road segment |
+| `access_restrictions[].access_type` | [`AccessType`](types/access_type.md) | |
+| `access_restrictions[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing AccessRestrictionRule applies to. |
+| `access_restrictions[].when` | [`AccessRestrictionRule.When`](types/access_restriction_rule.when.md) (optional) | Scopes for AccessRestrictionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
+| `access_restrictions[].when.heading` | [`Heading`](../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing AccessRestrictionRule applies to. |
+| `access_restrictions[].when.during` | [`OpeningHours`](../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing AccessRestrictionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
+| `access_restrictions[].when.mode` | `list<`[`TravelMode`](../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing AccessRestrictionRule applies to. |
+| `access_restrictions[].when.using` | `list<`[`PurposeOfUse`](../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing AccessRestrictionRule applies to. |
+| `access_restrictions[].when.recognized` | `list<`[`RecognizedStatus`](../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing AccessRestrictionRule applies to. |
+| `access_restrictions[].when.vehicle` | [`VehicleAxleCountSelector`](../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing AccessRestrictionRule applies to. |
+| `connectors[]` | `list<`[`ConnectorReference`](types/connector_reference.md)`>` (optional) | List of connectors which this segment is physically connected to and their relative location. Each connector is a possible routing decision point, meaning it defines a place along the segment in which there is possibility to transition to other segments which share the same connector.<br/><br/>*Minimum length: 2*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `connectors[].connector_id` | [`Id`](../system/ref/id.md) | A unique identifier |
+| `connectors[].at` | [`LinearlyReferencedPosition`](../common/scoping/linearly_referenced_position.md) (optional) | The linearly-referenced position on the geometry, specified as a percentage displacement from the start of the geometry, that the containing ConnectorReference applies to. |
+| `level_rules[]` | [`LevelRules`](types/level_rules.md) (list, optional) | Defines the Z-order, i.e. stacking order, of the road segment. |
+| `level_rules[].value` | [`Level`](../common/level.md) | Z-order of the feature where 0 is visual level |
+| `level_rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing LevelRule applies to. |
+| `routes[]` | [`Routes`](types/routes.md) (list, optional) | Routes this segment belongs to |
+| `routes[].name` | [`StrippedString`](../system/stripped_string.md) (optional) | Full name of the route |
+| `routes[].network` | [`StrippedString`](../system/stripped_string.md) (optional) | Name of the highway system this route belongs to |
+| `routes[].ref` | [`StrippedString`](../system/stripped_string.md) (optional) | Code or number used to reference the route |
+| `routes[].symbol` | [`StrippedString`](../system/stripped_string.md) (optional) | URL or description of route signage |
+| `routes[].wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+| `routes[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RouteReference applies to. |
+| `subclass_rules[]` | [`SubclassRules`](types/subclass_rules.md) (list, optional) | Set of subclasses scoped along segment |
+| `subclass_rules[].value` | [`Subclass`](types/subclass.md) | |
+| `subclass_rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SubclassRule applies to. |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `class` *(Road)* | [`RoadClass`](types/road_class.md) | |
+| `destinations[]` *(Road)* | [`Destinations`](types/destinations.md) (list, optional) | Describes objects that can be reached by following a transportation segment in the same way those objects are described on signposts or ground writing that a traveller following the segment would observe in the real world. This allows navigation systems to refer to signs and observable writing that a traveller actually sees. |
+| `destinations[].from_connector_id` | [`Id`](../system/ref/id.md) | Identifies the point of physical connection on this segment before which the destination sign or marking is visible. |
+| `destinations[].to_connector_id` | [`Id`](../system/ref/id.md) | Identifies the point of physical connection on the segment identified by 'to_segment_id' to transition to for reaching the destination(s). |
+| `destinations[].to_segment_id` | [`Id`](../system/ref/id.md) | Identifies the segment to transition to reach the destination(s) labeled on the sign or marking. |
+| `destinations[].final_heading` | [`Heading`](../common/scoping/heading.md) | Direction of travel on the segment identified by 'to_segment_id' that leads to the destination. |
+| `destinations[].labels[]` | `list<`[`DestinationLabels`](types/destination_labels.md)`>` (optional) | Labeled destinations that can be reached by following the segment. |
+| `destinations[].labels[].value` | [`StrippedString`](../system/stripped_string.md) | Names the object that is reached |
+| `destinations[].labels[].type` | [`DestinationLabelType`](types/destination_label_type.md) | |
+| `destinations[].symbols` | `list<`[`DestinationSignSymbol`](types/destination_sign_symbol.md)`>` (optional) | A collection of symbols or icons present on the sign next to current destination label. |
+| `destinations[].when` | [`DestinationRule.When`](types/destination_rule.when.md) (optional) | Scope for DestinationRule: |
+| `destinations[].when.heading` | [`Heading`](../common/scoping/heading.md) | The heading, either forward or backward, that the containing DestinationRule applies to. |
+| `prohibited_transitions[]` *(Road)* | [`ProhibitedTransitions`](types/prohibited_transitions.md) (list, optional) | Rules preventing transitions from this segment to another segment. |
+| `prohibited_transitions[].sequence[]` | `list<`[`SequenceEntry`](types/sequence_entry.md)`>` | Ordered sequence of connector/segment pairs that it is prohibited to follow from this segment. |
+| `prohibited_transitions[].sequence[].connector_id` | [`Id`](../system/ref/id.md) | Identifies the point of physical connection between the previous segment in the sequence and the segment in this sequence entry. |
+| `prohibited_transitions[].sequence[].segment_id` | [`Id`](../system/ref/id.md) | Identifies the segment that the previous segment in the sequence is physically connected to via the sequence entry's connector. |
+| `prohibited_transitions[].final_heading` | [`Heading`](../common/scoping/heading.md) | Direction of travel that is prohibited on the destination segment of the sequence. |
+| `prohibited_transitions[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing ProhibitedTransitionRule applies to. |
+| `prohibited_transitions[].when` | [`ProhibitedTransitionRule.When`](types/prohibited_transition_rule.when.md) (optional) | Scopes for ProhibitedTransitionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
+| `prohibited_transitions[].when.heading` | [`Heading`](../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing ProhibitedTransitionRule applies to. |
+| `prohibited_transitions[].when.during` | [`OpeningHours`](../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing ProhibitedTransitionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
+| `prohibited_transitions[].when.mode` | `list<`[`TravelMode`](../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing ProhibitedTransitionRule applies to. |
+| `prohibited_transitions[].when.using` | `list<`[`PurposeOfUse`](../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing ProhibitedTransitionRule applies to. |
+| `prohibited_transitions[].when.recognized` | `list<`[`RecognizedStatus`](../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing ProhibitedTransitionRule applies to. |
+| `prohibited_transitions[].when.vehicle` | [`VehicleAxleCountSelector`](../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing ProhibitedTransitionRule applies to. |
+| `road_flags[]` *(Road)* | [`RoadFlags`](types/road_flags.md) (list, optional) | Set of boolean attributes applicable to roads. May be specified either as a single flag array of flag values, or as an array of flag rules. |
+| `road_flags[].values` | `list<`[`RoadFlag`](types/road_flag.md)`>` | |
+| `road_flags[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RoadFlagRule applies to. |
+| `road_surface[]` *(Road)* | [`Surfaces`](types/surfaces.md) (list, optional) | Physical surface of the road. May either be specified as a single global value for the segment, or as an array of surface rules. |
+| `road_surface[].value` | [`RoadSurface`](types/road_surface.md) | |
+| `road_surface[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SurfaceRule applies to. |
+| `speed_limits[]` *(Road)* | [`SpeedLimits`](types/speed_limits.md) (list, optional) | Rules governing speed on this road segment |
+| `speed_limits[].max_speed` | [`Speed`](types/speed.md) (optional) | |
+| `speed_limits[].max_speed.value` | [`SpeedValue`](types/speed_value.md) | Speed value |
+| `speed_limits[].max_speed.unit` | [`SpeedUnit`](../common/speed_unit.md) | |
+| `speed_limits[].min_speed` | [`Speed`](types/speed.md) (optional) | |
+| `speed_limits[].min_speed.value` | [`SpeedValue`](types/speed_value.md) | Speed value |
+| `speed_limits[].min_speed.unit` | [`SpeedUnit`](../common/speed_unit.md) | |
+| `speed_limits[].is_max_speed_variable` | `boolean` (optional) | Indicates a variable speed corridor |
+| `speed_limits[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SpeedLimitRule applies to. |
+| `speed_limits[].when` | [`SpeedLimitRule.When`](types/speed_limit_rule.when.md) (optional) | Scopes for SpeedLimitRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
+| `speed_limits[].when.heading` | [`Heading`](../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing SpeedLimitRule applies to. |
+| `speed_limits[].when.during` | [`OpeningHours`](../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing SpeedLimitRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
+| `speed_limits[].when.mode` | `list<`[`TravelMode`](../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing SpeedLimitRule applies to. |
+| `speed_limits[].when.using` | `list<`[`PurposeOfUse`](../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing SpeedLimitRule applies to. |
+| `speed_limits[].when.recognized` | `list<`[`RecognizedStatus`](../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing SpeedLimitRule applies to. |
+| `speed_limits[].when.vehicle` | [`VehicleAxleCountSelector`](../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing SpeedLimitRule applies to. |
+| `subclass` *(Road)* | [`Subclass`](types/subclass.md) (optional) | |
+| `width_rules[]` *(Road)* | [`WidthRules`](types/width_rules.md) (list, optional) | Edge-to-edge width of the road modeled by this segment, in meters.<br/><br/>Examples: (1) If this segment models a carriageway without sidewalk, this value represents the edge-to-edge width of the carriageway, inclusive of any shoulder. (2) If this segment models a sidewalk by itself, this value represents the edge-to-edge width of the sidewalk. (3) If this segment models a combined sidewalk and carriageway, this value represents the edge-to-edge width inclusive of sidewalk. |
+| `width_rules[].value` | [`Width`](types/width.md) | |
+| `width_rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing WidthRule applies to. |
+| `class` *(Rail)* | [`RailClass`](types/rail_class.md) | |
+| `rail_flags[]` *(Rail)* | [`RailFlags`](types/rail_flags.md) (list, optional) | Set of boolean attributes applicable to railways. May be specified either as a single flag array of flag values, or as an array of flag rules. |
+| `rail_flags[].values` | `list<`[`RailFlag`](types/rail_flag.md)`>` | |
+| `rail_flags[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RailFlagRule applies to. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `1bc62f3b-08b5-42b8-89fe-36f685f60455` |
+| `bbox.xmin` | `-176.5650177001953` |
+| `bbox.ymin` | `-43.954410552978516` |
+| `bbox.xmax` | `-176.56361389160156` |
+| `bbox.ymax` | `-43.953250885009766` |
+| `geometry` | `LINESTRING (-176.5636191 -43.954404, -176.5643637 -43.9538145, -176.5647264 -43.9535274, -176.564...` |
+| `theme` | `transportation` |
+| `type` | `segment` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `w53435546@6` |
+| `sources[0].update_time` | `2021-05-03T06:37:03+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].between` | `null` |
+| `subtype` | `road` |
+| `access_restrictions` | `null` |
+| `connectors[0].connector_id` | `15b2c131-9137-4add-88c6-2acd3fa61355` |
+| `connectors[0].at` | `0.0` |
+| `connectors[1].connector_id` | `23ae2702-ef77-4d2e-b39d-77360b696d20` |
+| `connectors[1].at` | `0.523536154` |
+| `connectors[2].connector_id` | `8e944ce1-4b81-49eb-a823-7d98779c855c` |
+| `connectors[2].at` | `1.0` |
+| `level_rules` | `null` |
+| `routes` | `null` |
+| `subclass_rules` | `null` |
+| `names.primary` | `Meteorological Lane` |
+| `names.common` | `null` |
+| `destinations` | `null` |
+| `prohibited_transitions` | `null` |
+| `road_flags` | `null` |
+| `road_surface[0].value` | `gravel` |
+| `road_surface[0].between` | `null` |
+| `speed_limits` | `null` |
+| `subclass` | `null` |
+| `width_rules` | `null` |
+| `class` | `residential` |
+| `rail_flags` | `null` |
+| `names.rules[0].value` | `Meteorological Lane` |
+| `names.rules[0].variant` | `common` |
+| `names.rules[0].language` | `null` |
+| `names.rules[0].perspectives` | `null` |
+| `names.rules[0].between` | `null` |
+| `names.rules[0].side` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/_category_.json
new file mode 100644
index 000000000..a3ec08974
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Types"
+}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_restriction_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_restriction_rule.md
new file mode 100644
index 000000000..8324d767c
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_restriction_rule.md
@@ -0,0 +1,20 @@
+# AccessRestrictionRule
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `access_type` | [`AccessType`](access_type.md) | |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing AccessRestrictionRule applies to. |
+| `when` | [`AccessRestrictionRule.When`](access_restriction_rule.when.md) (optional) | Scopes for AccessRestrictionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
+| `when.heading` | [`Heading`](../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing AccessRestrictionRule applies to. |
+| `when.during` | [`OpeningHours`](../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing AccessRestrictionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
+| `when.mode` | `list<`[`TravelMode`](../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing AccessRestrictionRule applies to. |
+| `when.using` | `list<`[`PurposeOfUse`](../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing AccessRestrictionRule applies to. |
+| `when.recognized` | `list<`[`RecognizedStatus`](../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing AccessRestrictionRule applies to. |
+| `when.vehicle` | [`VehicleAxleCountSelector`](../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing AccessRestrictionRule applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`AccessRules`](access_rules.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_restriction_rule.when.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_restriction_rule.when.md
new file mode 100644
index 000000000..780d8ef3e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_restriction_rule.when.md
@@ -0,0 +1,22 @@
+# AccessRestrictionRule.When
+
+Scopes for AccessRestrictionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `heading` | [`Heading`](../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing AccessRestrictionRule applies to.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `during` | [`OpeningHours`](../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing AccessRestrictionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `mode` | `list<`[`TravelMode`](../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing AccessRestrictionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `using` | `list<`[`PurposeOfUse`](../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing AccessRestrictionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `recognized` | `list<`[`RecognizedStatus`](../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing AccessRestrictionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `vehicle` | [`VehicleAxleCountSelector`](../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing AccessRestrictionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+
+## Constraints
+
+- At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set
+
+## Used By
+
+- [`AccessRestrictionRule`](access_restriction_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_rules.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_rules.md
new file mode 100644
index 000000000..1f3341a71
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_rules.md
@@ -0,0 +1,14 @@
+# AccessRules
+
+Rules governing access to this road segment
+
+Underlying type: `list<`[`AccessRestrictionRule`](access_restriction_rule.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_type.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_type.md
new file mode 100644
index 000000000..e77c8ab8a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_type.md
@@ -0,0 +1,11 @@
+# AccessType
+
+## Values
+
+- `allowed`
+- `denied`
+- `designated`
+
+## Used By
+
+- [`AccessRestrictionRule`](access_restriction_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/connector_reference.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/connector_reference.md
new file mode 100644
index 000000000..632eed33a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/connector_reference.md
@@ -0,0 +1,15 @@
+# ConnectorReference
+
+Contains the GERS ID and relative position between 0 and 1 of a connector feature along the
+segment.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `connector_id` | [`Id`](../../system/ref/id.md) | A unique identifier<br/><br/>*References [`Connector`](../connector.md) (association, connects to)* |
+| `at` | [`LinearlyReferencedPosition`](../../common/scoping/linearly_referenced_position.md) (optional) | The linearly-referenced position on the geometry, specified as a percentage displacement from the start of the geometry, that the containing ConnectorReference applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_label_type.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_label_type.md
new file mode 100644
index 000000000..cf2ccb11f
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_label_type.md
@@ -0,0 +1,16 @@
+# DestinationLabelType
+
+Indicates what special symbol/icon is present on a signpost, visible as road marking or
+similar.
+
+## Values
+
+- `street`
+- `country`
+- `route_ref`
+- `toward_route_ref`
+- `unknown`
+
+## Used By
+
+- [`DestinationLabels`](destination_labels.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_labels.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_labels.md
new file mode 100644
index 000000000..578aaaace
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_labels.md
@@ -0,0 +1,14 @@
+# DestinationLabels
+
+The type of object of the destination label.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`StrippedString`](../../system/stripped_string.md) | Names the object that is reached<br/><br/>*Minimum length: 1* |
+| `type` | [`DestinationLabelType`](destination_label_type.md) | |
+
+## Used By
+
+- [`DestinationRule`](destination_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_rule.md
new file mode 100644
index 000000000..2c340c56e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_rule.md
@@ -0,0 +1,25 @@
+# DestinationRule
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `from_connector_id` | [`Id`](../../system/ref/id.md) | Identifies the point of physical connection on this segment before which the destination sign or marking is visible. |
+| `to_connector_id` | [`Id`](../../system/ref/id.md) | Identifies the point of physical connection on the segment identified by 'to_segment_id' to transition to for reaching the destination(s). |
+| `to_segment_id` | [`Id`](../../system/ref/id.md) | Identifies the segment to transition to reach the destination(s) labeled on the sign or marking. |
+| `final_heading` | [`Heading`](../../common/scoping/heading.md) | Direction of travel on the segment identified by 'to_segment_id' that leads to the destination. |
+| `labels[]` | `list<`[`DestinationLabels`](destination_labels.md)`>` (optional) | Labeled destinations that can be reached by following the segment.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `labels`, `symbols` must be set* |
+| `labels[].value` | [`StrippedString`](../../system/stripped_string.md) | Names the object that is reached |
+| `labels[].type` | [`DestinationLabelType`](destination_label_type.md) | |
+| `symbols` | `list<`[`DestinationSignSymbol`](destination_sign_symbol.md)`>` (optional) | A collection of symbols or icons present on the sign next to current destination label.<br/><br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `labels`, `symbols` must be set* |
+| `when` | [`DestinationRule.When`](destination_rule.when.md) (optional) | Scope for DestinationRule: |
+| `when.heading` | [`Heading`](../../common/scoping/heading.md) | The heading, either forward or backward, that the containing DestinationRule applies to. |
+
+## Constraints
+
+- At least one of `labels`, `symbols` must be set
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`Destinations`](destinations.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_rule.when.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_rule.when.md
new file mode 100644
index 000000000..0d48f31f3
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_rule.when.md
@@ -0,0 +1,13 @@
+# DestinationRule.When
+
+Scope for DestinationRule: 
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `heading` | [`Heading`](../../common/scoping/heading.md) | The heading, either forward or backward, that the containing DestinationRule applies to. |
+
+## Used By
+
+- [`DestinationRule`](destination_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_sign_symbol.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_sign_symbol.md
new file mode 100644
index 000000000..ec81dbe19
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_sign_symbol.md
@@ -0,0 +1,31 @@
+# DestinationSignSymbol
+
+Indicates what special symbol/icon is present on a signpost, visible as road marking or
+similar.
+
+## Values
+
+- `motorway`
+- `airport`
+- `hospital`
+- `center`
+- `industrial`
+- `parking`
+- `bus`
+- `train_station`
+- `rest_area`
+- `ferry`
+- `motorroad`
+- `fuel`
+- `viewpoint`
+- `fuel_diesel`
+- `food`
+- `lodging`
+- `info`
+- `camp_site`
+- `interchange`
+- `restrooms`
+
+## Used By
+
+- [`DestinationRule`](destination_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destinations.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destinations.md
new file mode 100644
index 000000000..d2c434eb6
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destinations.md
@@ -0,0 +1,9 @@
+# Destinations
+
+Describes objects that can be reached by following a transportation segment in the same way those objects are described on signposts or ground writing that a traveller following the segment would observe in the real world. This allows navigation systems to refer to signs and observable writing that a traveller actually sees.
+
+Underlying type: `list<`[`DestinationRule`](destination_rule.md)`>`
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/level_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/level_rule.md
new file mode 100644
index 000000000..1612c0b2e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/level_rule.md
@@ -0,0 +1,16 @@
+# LevelRule
+
+A single level rule defining the Z-order, i.e. stacking order, applicable within a given scope
+on the road segment.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`Level`](../../common/level.md) | Z-order of the feature where 0 is visual level |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing LevelRule applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`LevelRules`](level_rules.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/level_rules.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/level_rules.md
new file mode 100644
index 000000000..f95284be6
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/level_rules.md
@@ -0,0 +1,9 @@
+# LevelRules
+
+Defines the Z-order, i.e. stacking order, of the road segment.
+
+Underlying type: `list<`[`LevelRule`](level_rule.md)`>`
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transition_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transition_rule.md
new file mode 100644
index 000000000..a78a45c03
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transition_rule.md
@@ -0,0 +1,23 @@
+# ProhibitedTransitionRule
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `sequence[]` | `list<`[`SequenceEntry`](sequence_entry.md)`>` | Ordered sequence of connector/segment pairs that it is prohibited to follow from this segment.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `sequence[].connector_id` | [`Id`](../../system/ref/id.md) | Identifies the point of physical connection between the previous segment in the sequence and the segment in this sequence entry. |
+| `sequence[].segment_id` | [`Id`](../../system/ref/id.md) | Identifies the segment that the previous segment in the sequence is physically connected to via the sequence entry's connector. |
+| `final_heading` | [`Heading`](../../common/scoping/heading.md) | Direction of travel that is prohibited on the destination segment of the sequence. |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing ProhibitedTransitionRule applies to. |
+| `when` | [`ProhibitedTransitionRule.When`](prohibited_transition_rule.when.md) (optional) | Scopes for ProhibitedTransitionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
+| `when.heading` | [`Heading`](../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing ProhibitedTransitionRule applies to. |
+| `when.during` | [`OpeningHours`](../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing ProhibitedTransitionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
+| `when.mode` | `list<`[`TravelMode`](../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing ProhibitedTransitionRule applies to. |
+| `when.using` | `list<`[`PurposeOfUse`](../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing ProhibitedTransitionRule applies to. |
+| `when.recognized` | `list<`[`RecognizedStatus`](../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing ProhibitedTransitionRule applies to. |
+| `when.vehicle` | [`VehicleAxleCountSelector`](../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing ProhibitedTransitionRule applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`ProhibitedTransitions`](prohibited_transitions.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transition_rule.when.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transition_rule.when.md
new file mode 100644
index 000000000..1c38a5d60
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transition_rule.when.md
@@ -0,0 +1,22 @@
+# ProhibitedTransitionRule.When
+
+Scopes for ProhibitedTransitionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `heading` | [`Heading`](../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing ProhibitedTransitionRule applies to.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `during` | [`OpeningHours`](../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing ProhibitedTransitionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `mode` | `list<`[`TravelMode`](../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing ProhibitedTransitionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `using` | `list<`[`PurposeOfUse`](../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing ProhibitedTransitionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `recognized` | `list<`[`RecognizedStatus`](../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing ProhibitedTransitionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `vehicle` | [`VehicleAxleCountSelector`](../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing ProhibitedTransitionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+
+## Constraints
+
+- At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set
+
+## Used By
+
+- [`ProhibitedTransitionRule`](prohibited_transition_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transitions.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transitions.md
new file mode 100644
index 000000000..2a4a5179e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transitions.md
@@ -0,0 +1,9 @@
+# ProhibitedTransitions
+
+Rules preventing transitions from this segment to another segment.
+
+Underlying type: `list<`[`ProhibitedTransitionRule`](prohibited_transition_rule.md)`>`
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_class.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_class.md
new file mode 100644
index 000000000..c43bb6a6a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_class.md
@@ -0,0 +1,18 @@
+# RailClass
+
+Captures the kind of rail segment.
+
+## Values
+
+- `funicular`
+- `light_rail`
+- `monorail`
+- `narrow_gauge`
+- `standard_gauge`
+- `subway`
+- `tram`
+- `unknown`
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flag.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flag.md
new file mode 100644
index 000000000..9316a8129
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flag.md
@@ -0,0 +1,20 @@
+# RailFlag
+
+Simple flags that can be on or off for a railway segment.
+
+Specifies physical characteristics and can overlap.
+
+## Values
+
+- `is_bridge`
+- `is_tunnel`
+- `is_under_construction`
+- `is_abandoned`
+- `is_covered`
+- `is_passenger`
+- `is_freight`
+- `is_disused`
+
+## Used By
+
+- [`RailFlagRule`](rail_flag_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flag_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flag_rule.md
new file mode 100644
index 000000000..52273bde4
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flag_rule.md
@@ -0,0 +1,15 @@
+# RailFlagRule
+
+Rail-specific flag rule with geometric scoping only.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `values` | `list<`[`RailFlag`](rail_flag.md)`>` | *Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RailFlagRule applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`RailFlags`](rail_flags.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flags.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flags.md
new file mode 100644
index 000000000..806331852
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flags.md
@@ -0,0 +1,14 @@
+# RailFlags
+
+Set of boolean attributes applicable to railways. May be specified either as a single flag array of flag values, or as an array of flag rules.
+
+Underlying type: `list<`[`RailFlagRule`](rail_flag_rule.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_class.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_class.md
new file mode 100644
index 000000000..d18b7735a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_class.md
@@ -0,0 +1,27 @@
+# RoadClass
+
+Captures the kind of road and its position in the road network hierarchy.
+
+## Values
+
+- `motorway`
+- `primary`
+- `secondary`
+- `tertiary`
+- `residential`
+- `living_street`
+- `trunk`
+- `unclassified`
+- `service`
+- `pedestrian`
+- `footway`
+- `steps`
+- `path`
+- `track`
+- `cycleway`
+- `bridleway`
+- `unknown`
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flag.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flag.md
new file mode 100644
index 000000000..a2448e725
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flag.md
@@ -0,0 +1,19 @@
+# RoadFlag
+
+Simple flags that can be on or off for a road segment.
+
+Specifies physical characteristics and can overlap.
+
+## Values
+
+- `is_bridge`
+- `is_link`
+- `is_tunnel`
+- `is_under_construction`
+- `is_abandoned`
+- `is_covered`
+- `is_indoor`
+
+## Used By
+
+- [`RoadFlagRule`](road_flag_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flag_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flag_rule.md
new file mode 100644
index 000000000..4ff3120c9
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flag_rule.md
@@ -0,0 +1,15 @@
+# RoadFlagRule
+
+Road-specific flag rule with geometric scoping only.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `values` | `list<`[`RoadFlag`](road_flag.md)`>` | *Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RoadFlagRule applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`RoadFlags`](road_flags.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flags.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flags.md
new file mode 100644
index 000000000..88445c57d
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flags.md
@@ -0,0 +1,14 @@
+# RoadFlags
+
+Set of boolean attributes applicable to roads. May be specified either as a single flag array of flag values, or as an array of flag rules.
+
+Underlying type: `list<`[`RoadFlagRule`](road_flag_rule.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_surface.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_surface.md
new file mode 100644
index 000000000..6ac837769
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_surface.md
@@ -0,0 +1,17 @@
+# RoadSurface
+
+Physical surface of the road.
+
+## Values
+
+- `unknown`
+- `paved`
+- `unpaved`
+- `gravel`
+- `dirt`
+- `paving_stones`
+- `metal`
+
+## Used By
+
+- [`SurfaceRule`](surface_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/route_reference.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/route_reference.md
new file mode 100644
index 000000000..4433bcf41
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/route_reference.md
@@ -0,0 +1,19 @@
+# RouteReference
+
+Route reference with linear referencing support.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `name` | [`StrippedString`](../../system/stripped_string.md) (optional) | Full name of the route<br/><br/>*Minimum length: 1* |
+| `network` | [`StrippedString`](../../system/stripped_string.md) (optional) | Name of the highway system this route belongs to<br/><br/>*Minimum length: 1* |
+| `ref` | [`StrippedString`](../../system/stripped_string.md) (optional) | Code or number used to reference the route<br/><br/>*Minimum length: 1* |
+| `symbol` | [`StrippedString`](../../system/stripped_string.md) (optional) | URL or description of route signage<br/><br/>*Minimum length: 1* |
+| `wikidata` | [`WikidataId`](../../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RouteReference applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`Routes`](routes.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/routes.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/routes.md
new file mode 100644
index 000000000..72143b256
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/routes.md
@@ -0,0 +1,9 @@
+# Routes
+
+Routes this segment belongs to
+
+Underlying type: `list<`[`RouteReference`](route_reference.md)`>`
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/sequence_entry.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/sequence_entry.md
new file mode 100644
index 000000000..859b96c5c
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/sequence_entry.md
@@ -0,0 +1,14 @@
+# SequenceEntry
+
+A segment/connector pair in a prohibited transition sequence.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `connector_id` | [`Id`](../../system/ref/id.md) | Identifies the point of physical connection between the previous segment in the sequence and the segment in this sequence entry. |
+| `segment_id` | [`Id`](../../system/ref/id.md) | Identifies the segment that the previous segment in the sequence is physically connected to via the sequence entry's connector. |
+
+## Used By
+
+- [`ProhibitedTransitionRule`](prohibited_transition_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed.md
new file mode 100644
index 000000000..728a27352
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed.md
@@ -0,0 +1,14 @@
+# Speed
+
+A speed value, i.e. a certain number of distance units travelled per unit time.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`SpeedValue`](speed_value.md) | Speed value |
+| `unit` | [`SpeedUnit`](../../common/speed_unit.md) | |
+
+## Used By
+
+- [`SpeedLimitRule`](speed_limit_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limit_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limit_rule.md
new file mode 100644
index 000000000..ed02b113e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limit_rule.md
@@ -0,0 +1,32 @@
+# SpeedLimitRule
+
+An individual speed limit rule.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `max_speed` | [`Speed`](speed.md) (optional) | *At least one of `max_speed`, `min_speed` must be set* |
+| `max_speed.value` | [`SpeedValue`](speed_value.md) | Speed value |
+| `max_speed.unit` | [`SpeedUnit`](../../common/speed_unit.md) | |
+| `min_speed` | [`Speed`](speed.md) (optional) | *At least one of `max_speed`, `min_speed` must be set* |
+| `min_speed.value` | [`SpeedValue`](speed_value.md) | Speed value |
+| `min_speed.unit` | [`SpeedUnit`](../../common/speed_unit.md) | |
+| `is_max_speed_variable` | `boolean` (optional) | Indicates a variable speed corridor<br/><br/>*`strict=True`* |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SpeedLimitRule applies to. |
+| `when` | [`SpeedLimitRule.When`](speed_limit_rule.when.md) (optional) | Scopes for SpeedLimitRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
+| `when.heading` | [`Heading`](../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing SpeedLimitRule applies to. |
+| `when.during` | [`OpeningHours`](../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing SpeedLimitRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
+| `when.mode` | `list<`[`TravelMode`](../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing SpeedLimitRule applies to. |
+| `when.using` | `list<`[`PurposeOfUse`](../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing SpeedLimitRule applies to. |
+| `when.recognized` | `list<`[`RecognizedStatus`](../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing SpeedLimitRule applies to. |
+| `when.vehicle` | [`VehicleAxleCountSelector`](../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing SpeedLimitRule applies to. |
+
+## Constraints
+
+- At least one of `max_speed`, `min_speed` must be set
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`SpeedLimits`](speed_limits.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limit_rule.when.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limit_rule.when.md
new file mode 100644
index 000000000..f9a4b0918
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limit_rule.when.md
@@ -0,0 +1,22 @@
+# SpeedLimitRule.When
+
+Scopes for SpeedLimitRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `heading` | [`Heading`](../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing SpeedLimitRule applies to.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `during` | [`OpeningHours`](../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing SpeedLimitRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `mode` | `list<`[`TravelMode`](../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing SpeedLimitRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `using` | `list<`[`PurposeOfUse`](../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing SpeedLimitRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `recognized` | `list<`[`RecognizedStatus`](../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing SpeedLimitRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `vehicle` | [`VehicleAxleCountSelector`](../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing SpeedLimitRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+
+## Constraints
+
+- At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set
+
+## Used By
+
+- [`SpeedLimitRule`](speed_limit_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limits.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limits.md
new file mode 100644
index 000000000..c42f47267
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limits.md
@@ -0,0 +1,14 @@
+# SpeedLimits
+
+Rules governing speed on this road segment
+
+Underlying type: `list<`[`SpeedLimitRule`](speed_limit_rule.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_value.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_value.md
new file mode 100644
index 000000000..8b4983f6b
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_value.md
@@ -0,0 +1,16 @@
+# SpeedValue
+
+Speed value
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 1`
+- `≤ 350`
+- `≥ -2147483648` (from [`int32`](../../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../../system/primitive/primitives.md))
+
+## Used By
+
+- [`Speed`](speed.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass.md
new file mode 100644
index 000000000..f91d5d42e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass.md
@@ -0,0 +1,18 @@
+# Subclass
+
+Refines expected usage of the segment, must not overlap.
+
+## Values
+
+- `link`
+- `sidewalk`
+- `crosswalk`
+- `parking_aisle`
+- `driveway`
+- `alley`
+- `cycle_crossing`
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`SubclassRule`](subclass_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass_rule.md
new file mode 100644
index 000000000..3b67cc1db
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass_rule.md
@@ -0,0 +1,15 @@
+# SubclassRule
+
+Set of subclasses scoped along segment.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`Subclass`](subclass.md) | |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SubclassRule applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`SubclassRules`](subclass_rules.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass_rules.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass_rules.md
new file mode 100644
index 000000000..a8322e9e1
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass_rules.md
@@ -0,0 +1,9 @@
+# SubclassRules
+
+Set of subclasses scoped along segment
+
+Underlying type: `list<`[`SubclassRule`](subclass_rule.md)`>`
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subtype.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subtype.md
new file mode 100644
index 000000000..e24c2f7e4
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subtype.md
@@ -0,0 +1,13 @@
+# Subtype
+
+Transportation segment subtype classification.
+
+## Values
+
+- `road`
+- `rail`
+- `water`
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/surface_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/surface_rule.md
new file mode 100644
index 000000000..2b4e12ed9
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/surface_rule.md
@@ -0,0 +1,13 @@
+# SurfaceRule
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`RoadSurface`](road_surface.md) | |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SurfaceRule applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`Surfaces`](surfaces.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/surfaces.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/surfaces.md
new file mode 100644
index 000000000..846f48828
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/surfaces.md
@@ -0,0 +1,14 @@
+# Surfaces
+
+Physical surface of the road. May either be specified as a single global value for the segment, or as an array of surface rules.
+
+Underlying type: `list<`[`SurfaceRule`](surface_rule.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/width.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/width.md
new file mode 100644
index 000000000..c7e6d5ec4
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/width.md
@@ -0,0 +1,11 @@
+# Width
+
+Underlying type: `float64`
+
+## Constraints
+
+- `> 0`
+
+## Used By
+
+- [`WidthRule`](width_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/width_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/width_rule.md
new file mode 100644
index 000000000..5b954eebe
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/width_rule.md
@@ -0,0 +1,13 @@
+# WidthRule
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`Width`](width.md) | |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing WidthRule applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`WidthRules`](width_rules.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/width_rules.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/width_rules.md
new file mode 100644
index 000000000..1c5cbf035
--- /dev/null
+++ b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/width_rules.md
@@ -0,0 +1,16 @@
+# WidthRules
+
+Edge-to-edge width of the road modeled by this segment, in meters.
+
+Examples: (1) If this segment models a carriageway without sidewalk, this value represents the edge-to-edge width of the carriageway, inclusive of any shoulder. (2) If this segment models a sidewalk by itself, this value represents the edge-to-edge width of the sidewalk. (3) If this segment models a combined sidewalk and carriageway, this value represents the edge-to-edge width inclusive of sidewalk.
+
+Underlying type: `list<`[`WidthRule`](width_rule.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.18.0/index.md b/schema_versioned_docs/version-v1.18.0/index.md
new file mode 100644
index 000000000..234c9dc12
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/index.md
@@ -0,0 +1,58 @@
+---
+id: index
+slug: /
+title: Schema Reference
+sidebar_label: Overview
+description: Pydantic schemas for Overture Maps data
+pagination_label: Schema Reference Overview
+---
+
+# Overture Maps Schema
+
+:::note
+This section has been recently updated to reflect changes in our schema modeling. We welcome your feedback in [GitHub Discussions](https://github.com/OvertureMaps/data/discussions).
+:::
+
+The Overture Maps schema defines the structure, properties, and constraints for all features across six themes: addresses, base, buildings, divisions, places, and transportation. The reference pages in this section document the theme-based and shared modules in the schema.
+
+The schema is authored as [Pydantic](https://docs.pydantic.dev/) models and the reference documentation is generated from those models. The source code lives in the [OvertureMaps/schema](https://github.com/OvertureMaps/schema) repository on GitHub.
+
+:::tip[Found an error on this page?]
+This page is generated from the Pydantic models in [OvertureMaps/schema](https://github.com/OvertureMaps/schema/issues). Please file an issue there for changes.
+:::
+
+## Why Use Pydantic to Define Data Schemas?
+
+This project addresses a fundamental challenge in data consumption: bridging the semantic gap between raw data and human understanding while enabling machine-actionable workflows.
+
+## Why Schema at All: Beyond Raw Data
+
+Take a column like `pop_2020`. Is it total population? Population density per square kilometer? Working-age population? Without a schema, you're left sampling values and guessing from column names.
+
+Compare this to OpenStreetMap's approach: features use well-known key-value pairs like `building=residential` or `addr:housenumber=42` that have semantic meaning and can be looked up on the OSM wiki. This creates a step toward a schema — shared vocabulary with documented semantics used across a vast dataset. However, OSM tags remain free-form: multiple valid ways to express the same concept, no built-in validation, and complex downstream validation because of undocumented keys that might have meaning to someone, somewhere. A schema provides the structured alternative: explicit types, clear validation rules, and semantic meaning that both humans and systems can rely on.
+
+Data files containing only column names and values aren't fully documented. External metadata files typically focus on how data was collected and encoded, not on semantic meaning or validation rules. Data consumers struggle to understand what datasets contain and which columns they need for their goals.
+
+## Why Pydantic Over JSON Schema: Solving Multiple Problems
+
+We initially chose JSON Schema because it aligned with our mental model and promised to solve our problems as we understood them. But JSON Schema surfaced several pain points:
+
+- **Authoring difficulty:** Hard to write correctly, difficult to verify, limited IDE support, no refactoring capabilities
+- **Tooling gaps:** Generic tools can't tailor output for specific applications like ours
+- **Development friction:** Schema changes required manual coordination across multiple artifacts
+
+Pydantic addresses these systematically: author in Python with full IDE support, generate tailored documentation, and automatically produce the specific artifacts each workflow needs. Pydantic can also produce JSON Schema, so any application that requires it can use it while we gain all the Python benefits during authoring.
+
+## The Result: Faster Understanding, Higher Quality
+
+Instead of spending time deciphering what columns mean and whether data matches expectations, users can focus on their actual goals: analysis, visualization, integration. Quality improves because validation happens automatically rather than through manual inspection.
+
+The fundamental approach — human-readable authoring that generates machine-actionable outputs — has broader applications beyond Overture and geospatial data. We hope others will adapt these patterns for linking with Overture data or modeling their own domains entirely.
+
+## Schema Modules
+
+Browse the schema reference in the sidebar. Modules are organized by theme and shared components:
+
+**Themes:** Addresses, Base, Buildings, Divisions, Places, Transportation
+
+**Shared:** Core (names, sources, cartographic hints), System (country codes, language tags, geometry primitives)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/addresses/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/addresses/_category_.json
new file mode 100644
index 000000000..29c13add5
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/addresses/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Addresses",
+  "position": 1
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/addresses/address.md b/schema_versioned_docs/version-v1.18.0/reference/addresses/address.md
new file mode 100644
index 000000000..156f3008e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/addresses/address.md
@@ -0,0 +1,82 @@
+---
+sidebar_position: 1
+---
+
+# Address
+
+Addresses are structured labels for the geographic locations where businesses and individuals
+reside.
+
+While address formats around the world have some general points in common, the specifics vary
+extensively from place to place. The rules for dividing an address up into parts or fields vary,
+as do the names of those parts or fields.
+
+The address schema uses a simplified approach to capture the common structure of addresses
+worldwide while accommodating local variance. The schema is heavily based on the OpenAddresses
+([www.openaddresses.io](https://www.openaddresses.io)) project.
+
+For sub-country administrative levels (and non-administrative levels such as neighborhoods), the
+schema provides the `address_levels` field. This is where the names of cities and towns,
+provinces, state, and regions, and similar addressing units are found.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Position of the address. Addresses are point geometries.<br/><br/>*Allowed geometry types: Point* |
+| `theme` | `"addresses"` | |
+| `type` | `"address"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `address_levels[]` | `list<`[`AddressLevel`](types/address_level.md)`>` (optional) | Names of the sub-country addressing areas the address belongs to, including the city or locality, in descending order of generality.<br/><br/>The list is sorted so that the highest, or most general, level comes first (*e.g.*, region) and the lowest, or most particular level, comes last (*e.g.*, city or town).<br/><br/>The number of items in this list and their meaning is country-dependent. For example, in the United States, we expect two items: the state, and the locality or municipality within the state. Other countries might have as few as one, or even three or more.<br/><br/>When a specific level that is required for a country is not known. most likely because the data provider has not supplied it and we have not derived it from another source, the list item corresponding to that level must be present, but its `value` field should be omitted.<br/><br/>*Minimum length: 1*<br/>*Maximum length: 5* |
+| `address_levels[].value` | [`StrippedString`](../system/stripped_string.md) (optional) | A string without leading or trailing whitespace |
+| `country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) | The country the address belongs to, as an ISO 3166-1 alpha-2 country code. |
+| `number` | [`StrippedString`](../system/stripped_string.md) (optional) | The house number.<br/><br/>This field does not necessarily contain an integer or even a number. Values such as "74B", "189 1/2", and "208.5", where the non-integer or non-number part is part of the house number, not a unit number, are in common use.<br/><br/>*Minimum length: 1* |
+| `postal_city` | [`StrippedString`](../system/stripped_string.md) (optional) | The postal authority designated city name, if applicable.<br/><br/>In some countries or regions, a mailing address may need to specify a different city name than the city that actually contains the address coordinates. This optional field can be used to specify the alternate city name to use.<br/><br/>For example:<br/><br/>- The postal city for the US address *716 East County Road, Winchester, Indiana*   is Ridgeville. - The postal city for the Slovenian address *Tomaj 71, 6221 Tomaj, Slovenia* is   Dutovlje.<br/><br/>*Minimum length: 1* |
+| `postcode` | [`StrippedString`](../system/stripped_string.md) (optional) | The postal code.<br/><br/>*Minimum length: 1* |
+| `street` | [`StrippedString`](../system/stripped_string.md) (optional) | The street name.<br/><br/>The street name can include a type (*e.g.*, "Street" or "St", "Boulevard" or "Blvd", *etc.*) and a directional (*e.g.*, "NW" or "Northwest", "S" or "Sud"). Both type and directional, if present, may be either a prefix or a suffix to the primary name. They may either be fully spelled-out or abbreviated.<br/><br/>*Minimum length: 1* |
+| `unit` | [`StrippedString`](../system/stripped_string.md) (optional) | The secondary address unit designator.<br/><br/>In the case where the primary street address is divided into secondary units, which may be apartments, floors, or even buildings if the primary street address is a campus, this field names the specific secondary unit being addressed.<br/><br/>*Minimum length: 1* |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `416ab01c-d836-4c4f-aedc-2f30941ce94d` |
+| `bbox.xmin` | `-176.56381225585938` |
+| `bbox.ymin` | `-43.94719696044922` |
+| `bbox.xmax` | `-176.56378173828125` |
+| `bbox.ymax` | `-43.94718933105469` |
+| `geometry` | `POINT (-176.5637854 -43.9471955)` |
+| `theme` | `addresses` |
+| `type` | `address` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenAddresses/LINZ` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `null` |
+| `sources[0].update_time` | `null` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `address_levels[0].value` | `Chatham Islands` |
+| `address_levels[1].value` | `Chatham Island` |
+| `country` | `NZ` |
+| `number` | `54` |
+| `postal_city` | `null` |
+| `postcode` | `null` |
+| `street` | `Tikitiki Hill Road` |
+| `unit` | `null` |
diff --git a/schema_versioned_docs/version-v1.18.0/reference/addresses/types/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/addresses/types/_category_.json
new file mode 100644
index 000000000..a3ec08974
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/addresses/types/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Types"
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/addresses/types/address_level.md b/schema_versioned_docs/version-v1.18.0/reference/addresses/types/address_level.md
new file mode 100644
index 000000000..b0762021c
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/addresses/types/address_level.md
@@ -0,0 +1,26 @@
+# AddressLevel
+
+A sub-country addressing unit, such as a region, city, or neighborhood, that is less specific
+than a street name and not a postal code.
+
+In the following address, the terms `Montréal` and `QC` are address levels:
+
+```
+3998 Rue De Bullion, Montréal, QC H2W 2E4
+```
+
+The number of address levels per address is country-dependent.
+
+Other addressing systems may use the terms "administrative level" or "admin level"  for the
+same concept. We have chosen the term "address level" to communicate the fact that in some
+countries and regions, address levels do not necessarily correspond to administrative units.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`StrippedString`](../../system/stripped_string.md) (optional) | A string without leading or trailing whitespace<br/><br/>*Minimum length: 1* |
+
+## Used By
+
+- [`Address`](../address.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/base/_category_.json
new file mode 100644
index 000000000..b6b444780
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Base",
+  "position": 2
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/bathymetry.md b/schema_versioned_docs/version-v1.18.0/reference/base/bathymetry.md
new file mode 100644
index 000000000..ecc4908e8
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/bathymetry.md
@@ -0,0 +1,65 @@
+---
+sidebar_position: 1
+---
+
+# Bathymetry
+
+Bathymetry features provide topographic representations of underwater areas, such as parts of
+lake beds or ocean floors.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Shape of the underwater area, which may be a polygon or multi-polygon.<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
+| `theme` | `"base"` | |
+| `type` | `"bathymetry"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `depth` | [`Depth`](types/depth.md) | Depth below surface level of the feature in meters. |
+| `cartography` | [`CartographicHints`](../common/cartographic_hints.md) (optional) | Cartographic hints useful when including the feature in maps |
+| `cartography.prominence` | [`Prominence`](../common/prominence.md) (optional) | Subjective scale of feature significance or importance, with 1 being the least, and 100 being the most, significant.<br/><br/>This value can be used to help drive decisions about how and when to display a feature, and how to treat it relative to neighboring features.<br/><br/>When populated by Overture, this value is derived from various factors including, but not limited to: feature and subtype, population, and capital status. |
+| `cartography.min_zoom` | [`MinZoom`](../common/min_zoom.md) (optional) | Recommended minimum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels below this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `cartography.max_zoom` | [`MaxZoom`](../common/max_zoom.md) (optional) | Recommended maximum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels above this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `cartography.sort_key` | [`SortKey`](../common/sort_key.md) (optional) | Integer indicating the recommended order in which to draw features.<br/><br/>Features with a lower number should be drawn "in front" of features with a higher number. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `5d40bd6c-db14-5492-b29f-5e25a59032bc` |
+| `bbox.xmin` | `-175.12791442871094` |
+| `bbox.ymin` | `-77.9718246459961` |
+| `bbox.xmax` | `-170.05111694335938` |
+| `bbox.ymax` | `-75.64299774169922` |
+| `geometry` | `MULTIPOLYGON (((-170.71296928 -76.744313428, -170.719841483 -76.757076376, -170.731061124 -76.761...` |
+| `theme` | `base` |
+| `type` | `bathymetry` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `ETOPO/GLOBathy` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `2024-12-09T00:00:00.000Z` |
+| `sources[0].update_time` | `null` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `depth` | `500` |
+| `cartography.prominence` | `null` |
+| `cartography.min_zoom` | `null` |
+| `cartography.max_zoom` | `null` |
+| `cartography.sort_key` | `12` |
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/infrastructure.md b/schema_versioned_docs/version-v1.18.0/reference/base/infrastructure.md
new file mode 100644
index 000000000..8f3432f8d
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/infrastructure.md
@@ -0,0 +1,83 @@
+---
+sidebar_position: 1
+---
+
+# Infrastructure
+
+Infrastructure features provide basic information about real-world infrastructure entitites
+such as bridges, airports, runways, aerialways, communication towers, and power lines.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Geometry of the infrastructure feature, which may be a point, line string, polygon, or multi-polygon.<br/><br/>*Allowed geometry types: LineString, MultiPolygon, Point, Polygon* |
+| `theme` | `"base"` | |
+| `type` | `"infrastructure"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `class` | [`InfrastructureClass`](types/infrastructure_class.md) | |
+| `subtype` | [`InfrastructureSubtype`](types/infrastructure_subtype.md) | |
+| `height` | [`Height`](types/height.md) (optional) | Height of the feature in meters. |
+| `surface` | [`SurfaceMaterial`](types/surface_material.md) (optional) | |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level |
+| `source_tags` | [`SourceTags`](types/source_tags.md) (map, optional) | Key/value pairs imported directly from the source data without change.<br/><br/>This field provides access to raw OSM entity tags for features sourced from OpenStreetMap. |
+| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `e9e3d506-89c0-3473-8cee-5e5ac6596d6c` |
+| `bbox.xmin` | `-180.0` |
+| `bbox.ymin` | `-82.42408752441406` |
+| `bbox.xmax` | `-179.99998474121094` |
+| `bbox.ymax` | `-82.42407989501953` |
+| `geometry` | `POINT (-179.9999994 -82.42408)` |
+| `theme` | `base` |
+| `type` | `infrastructure` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `n7674174803@2` |
+| `sources[0].update_time` | `2023-04-07T17:37:48+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `class` | `information` |
+| `subtype` | `pedestrian` |
+| `height` | `null` |
+| `surface` | `null` |
+| `names.primary` | `1306 km to South Pole` |
+| `names.common` | `null` |
+| `names.rules` | `null` |
+| `level` | `0` |
+| `source_tags` | `{"description": "1036 km to South Pole.", "information": "route_marker", "note": "The road contin...` |
+| `wikidata` | `Q800558` |
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/land.md b/schema_versioned_docs/version-v1.18.0/reference/base/land.md
new file mode 100644
index 000000000..b54eb24a0
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/land.md
@@ -0,0 +1,93 @@
+---
+sidebar_position: 1
+---
+
+# Land
+
+Land features are representations of physical land surfaces.
+
+In Overture data releases, land features are sourced from OpenStreetMap. TODO. Finish this when
+I get more info from Jennings.
+
+
+
+Physical representations of land surfaces.
+
+Global land derived from the inverse of OSM Coastlines. Translates `natural` tags from OpenStreetMap.
+
+TODO: Update this description when the relationship to `land_cover` is better understood.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Geometry of the land feature, which may be a point, line string, polygon, or multi-polygon.<br/><br/>*Allowed geometry types: LineString, MultiPolygon, Point, Polygon* |
+| `theme` | `"base"` | |
+| `type` | `"land"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `class` | [`LandClass`](types/land_class.md) (optional) | |
+| `subtype` | [`LandSubtype`](types/land_subtype.md) (optional) | |
+| `elevation` | [`Elevation`](types/elevation.md) (optional) | Elevation above sea level of the feature in meters. |
+| `surface` | [`SurfaceMaterial`](types/surface_material.md) (optional) | |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level |
+| `source_tags` | [`SourceTags`](types/source_tags.md) (map, optional) | Key/value pairs imported directly from the source data without change.<br/><br/>This field provides access to raw OSM entity tags for features sourced from OpenStreetMap. |
+| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `70fc3596-a987-3fea-820c-c016c0a2f0da` |
+| `bbox.xmin` | `-178.7000274658203` |
+| `bbox.ymin` | `-85.45001220703125` |
+| `bbox.xmax` | `-178.6999969482422` |
+| `bbox.ymax` | `-85.44999694824219` |
+| `geometry` | `POINT (-178.7 -85.45)` |
+| `theme` | `base` |
+| `type` | `land` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `n11693475112@1` |
+| `sources[0].update_time` | `2024-03-05T09:23:39+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `class` | `cliff` |
+| `subtype` | `physical` |
+| `elevation` | `null` |
+| `surface` | `null` |
+| `names.primary` | `Dismal Buttress` |
+| `names.common` | `null` |
+| `names.rules` | `null` |
+| `level` | `0` |
+| `source_tags` | `{"natural": "cliff", "ref:linz:place_id": "12318", "wikipedia": "en:Dismal Buttress"}` |
+| `wikidata` | `Q5282342` |
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/land_cover.md b/schema_versioned_docs/version-v1.18.0/reference/base/land_cover.md
new file mode 100644
index 000000000..348f8a4c9
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/land_cover.md
@@ -0,0 +1,72 @@
+---
+sidebar_position: 1
+---
+
+# LandCover
+
+Land cover features indicate the primary natural or artificial surface material covering a land
+area on the earth, including vegetation types like forests and crops, built environments like
+cities, and natural surfaces like wetlands or barren ground.
+
+Land cover features relate to `LandUse` features in the following way: land cover is the
+physical thing covering the land, while land use is the human use to which the land is being
+put.
+
+TODO: Explain relationship to `Land` features.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Shape of the covered land area, which may be a polygon or multi-polygon.<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
+| `theme` | `"base"` | |
+| `type` | `"land_cover"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `subtype` | [`LandCoverSubtype`](types/land_cover_subtype.md) | |
+| `cartography` | [`CartographicHints`](../common/cartographic_hints.md) (optional) | Cartographic hints useful when including the feature in maps |
+| `cartography.prominence` | [`Prominence`](../common/prominence.md) (optional) | Subjective scale of feature significance or importance, with 1 being the least, and 100 being the most, significant.<br/><br/>This value can be used to help drive decisions about how and when to display a feature, and how to treat it relative to neighboring features.<br/><br/>When populated by Overture, this value is derived from various factors including, but not limited to: feature and subtype, population, and capital status. |
+| `cartography.min_zoom` | [`MinZoom`](../common/min_zoom.md) (optional) | Recommended minimum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels below this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `cartography.max_zoom` | [`MaxZoom`](../common/max_zoom.md) (optional) | Recommended maximum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels above this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `cartography.sort_key` | [`SortKey`](../common/sort_key.md) (optional) | Integer indicating the recommended order in which to draw features.<br/><br/>Features with a lower number should be drawn "in front" of features with a higher number. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `c347312d-012b-5e73-8bd3-a10d04b2981d` |
+| `bbox.xmin` | `-180.0001983642578` |
+| `bbox.ymin` | `65.95172119140625` |
+| `bbox.xmax` | `-179.99313354492188` |
+| `bbox.ymax` | `65.96218872070312` |
+| `geometry` | `POLYGON ((-179.99877531181616 65.95172539425603, -179.99740705536922 65.95265577758867, -179.9975...` |
+| `theme` | `base` |
+| `type` | `land_cover` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `ESA WorldCover` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `null` |
+| `sources[0].update_time` | `2024-11-07T00:00:00+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `subtype` | `barren` |
+| `cartography.prominence` | `null` |
+| `cartography.min_zoom` | `8` |
+| `cartography.max_zoom` | `15` |
+| `cartography.sort_key` | `3` |
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/land_use.md b/schema_versioned_docs/version-v1.18.0/reference/base/land_use.md
new file mode 100644
index 000000000..40b9d21b3
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/land_use.md
@@ -0,0 +1,88 @@
+---
+sidebar_position: 1
+---
+
+# LandUse
+
+Land use features specify the predominant human use of an area of land, for example commercial
+activity, recreation, farming, housing, education, or military use.
+
+Land use features relate to `LandCover` features in the following way: land use is the human
+human activity being done with the land, while land cover is the physical thing that covers it.
+
+TODO: Explain relationship to `Land` features.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Geometry of the land use area, which may be a point, line string, polygon, or multi-polygon.<br/><br/>*Allowed geometry types: LineString, MultiPolygon, Point, Polygon* |
+| `theme` | `"base"` | |
+| `type` | `"land_use"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `class` | [`LandUseClass`](types/land_use_class.md) | |
+| `subtype` | [`LandUseSubtype`](types/land_use_subtype.md) | |
+| `elevation` | [`Elevation`](types/elevation.md) (optional) | Elevation above sea level of the feature in meters. |
+| `surface` | [`SurfaceMaterial`](types/surface_material.md) (optional) | |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level |
+| `source_tags` | [`SourceTags`](types/source_tags.md) (map, optional) | Key/value pairs imported directly from the source data without change.<br/><br/>This field provides access to raw OSM entity tags for features sourced from OpenStreetMap. |
+| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `1e1f6095-5bd2-3fdb-a422-41351b848e9d` |
+| `bbox.xmin` | `-176.56825256347656` |
+| `bbox.ymin` | `-43.96001052856445` |
+| `bbox.xmax` | `-176.56231689453125` |
+| `bbox.ymax` | `-43.95420837402344` |
+| `geometry` | `POLYGON ((-176.5623454 -43.9567812, -176.5627644 -43.9561272, -176.5626898 -43.9557432, -176.5624...` |
+| `theme` | `base` |
+| `type` | `land_use` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `w56117029@3` |
+| `sources[0].update_time` | `2010-04-24T22:35:13+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `class` | `golf_course` |
+| `subtype` | `golf` |
+| `elevation` | `null` |
+| `surface` | `null` |
+| `names.primary` | `Chatham Islands Golf Club` |
+| `names.common` | `null` |
+| `names.rules` | `null` |
+| `level` | `0` |
+| `source_tags` | `{"LINZ:source_version": "V16", "attribution": "http://wiki.osm.org/wiki/Attribution#LINZ", "leisu...` |
+| `wikidata` | `null` |
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/types/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/base/types/_category_.json
new file mode 100644
index 000000000..a3ec08974
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/types/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Types"
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/types/depth.md b/schema_versioned_docs/version-v1.18.0/reference/base/types/depth.md
new file mode 100644
index 000000000..f6b96f3ed
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/types/depth.md
@@ -0,0 +1,15 @@
+# Depth
+
+Depth below surface level of the feature in meters.
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 0`
+- `≥ -2147483648` (from [`int32`](../../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../../system/primitive/primitives.md))
+
+## Used By
+
+- [`Bathymetry`](../bathymetry.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/types/elevation.md b/schema_versioned_docs/version-v1.18.0/reference/base/types/elevation.md
new file mode 100644
index 000000000..2bfb7d128
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/types/elevation.md
@@ -0,0 +1,16 @@
+# Elevation
+
+Elevation above sea level of the feature in meters.
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≤ 9000`
+- `≥ -2147483648` (from [`int32`](../../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../../system/primitive/primitives.md))
+
+## Used By
+
+- [`Land`](../land.md)
+- [`LandUse`](../land_use.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/types/height.md b/schema_versioned_docs/version-v1.18.0/reference/base/types/height.md
new file mode 100644
index 000000000..6a4b542fb
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/types/height.md
@@ -0,0 +1,13 @@
+# Height
+
+Height of the feature in meters.
+
+Underlying type: `float64`
+
+## Constraints
+
+- `> 0`
+
+## Used By
+
+- [`Infrastructure`](../infrastructure.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/types/infrastructure_class.md b/schema_versioned_docs/version-v1.18.0/reference/base/types/infrastructure_class.md
new file mode 100644
index 000000000..b8cc4043a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/types/infrastructure_class.md
@@ -0,0 +1,176 @@
+# InfrastructureClass
+
+Further classification of the type of infrastructure.
+
+The infrastructure class adds detail to the broad classification of `InfrastructureSubtype`.
+
+## Values
+
+- `aerialway_station`
+- `airport`
+- `airport_gate`
+- `airstrip`
+- `apron`
+- `aqueduct`
+- `artwork`
+- `atm`
+- `barrier`
+- `bell_tower`
+- `bench`
+- `bicycle_parking`
+- `bicycle_rental`
+- `block`
+- `boardwalk`
+- `bollard`
+- `border_control`
+- `breakwater`
+- `bridge`
+- `bridge_support`
+- `bump_gate`
+- `bus_route`
+- `bus_station`
+- `bus_stop`
+- `bus_trap`
+- `cable`
+- `cable_barrier`
+- `cable_car`
+- `cable_distribution`
+- `camp_site`
+- `cantilever`
+- `catenary_mast`
+- `cattle_grid`
+- `chain`
+- `chair_lift`
+- `charging_station`
+- `city_wall`
+- `communication_line`
+- `communication_pole`
+- `communication_tower`
+- `connection`
+- `cooling`
+- `covered`
+- `crossing`
+- `cutline`
+- `cycle_barrier`
+- `dam`
+- `defensive`
+- `ditch`
+- `diving`
+- `drag_lift`
+- `drain`
+- `drinking_water`
+- `entrance`
+- `fence`
+- `ferry_terminal`
+- `fire_hydrant`
+- `fountain`
+- `full-height_turnstile`
+- `gasometer`
+- `gate`
+- `generator`
+- `give_way`
+- `gondola`
+- `goods`
+- `guard_rail`
+- `hampshire_gate`
+- `handrail`
+- `hedge`
+- `height_restrictor`
+- `heliostat`
+- `helipad`
+- `heliport`
+- `hose`
+- `information`
+- `insulator`
+- `international_airport`
+- `j-bar`
+- `jersey_barrier`
+- `kerb`
+- `kissing_gate`
+- `launchpad`
+- `lift_gate`
+- `lighting`
+- `lightning_protection`
+- `magic_carpet`
+- `manhole`
+- `milestone`
+- `military_airport`
+- `minaret`
+- `minor_line`
+- `mixed_lift`
+- `mobile_phone_tower`
+- `monitoring`
+- `motorcycle_parking`
+- `motorway_junction`
+- `movable`
+- `municipal_airport`
+- `observation`
+- `parking`
+- `parking_entrance`
+- `parking_space`
+- `pedestrian_crossing`
+- `picnic_table`
+- `pier`
+- `pipeline`
+- `plant`
+- `planter`
+- `platform`
+- `platter`
+- `portal`
+- `post_box`
+- `power_line`
+- `power_pole`
+- `power_tower`
+- `private_airport`
+- `pylon`
+- `quay`
+- `radar`
+- `railway_halt`
+- `railway_station`
+- `recycling`
+- `regional_airport`
+- `reservoir_covered`
+- `retaining_wall`
+- `roller_coaster`
+- `rope_tow`
+- `runway`
+- `sally_port`
+- `seaplane_airport`
+- `sewer`
+- `silo`
+- `siren`
+- `stile`
+- `stop`
+- `stop_position`
+- `stopway`
+- `storage_tank`
+- `street_cabinet`
+- `street_lamp`
+- `substation`
+- `subway_station`
+- `swing_gate`
+- `switch`
+- `t-bar`
+- `taxilane`
+- `taxiway`
+- `terminal`
+- `toilets`
+- `toll_booth`
+- `traffic_signals`
+- `transformer`
+- `trestle`
+- `utility_pole`
+- `vending_machine`
+- `viaduct`
+- `viewpoint`
+- `wall`
+- `waste_basket`
+- `waste_disposal`
+- `watchtower`
+- `water_tower`
+- `weir`
+- `zip_line`
+
+## Used By
+
+- [`Infrastructure`](../infrastructure.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/types/infrastructure_subtype.md b/schema_versioned_docs/version-v1.18.0/reference/base/types/infrastructure_subtype.md
new file mode 100644
index 000000000..c7432d702
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/types/infrastructure_subtype.md
@@ -0,0 +1,30 @@
+# InfrastructureSubtype
+
+Broadest classification of the type of infrastructure.
+
+This broad classification can be refined by `InfrastructureClass`.
+
+## Values
+
+- `aerialway`
+- `airport`
+- `barrier`
+- `bridge`
+- `communication`
+- `emergency`
+- `manhole`
+- `pedestrian`
+- `pier`
+- `power`
+- `quay`
+- `recreation`
+- `tower`
+- `transit`
+- `transportation`
+- `utility`
+- `waste_management`
+- `water`
+
+## Used By
+
+- [`Infrastructure`](../infrastructure.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/types/land_class.md b/schema_versioned_docs/version-v1.18.0/reference/base/types/land_class.md
new file mode 100644
index 000000000..8c63ddaf1
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/types/land_class.md
@@ -0,0 +1,54 @@
+# LandClass
+
+Further classification of the land.
+
+The land class adds detail to the broad classification of `LandSubtype`.
+
+## Values
+
+- `archipelago`
+- `bare_rock`
+- `beach`
+- `cave_entrance`
+- `cliff`
+- `desert`
+- `dune`
+- `fell`
+- `forest`
+- `glacier`
+- `grass`
+- `grassland`
+- `heath`
+- `hill`
+- `island`
+- `islet`
+- `land`
+- `meadow`
+- `meteor_crater`
+- `mountain_range`
+- `peak`
+- `peninsula`
+- `plateau`
+- `reef`
+- `ridge`
+- `rock`
+- `saddle`
+- `sand`
+- `scree`
+- `scrub`
+- `shingle`
+- `shrub`
+- `shrubbery`
+- `stone`
+- `tree`
+- `tree_row`
+- `tundra`
+- `valley`
+- `volcanic_caldera_rim`
+- `volcano`
+- `wetland`
+- `wood`
+
+## Used By
+
+- [`Land`](../land.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/types/land_cover_subtype.md b/schema_versioned_docs/version-v1.18.0/reference/base/types/land_cover_subtype.md
new file mode 100644
index 000000000..8a9676ae8
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/types/land_cover_subtype.md
@@ -0,0 +1,20 @@
+# LandCoverSubtype
+
+Primary or dominant material covering the land.
+
+## Values
+
+- `barren`
+- `crop`
+- `forest`
+- `grass`
+- `mangrove`
+- `moss`
+- `shrub`
+- `snow`
+- `urban`
+- `wetland`
+
+## Used By
+
+- [`LandCover`](../land_cover.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/types/land_subtype.md b/schema_versioned_docs/version-v1.18.0/reference/base/types/land_subtype.md
new file mode 100644
index 000000000..9e92c91af
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/types/land_subtype.md
@@ -0,0 +1,25 @@
+# LandSubtype
+
+Broadest classification of the land.
+
+This broad classification can be refined by `LandClass`.
+
+## Values
+
+- `crater`
+- `desert`
+- `forest`
+- `glacier`
+- `grass`
+- `land`
+- `physical`
+- `reef`
+- `rock`
+- `sand`
+- `shrub`
+- `tree`
+- `wetland`
+
+## Used By
+
+- [`Land`](../land.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/types/land_use_class.md b/schema_versioned_docs/version-v1.18.0/reference/base/types/land_use_class.md
new file mode 100644
index 000000000..5c9531d89
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/types/land_use_class.md
@@ -0,0 +1,121 @@
+# LandUseClass
+
+Further classification of the land use.
+
+The land use class adds detail to the broad classification of `LandUseSubtype`.
+
+## Values
+
+- `aboriginal_land`
+- `airfield`
+- `allotments`
+- `animal_keeping`
+- `aquaculture`
+- `barracks`
+- `base`
+- `beach_resort`
+- `brownfield`
+- `bunker`
+- `camp_site`
+- `cemetery`
+- `clinic`
+- `college`
+- `commercial`
+- `connection`
+- `construction`
+- `danger_area`
+- `doctors`
+- `dog_park`
+- `downhill`
+- `driving_range`
+- `driving_school`
+- `education`
+- `environmental`
+- `fairway`
+- `farmland`
+- `farmyard`
+- `fatbike`
+- `flowerbed`
+- `forest`
+- `garages`
+- `garden`
+- `golf_course`
+- `grass`
+- `grave_yard`
+- `green`
+- `greenfield`
+- `greenhouse_horticulture`
+- `highway`
+- `hike`
+- `hospital`
+- `ice_skate`
+- `industrial`
+- `institutional`
+- `kindergarten`
+- `landfill`
+- `lateral_water_hazard`
+- `logging`
+- `marina`
+- `meadow`
+- `military`
+- `military_hospital`
+- `military_school`
+- `music_school`
+- `national_park`
+- `natural_monument`
+- `nature_reserve`
+- `naval_base`
+- `nordic`
+- `nuclear_explosion_site`
+- `obstacle_course`
+- `orchard`
+- `park`
+- `peat_cutting`
+- `pedestrian`
+- `pitch`
+- `plant_nursery`
+- `playground`
+- `plaza`
+- `protected`
+- `protected_landscape_seascape`
+- `quarry`
+- `railway`
+- `range`
+- `recreation_ground`
+- `religious`
+- `residential`
+- `resort`
+- `retail`
+- `rough`
+- `salt_pond`
+- `school`
+- `schoolyard`
+- `ski_jump`
+- `skitour`
+- `sled`
+- `sleigh`
+- `snow_park`
+- `species_management_area`
+- `stadium`
+- `state_park`
+- `static_caravan`
+- `strict_nature_reserve`
+- `tee`
+- `theme_park`
+- `track`
+- `traffic_island`
+- `training_area`
+- `trench`
+- `university`
+- `village_green`
+- `vineyard`
+- `water_hazard`
+- `water_park`
+- `wilderness_area`
+- `winter_sports`
+- `works`
+- `zoo`
+
+## Used By
+
+- [`LandUse`](../land_use.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/types/land_use_subtype.md b/schema_versioned_docs/version-v1.18.0/reference/base/types/land_use_subtype.md
new file mode 100644
index 000000000..3acc75d21
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/types/land_use_subtype.md
@@ -0,0 +1,36 @@
+# LandUseSubtype
+
+Broadest classification of the land use.
+
+This broad classification can be refined by `LandUseClass`.
+
+## Values
+
+- `agriculture`
+- `aquaculture`
+- `campground`
+- `cemetery`
+- `construction`
+- `developed`
+- `education`
+- `entertainment`
+- `golf`
+- `grass`
+- `horticulture`
+- `landfill`
+- `managed`
+- `medical`
+- `military`
+- `park`
+- `pedestrian`
+- `protected`
+- `recreation`
+- `religious`
+- `residential`
+- `resource_extraction`
+- `transportation`
+- `winter_sports`
+
+## Used By
+
+- [`LandUse`](../land_use.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/types/source_tags.md b/schema_versioned_docs/version-v1.18.0/reference/base/types/source_tags.md
new file mode 100644
index 000000000..41f50ae8f
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/types/source_tags.md
@@ -0,0 +1,15 @@
+# SourceTags
+
+Key/value pairs imported directly from the source data without change.
+
+This field provides access to raw OSM entity tags for features sourced from
+OpenStreetMap.
+
+Underlying type: `map<string, Any>`
+
+## Used By
+
+- [`Infrastructure`](../infrastructure.md)
+- [`Land`](../land.md)
+- [`LandUse`](../land_use.md)
+- [`Water`](../water.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/types/surface_material.md b/schema_versioned_docs/version-v1.18.0/reference/base/types/surface_material.md
new file mode 100644
index 000000000..707f5a6a2
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/types/surface_material.md
@@ -0,0 +1,36 @@
+# SurfaceMaterial
+
+Material that makes up the surface of `Infrastructure` and `Land` features.
+
+## Values
+
+- `asphalt`
+- `cobblestone`
+- `compacted`
+- `concrete`
+- `concrete_plates`
+- `dirt`
+- `earth`
+- `fine_gravel`
+- `grass`
+- `gravel`
+- `ground`
+- `paved`
+- `paving_stones`
+- `pebblestone`
+- `recreation_grass`
+- `recreation_paved`
+- `recreation_sand`
+- `rubber`
+- `sand`
+- `sett`
+- `tartan`
+- `unpaved`
+- `wood`
+- `woodchips`
+
+## Used By
+
+- [`Infrastructure`](../infrastructure.md)
+- [`Land`](../land.md)
+- [`LandUse`](../land_use.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/types/water_class.md b/schema_versioned_docs/version-v1.18.0/reference/base/types/water_class.md
new file mode 100644
index 000000000..def472f93
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/types/water_class.md
@@ -0,0 +1,47 @@
+# WaterClass
+
+Further description of the type of water body.
+
+The water class adds detail to the broad classification of `WaterSubtype`.
+
+## Values
+
+- `basin`
+- `bay`
+- `blowhole`
+- `canal`
+- `cape`
+- `ditch`
+- `dock`
+- `drain`
+- `fairway`
+- `fish_pass`
+- `fishpond`
+- `geyser`
+- `hot_spring`
+- `lagoon`
+- `lake`
+- `moat`
+- `ocean`
+- `oxbow`
+- `pond`
+- `reflecting_pool`
+- `reservoir`
+- `river`
+- `salt_pond`
+- `sea`
+- `sewage`
+- `shoal`
+- `spring`
+- `strait`
+- `stream`
+- `swimming_pool`
+- `tidal_channel`
+- `wastewater`
+- `water`
+- `water_storage`
+- `waterfall`
+
+## Used By
+
+- [`Water`](../water.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/types/water_subtype.md b/schema_versioned_docs/version-v1.18.0/reference/base/types/water_subtype.md
new file mode 100644
index 000000000..987dc1af3
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/types/water_subtype.md
@@ -0,0 +1,24 @@
+# WaterSubtype
+
+The broad classification of water body such as river, ocean or lake.
+
+This broad classification can be refined using `WaterClass`.
+
+## Values
+
+- `canal`
+- `human_made`
+- `lake`
+- `ocean`
+- `physical`
+- `pond`
+- `reservoir`
+- `river`
+- `spring`
+- `stream`
+- `wastewater`
+- `water`
+
+## Used By
+
+- [`Water`](../water.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/base/water.md b/schema_versioned_docs/version-v1.18.0/reference/base/water.md
new file mode 100644
index 000000000..5b2bd1430
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/base/water.md
@@ -0,0 +1,104 @@
+---
+sidebar_position: 1
+---
+
+# Water
+
+Water features represent ocean and inland water bodies.
+
+In Overture data releases, water features are sourced from OpenStreetMap. There are two main
+categories of water feature: ocean and inland water bodies.
+
+Ocean
+-----
+The `subytpe` value `"ocean"` indicates an ocean area feature whose geometry represents the
+surface area of an ocean or part of an ocean. Ocean area may be tiled into many small polygons
+of consistent complexity to ensure manageable geometry. In Overture data releases, ocean area
+features are created from OpenStreetMap coastlines data (`natural=coastline`) using a QA'd
+version of the output from the OSMCoastline tool. In aggregate, all the ocean area features
+represent the inverse of the land features with subtype `"land"` and class `"land"`.
+
+The names and recommended label position for oceans and seas can be found in features with the
+subtype `"physical"` and the class `"ocean"` or `"sea"`.
+
+Inland Water
+------------
+Subtypes other than `"ocean"` (and `"physical"`) represent inland water bodies. In Overture data
+releases, these features are sourced from the OpenStreetMap tag `natural=*` where the tag value
+indicates a water body, as well as the tags `natural=water`,  `waterway=*`,
+and `water=*`.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Geometry of the water feature, which may be a point, line string, polygon, or multi-polygon.<br/><br/>*Allowed geometry types: LineString, MultiPolygon, Point, Polygon* |
+| `theme` | `"base"` | |
+| `type` | `"water"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `class` | [`WaterClass`](types/water_class.md) (optional) | |
+| `subtype` | [`WaterSubtype`](types/water_subtype.md) (optional) | |
+| `is_intermittent` | `boolean` (optional) | Whether the water body exists intermittently, not permanently<br/><br/>*`strict=True`* |
+| `is_salt` | `boolean` (optional) | Whether the water body contains salt water<br/><br/>*`strict=True`* |
+| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `source_tags` | [`SourceTags`](types/source_tags.md) (map, optional) | Key/value pairs imported directly from the source data without change.<br/><br/>This field provides access to raw OSM entity tags for features sourced from OpenStreetMap. |
+| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `6bbb5fe5-bf26-3efa-b120-0a7079b60840` |
+| `bbox.xmin` | `-177.03179931640625` |
+| `bbox.ymin` | `-84.93480682373047` |
+| `bbox.xmax` | `-177.0317840576172` |
+| `bbox.ymax` | `-84.9347915649414` |
+| `geometry` | `POINT (-177.031799 -84.934793)` |
+| `theme` | `base` |
+| `type` | `water` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `n11109190647@2` |
+| `sources[0].update_time` | `2024-02-11T05:52:05+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `class` | `cape` |
+| `subtype` | `physical` |
+| `is_intermittent` | `null` |
+| `is_salt` | `null` |
+| `level` | `0` |
+| `names.primary` | `Thanksgiving Point` |
+| `names.common` | `null` |
+| `names.rules` | `null` |
+| `source_tags` | `{"natural": "cape", "ref:linz:place_id": "13433"}` |
+| `wikidata` | `Q33140589` |
diff --git a/schema_versioned_docs/version-v1.18.0/reference/buildings/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/buildings/_category_.json
new file mode 100644
index 000000000..3e85a3e78
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/buildings/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Buildings",
+  "position": 3
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/buildings/building.md b/schema_versioned_docs/version-v1.18.0/reference/buildings/building.md
new file mode 100644
index 000000000..e90f984ba
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/buildings/building.md
@@ -0,0 +1,108 @@
+---
+sidebar_position: 1
+---
+
+# Building
+
+Buildings are man-made structures with roofs that exist permanently in one place.
+
+A building's geometry represents the two-dimensional footprint of the building as viewed from
+directly above, looking down. Fields such as `height` and `num_floors` allow the
+three-dimensional shape to be approximated. Some buildings, identified by the `has_parts` field,
+have associated `BuildingPart` features which can be used to generate a more representative 3D
+model of the building.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | The building's footprint or roofprint (if traced from aerial/satellite imagery).<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
+| `theme` | `"buildings"` | |
+| `type` | `"building"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `subtype` | [`BuildingSubtype`](types/building_subtype.md) (optional) | A broad classification of the current use and purpose of the building.<br/><br/>If the current use of the building no longer accords with the original built purpose, the current use should be specified. For example, a building built as a train station but later converted into a shopping mall would have the value `"commercial"` rather than `"transportation"`. |
+| `class` | [`BuildingClass`](types/building_class.md) (optional) | A more specific classification of the current use and purpose of the building.<br/><br/>If the current use of the building no longer accords with the original built purpose, the current use should be specified. |
+| `has_parts` | `boolean` (optional) | Whether the building has associated building part features<br/><br/>*`strict=True`* |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level |
+| `height` | [`float64`](../system/primitive/primitives.md) (optional) | Height of the building or part in meters.<br/><br/>This is the distance from the lowest point to the highest point.<br/><br/>*`> 0`* |
+| `is_underground` | `boolean` (optional) | Whether the entire building or part is completely below ground.<br/><br/>The underground flag is useful for display purposes. Buildings and building parts that are entirely below ground can be styled differently or omitted from the rendered image.<br/><br/>This flag is conceptually different from the `level` field, which indicates relative z-ordering and, notably, can be negative even if the building is entirely above-ground.<br/><br/>*`strict=True`* |
+| `num_floors` | [`int32`](../system/primitive/primitives.md) (optional) | Number of above-ground floors of the building or part.<br/><br/>*`> 0`* |
+| `num_floors_underground` | [`int32`](../system/primitive/primitives.md) (optional) | Number of below-ground floors of the building or part.<br/><br/>*`> 0`* |
+| `min_height` | [`float64`](../system/primitive/primitives.md) (optional) | Altitude above ground where the bottom of the building or building part starts.<br/><br/>If present, this value indicates that the lowest part of the building or building part starts is above ground level. |
+| `min_floor` | [`int32`](../system/primitive/primitives.md) (optional) | Start floor of this building or part.<br/><br/>If present, this value indicates that the building or part is "floating" and its bottom-most floor is above ground level, usually because it is part of a larger building in which some parts do reach down to ground level. An example is a building that has an entry road or driveway at ground level into an interior courtyard, where part of the building bridges above the entry road. This property may sometimes be populated when `min_height` is missing and in these cases can be used as a proxy for `min_height`.<br/><br/>*`> 0`* |
+| `facade_color` | [`HexColor`](../system/hex_color.md) (optional) | Facade color in `#rgb` or `#rrggbb` hex notation |
+| `facade_material` | [`FacadeMaterial`](types/facade_material.md) (optional) | Outer surface material of the facade |
+| `roof_material` | [`RoofMaterial`](types/roof_material.md) (optional) | Outer surface material of the roof |
+| `roof_shape` | [`RoofShape`](types/roof_shape.md) (optional) | Shape of the roof |
+| `roof_direction` | [`float64`](../system/primitive/primitives.md) (optional) | Bearing of the roof ridge line in degrees<br/><br/>*`≥ 0`*<br/>*`< 360`* |
+| `roof_orientation` | [`RoofOrientation`](types/roof_orientation.md) (optional) | Orientation of the roof shape relative to the footprint shape |
+| `roof_color` | [`HexColor`](../system/hex_color.md) (optional) | The roof color in `#rgb` or `#rrggbb` hex notation |
+| `roof_height` | [`float64`](../system/primitive/primitives.md) (optional) | Height of the roof in meters.<br/><br/>This is the distance from the base of the roof to its highest point. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `148f35b1-7bc1-4180-9280-10d39b13883b` |
+| `bbox.xmin` | `-176.643798828125` |
+| `bbox.ymin` | `-43.9938850402832` |
+| `bbox.xmax` | `-176.64349365234375` |
+| `bbox.ymax` | `-43.993709564208984` |
+| `geometry` | `POLYGON ((-176.6435004 -43.9938042, -176.6435738 -43.9937107, -176.6437726 -43.9937913, -176.6436...` |
+| `theme` | `buildings` |
+| `type` | `building` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `w519166507@1` |
+| `sources[0].update_time` | `2017-08-27T21:39:50+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `subtype` | `null` |
+| `class` | `null` |
+| `has_parts` | `false` |
+| `names` | `null` |
+| `level` | `0` |
+| `height` | `null` |
+| `is_underground` | `false` |
+| `num_floors` | `null` |
+| `num_floors_underground` | `null` |
+| `min_height` | `null` |
+| `min_floor` | `null` |
+| `facade_color` | `null` |
+| `facade_material` | `null` |
+| `roof_material` | `null` |
+| `roof_shape` | `null` |
+| `roof_direction` | `null` |
+| `roof_orientation` | `null` |
+| `roof_color` | `null` |
+| `roof_height` | `null` |
diff --git a/schema_versioned_docs/version-v1.18.0/reference/buildings/building_part.md b/schema_versioned_docs/version-v1.18.0/reference/buildings/building_part.md
new file mode 100644
index 000000000..737eb8520
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/buildings/building_part.md
@@ -0,0 +1,107 @@
+---
+sidebar_position: 1
+---
+
+# BuildingPart
+
+Building parts represent parts of larger building features. They allow buildings to be modeled
+in rich detail suitable for creating realistic 3D models.
+
+Every building part is associated with a parent `Building` feature via the `building_id` field.
+In addition, a building part has a footprint geometry and may include additional details such as
+its height, the number of floors, and the color and material of its facade and roof.
+
+Building parts can float or be stacked on top of each other. The `min_height`, `min_floor`,
+`height`, and `num_floors`, fields can be used to arrange the parts correctly along the
+vertical dimension.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | The footprint or roofprint of the building part.<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
+| `theme` | `"buildings"` | |
+| `type` | `"building_part"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `building_id` | [`Id`](../system/ref/id.md) | The building to which this part belongs<br/><br/>*References [`Building`](building.md) (composition, part of)* |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level |
+| `height` | [`float64`](../system/primitive/primitives.md) (optional) | Height of the building or part in meters.<br/><br/>This is the distance from the lowest point to the highest point.<br/><br/>*`> 0`* |
+| `is_underground` | `boolean` (optional) | Whether the entire building or part is completely below ground.<br/><br/>The underground flag is useful for display purposes. Buildings and building parts that are entirely below ground can be styled differently or omitted from the rendered image.<br/><br/>This flag is conceptually different from the `level` field, which indicates relative z-ordering and, notably, can be negative even if the building is entirely above-ground.<br/><br/>*`strict=True`* |
+| `num_floors` | [`int32`](../system/primitive/primitives.md) (optional) | Number of above-ground floors of the building or part.<br/><br/>*`> 0`* |
+| `num_floors_underground` | [`int32`](../system/primitive/primitives.md) (optional) | Number of below-ground floors of the building or part.<br/><br/>*`> 0`* |
+| `min_height` | [`float64`](../system/primitive/primitives.md) (optional) | Altitude above ground where the bottom of the building or building part starts.<br/><br/>If present, this value indicates that the lowest part of the building or building part starts is above ground level. |
+| `min_floor` | [`int32`](../system/primitive/primitives.md) (optional) | Start floor of this building or part.<br/><br/>If present, this value indicates that the building or part is "floating" and its bottom-most floor is above ground level, usually because it is part of a larger building in which some parts do reach down to ground level. An example is a building that has an entry road or driveway at ground level into an interior courtyard, where part of the building bridges above the entry road. This property may sometimes be populated when `min_height` is missing and in these cases can be used as a proxy for `min_height`.<br/><br/>*`> 0`* |
+| `facade_color` | [`HexColor`](../system/hex_color.md) (optional) | Facade color in `#rgb` or `#rrggbb` hex notation |
+| `facade_material` | [`FacadeMaterial`](types/facade_material.md) (optional) | Outer surface material of the facade |
+| `roof_material` | [`RoofMaterial`](types/roof_material.md) (optional) | Outer surface material of the roof |
+| `roof_shape` | [`RoofShape`](types/roof_shape.md) (optional) | Shape of the roof |
+| `roof_direction` | [`float64`](../system/primitive/primitives.md) (optional) | Bearing of the roof ridge line in degrees<br/><br/>*`≥ 0`*<br/>*`< 360`* |
+| `roof_orientation` | [`RoofOrientation`](types/roof_orientation.md) (optional) | Orientation of the roof shape relative to the footprint shape |
+| `roof_color` | [`HexColor`](../system/hex_color.md) (optional) | The roof color in `#rgb` or `#rrggbb` hex notation |
+| `roof_height` | [`float64`](../system/primitive/primitives.md) (optional) | Height of the roof in meters.<br/><br/>This is the distance from the base of the roof to its highest point. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `19412d64-51ac-3d6a-ac2f-8a8c8b91bb60` |
+| `bbox.xmin` | `-73.24630737304688` |
+| `bbox.ymin` | `-39.81101608276367` |
+| `bbox.xmax` | `-73.24613952636719` |
+| `bbox.ymax` | `-39.81088638305664` |
+| `geometry` | `POLYGON ((-73.2462509 -39.8108937, -73.2462755 -39.8109047, -73.246291 -39.8109182, -73.2463022 -...` |
+| `theme` | `buildings` |
+| `type` | `building_part` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `w223076787@2` |
+| `sources[0].update_time` | `2014-10-31T22:55:36+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `building_id` | `bd663bd4-1844-4d7d-a400-114de051cf49` |
+| `names` | `null` |
+| `level` | `3` |
+| `height` | `null` |
+| `is_underground` | `false` |
+| `num_floors` | `null` |
+| `num_floors_underground` | `null` |
+| `min_height` | `null` |
+| `min_floor` | `null` |
+| `facade_color` | `null` |
+| `facade_material` | `null` |
+| `roof_material` | `null` |
+| `roof_shape` | `null` |
+| `roof_direction` | `null` |
+| `roof_orientation` | `null` |
+| `roof_color` | `null` |
+| `roof_height` | `null` |
diff --git a/schema_versioned_docs/version-v1.18.0/reference/buildings/types/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/buildings/types/_category_.json
new file mode 100644
index 000000000..a3ec08974
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/buildings/types/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Types"
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/buildings/types/building_class.md b/schema_versioned_docs/version-v1.18.0/reference/buildings/types/building_class.md
new file mode 100644
index 000000000..7cdc52c0a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/buildings/types/building_class.md
@@ -0,0 +1,99 @@
+# BuildingClass
+
+Further classification of the type and purpose of a building.
+
+The building class adds detail to the broad classification of `BuildingSubtype`.
+
+## Values
+
+- `agricultural`
+- `allotment_house`
+- `apartments`
+- `barn`
+- `beach_hut`
+- `boathouse`
+- `bridge_structure`
+- `bungalow`
+- `bunker`
+- `cabin`
+- `carport`
+- `cathedral`
+- `chapel`
+- `church`
+- `civic`
+- `college`
+- `commercial`
+- `cowshed`
+- `detached`
+- `digester`
+- `dormitory`
+- `dwelling_house`
+- `factory`
+- `farm`
+- `farm_auxiliary`
+- `fire_station`
+- `garage`
+- `garages`
+- `ger`
+- `glasshouse`
+- `government`
+- `grandstand`
+- `greenhouse`
+- `guardhouse`
+- `hangar`
+- `hospital`
+- `hotel`
+- `house`
+- `houseboat`
+- `hut`
+- `industrial`
+- `kindergarten`
+- `kiosk`
+- `library`
+- `manufacture`
+- `military`
+- `monastery`
+- `mosque`
+- `office`
+- `outbuilding`
+- `parking`
+- `pavilion`
+- `post_office`
+- `presbytery`
+- `public`
+- `religious`
+- `residential`
+- `retail`
+- `roof`
+- `school`
+- `semi`
+- `semidetached_house`
+- `service`
+- `shed`
+- `shrine`
+- `silo`
+- `slurry_tank`
+- `sports_centre`
+- `sports_hall`
+- `stable`
+- `stadium`
+- `static_caravan`
+- `stilt_house`
+- `storage_tank`
+- `sty`
+- `supermarket`
+- `synagogue`
+- `temple`
+- `terrace`
+- `toilets`
+- `train_station`
+- `transformer_tower`
+- `transportation`
+- `trullo`
+- `university`
+- `warehouse`
+- `wayside_shrine`
+
+## Used By
+
+- [`Building`](../building.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/buildings/types/building_subtype.md b/schema_versioned_docs/version-v1.18.0/reference/buildings/types/building_subtype.md
new file mode 100644
index 000000000..7069cf95e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/buildings/types/building_subtype.md
@@ -0,0 +1,25 @@
+# BuildingSubtype
+
+Broadest classification of the type and purpose of a building.
+
+This broad classification can be refined by `BuildingClass`.
+
+## Values
+
+- `agricultural`
+- `civic`
+- `commercial`
+- `education`
+- `entertainment`
+- `industrial`
+- `medical`
+- `military`
+- `outbuilding`
+- `religious`
+- `residential`
+- `service`
+- `transportation`
+
+## Used By
+
+- [`Building`](../building.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/buildings/types/facade_material.md b/schema_versioned_docs/version-v1.18.0/reference/buildings/types/facade_material.md
new file mode 100644
index 000000000..13a5a8c41
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/buildings/types/facade_material.md
@@ -0,0 +1,22 @@
+# FacadeMaterial
+
+The outer surface material of building facade.
+
+## Values
+
+- `brick`
+- `cement_block`
+- `clay`
+- `concrete`
+- `glass`
+- `metal`
+- `plaster`
+- `plastic`
+- `stone`
+- `timber_framing`
+- `wood`
+
+## Used By
+
+- [`Building`](../building.md)
+- [`BuildingPart`](../building_part.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/buildings/types/roof_material.md b/schema_versioned_docs/version-v1.18.0/reference/buildings/types/roof_material.md
new file mode 100644
index 000000000..1efc1f022
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/buildings/types/roof_material.md
@@ -0,0 +1,25 @@
+# RoofMaterial
+
+The outermost material of the roof.
+
+## Values
+
+- `concrete`
+- `copper`
+- `eternit`
+- `glass`
+- `grass`
+- `gravel`
+- `metal`
+- `plastic`
+- `roof_tiles`
+- `slate`
+- `solar_panels`
+- `tar_paper`
+- `thatch`
+- `wood`
+
+## Used By
+
+- [`Building`](../building.md)
+- [`BuildingPart`](../building_part.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/buildings/types/roof_orientation.md b/schema_versioned_docs/version-v1.18.0/reference/buildings/types/roof_orientation.md
new file mode 100644
index 000000000..443af22a2
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/buildings/types/roof_orientation.md
@@ -0,0 +1,16 @@
+# RoofOrientation
+
+Orientation of the roof shape relative to the footprint shape.
+
+The members of this enumeration, `"across"` and `"along"`, are borrowed from the OpenStreetMap
+`roof:orientation=*` tag and have the same meanings as they do in OSM.
+
+## Values
+
+- `across` - The roof ridge runs perpendicular to the longer of the two building edges, parallel to the shorter
+- `along` - The roof ridge runs parallel to the longer of the two building edges
+
+## Used By
+
+- [`Building`](../building.md)
+- [`BuildingPart`](../building_part.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/buildings/types/roof_shape.md b/schema_versioned_docs/version-v1.18.0/reference/buildings/types/roof_shape.md
new file mode 100644
index 000000000..f1271e095
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/buildings/types/roof_shape.md
@@ -0,0 +1,25 @@
+# RoofShape
+
+The shape of the roof.
+
+## Values
+
+- `dome`
+- `flat`
+- `gabled`
+- `gambrel`
+- `half_hipped`
+- `hipped`
+- `mansard`
+- `onion`
+- `pyramidal`
+- `round`
+- `saltbox`
+- `sawtooth`
+- `skillion`
+- `spherical`
+
+## Used By
+
+- [`Building`](../building.md)
+- [`BuildingPart`](../building_part.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/common/_category_.json
new file mode 100644
index 000000000..44fea45e2
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Common",
+  "position": 7
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/cartographic_hints.md b/schema_versioned_docs/version-v1.18.0/reference/common/cartographic_hints.md
new file mode 100644
index 000000000..33c58438b
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/cartographic_hints.md
@@ -0,0 +1,18 @@
+# CartographicHints
+
+Cartographic hints for optimal use of Overture features in map-making.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `prominence` | [`Prominence`](prominence.md) (optional) | Subjective scale of feature significance or importance, with 1 being the least, and 100 being the most, significant.<br/><br/>This value can be used to help drive decisions about how and when to display a feature, and how to treat it relative to neighboring features.<br/><br/>When populated by Overture, this value is derived from various factors including, but not limited to: feature and subtype, population, and capital status. |
+| `min_zoom` | [`MinZoom`](min_zoom.md) (optional) | Recommended minimum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels below this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `max_zoom` | [`MaxZoom`](max_zoom.md) (optional) | Recommended maximum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels above this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `sort_key` | [`SortKey`](sort_key.md) (optional) | Integer indicating the recommended order in which to draw features.<br/><br/>Features with a lower number should be drawn "in front" of features with a higher number. |
+
+## Used By
+
+- [`Bathymetry`](../base/bathymetry.md)
+- [`Division`](../divisions/division.md)
+- [`LandCover`](../base/land_cover.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/common_names.md b/schema_versioned_docs/version-v1.18.0/reference/common/common_names.md
new file mode 100644
index 000000000..2d1950d78
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/common_names.md
@@ -0,0 +1,10 @@
+# CommonNames
+
+A mapping from language to the most commonly used or recognized name in that language.
+
+Underlying type: `map<`[`LanguageTag`](../system/language_tag.md)`,`[`StrippedString`](../system/stripped_string.md)`>`
+
+## Used By
+
+- [`Division`](../divisions/division.md)
+- [`Names`](names.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/confidence_score.md b/schema_versioned_docs/version-v1.18.0/reference/common/confidence_score.md
new file mode 100644
index 000000000..42256524e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/confidence_score.md
@@ -0,0 +1,15 @@
+# ConfidenceScore
+
+Confidence score between 0.0 and 1.0
+
+Underlying type: `float64`
+
+## Constraints
+
+- `≥ 0.0`
+- `≤ 1.0`
+
+## Used By
+
+- [`Place`](../places/place.md)
+- [`SourceItem`](source_item.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/feature_version.md b/schema_versioned_docs/version-v1.18.0/reference/common/feature_version.md
new file mode 100644
index 000000000..969394483
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/feature_version.md
@@ -0,0 +1,27 @@
+# FeatureVersion
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 0`
+- `≥ -2147483648` (from [`int32`](../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../system/primitive/primitives.md))
+
+## Used By
+
+- [`Address`](../addresses/address.md)
+- [`Bathymetry`](../base/bathymetry.md)
+- [`Building`](../buildings/building.md)
+- [`BuildingPart`](../buildings/building_part.md)
+- [`Connector`](../transportation/connector.md)
+- [`Division`](../divisions/division.md)
+- [`DivisionArea`](../divisions/division_area.md)
+- [`DivisionBoundary`](../divisions/division_boundary.md)
+- [`Infrastructure`](../base/infrastructure.md)
+- [`Land`](../base/land.md)
+- [`LandCover`](../base/land_cover.md)
+- [`LandUse`](../base/land_use.md)
+- [`Place`](../places/place.md)
+- [`Segment`](../transportation/segment.md)
+- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/length_unit.md b/schema_versioned_docs/version-v1.18.0/reference/common/length_unit.md
new file mode 100644
index 000000000..44750a380
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/length_unit.md
@@ -0,0 +1,19 @@
+# LengthUnit
+
+Unit of length.
+
+## Values
+
+- `in` - One inch in the imperial and US customary systems
+- `ft` - One foot in the imperial and US customary systems (12 inches)
+- `yd` - One yard in the imperial and US customary systems (three feet)
+- `mi` - One mile in the imperial and US customary systems (1,760 yards)
+- `cm` - One centimeter in the metric and SI systems
+- `m` - One meter in the metric and SI systems
+- `km` - One kilometer in the metric and SI systems
+
+## Used By
+
+- [`VehicleHeightSelector`](scoping/vehicle_height_selector.md)
+- [`VehicleLengthSelector`](scoping/vehicle_length_selector.md)
+- [`VehicleWidthSelector`](scoping/vehicle_width_selector.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/level.md b/schema_versioned_docs/version-v1.18.0/reference/common/level.md
new file mode 100644
index 000000000..dff9ca8a0
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/level.md
@@ -0,0 +1,20 @@
+# Level
+
+Z-order of the feature where 0 is visual level
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ -2147483648` (from [`int32`](../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../system/primitive/primitives.md))
+
+## Used By
+
+- [`Building`](../buildings/building.md)
+- [`BuildingPart`](../buildings/building_part.md)
+- [`Infrastructure`](../base/infrastructure.md)
+- [`Land`](../base/land.md)
+- [`LandUse`](../base/land_use.md)
+- [`LevelRule`](../transportation/types/level_rule.md)
+- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/max_zoom.md b/schema_versioned_docs/version-v1.18.0/reference/common/max_zoom.md
new file mode 100644
index 000000000..6f06fba07
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/max_zoom.md
@@ -0,0 +1,23 @@
+# MaxZoom
+
+Recommended maximum tile zoom level in which this feature should be displayed.
+
+It is recommended that the feature be hidden at zoom levels above this value.
+
+Zoom levels follow the Slippy Maps convention, documented in the following
+references:
+- [https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames](https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames)
+- [https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection](https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection)
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 0`
+- `≤ 23`
+- `≥ -2147483648` (from [`int32`](../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../system/primitive/primitives.md))
+
+## Used By
+
+- [`CartographicHints`](cartographic_hints.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/min_zoom.md b/schema_versioned_docs/version-v1.18.0/reference/common/min_zoom.md
new file mode 100644
index 000000000..f309c1e03
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/min_zoom.md
@@ -0,0 +1,23 @@
+# MinZoom
+
+Recommended minimum tile zoom level in which this feature should be displayed.
+
+It is recommended that the feature be hidden at zoom levels below this value.
+
+Zoom levels follow the Slippy Maps convention, documented in the following
+references:
+- [https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames](https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames)
+- [https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection](https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection)
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 0`
+- `≤ 23`
+- `≥ -2147483648` (from [`int32`](../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../system/primitive/primitives.md))
+
+## Used By
+
+- [`CartographicHints`](cartographic_hints.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/name_rule.md b/schema_versioned_docs/version-v1.18.0/reference/common/name_rule.md
new file mode 100644
index 000000000..4b1c0308b
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/name_rule.md
@@ -0,0 +1,32 @@
+# NameRule
+
+A rule that can be evaluated to determine the name in advanced scenarios.
+
+Name rules are used for cases where the primary name is not sufficient; the common name is not
+the right fit for the use case and another variant is needed; or where the name only applies in
+certain specific circumstances.
+
+Examples might include:
+- An official, alternate, or short name.
+- A name that only applies to part of a linear path like a road segment (geometric range
+  scoping).
+- A name that only applies to the left or right side of a linear path like a road segment (side
+  scoping).
+- A name that is only accepted by some political perspectives.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`StrippedString`](../system/stripped_string.md) | The actual name value.<br/><br/>*Minimum length: 1* |
+| `variant` | [`NameVariant`](name_variant.md) | The name variant for this name rule. |
+| `language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `perspectives` | [`Perspectives`](perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `perspectives.mode` | [`PerspectiveMode`](perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `between` | [`LinearlyReferencedRange`](scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `side` | [`Side`](scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+
+## Used By
+
+- [`Names`](names.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/name_variant.md b/schema_versioned_docs/version-v1.18.0/reference/common/name_variant.md
new file mode 100644
index 000000000..ea9fa475c
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/name_variant.md
@@ -0,0 +1,22 @@
+# NameVariant
+
+Name variant used in a `NameRule`.
+
+## Values
+
+- `common` - The most commonly used or recognized name for a feature in the specified language.
+
+In a `Names` value, most common names will appear in the `Names.common` field and will
+not need to be specified as `NameRule` values in `Names.rules`. This member of the
+enumeration should only be used to construct a `NameRule` if the common name needs to
+be scoped in some way and therefore cannot be accurately represented in `CommonNames`.
+- `official` - The legally or administratively recognized name, often used by government agencies or
+official documents.
+- `alternate` - An alternative name, which may be a historical name, a local colloquial name, or some
+other well-known name is not the common name.
+- `short` - An abbreviated or shortened version of the name, which may be an acronym or some other
+commonly-used short form. An example is "NYC" for New York City.
+
+## Used By
+
+- [`NameRule`](name_rule.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/names.md b/schema_versioned_docs/version-v1.18.0/reference/common/names.md
new file mode 100644
index 000000000..220658c59
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/names.md
@@ -0,0 +1,33 @@
+# Names
+
+Multilingual names container.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name.<br/><br/>*Minimum length: 1* |
+| `common` | [`CommonNames`](common_names.md) (map, optional) | |
+| `rules[]` | `list<`[`NameRule`](name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `rules[].variant` | [`NameVariant`](name_variant.md) | The name variant for this name rule. |
+| `rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `rules[].perspectives` | [`Perspectives`](perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `rules[].perspectives.mode` | [`PerspectiveMode`](perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `rules[].between` | [`LinearlyReferencedRange`](scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `rules[].side` | [`Side`](scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+
+## Used By
+
+- [`Brand`](../places/types/brand.md)
+- [`Building`](../buildings/building.md)
+- [`BuildingPart`](../buildings/building_part.md)
+- [`Division`](../divisions/division.md)
+- [`DivisionArea`](../divisions/division_area.md)
+- [`Infrastructure`](../base/infrastructure.md)
+- [`Land`](../base/land.md)
+- [`LandUse`](../base/land_use.md)
+- [`Place`](../places/place.md)
+- [`Segment`](../transportation/segment.md)
+- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/perspective_mode.md b/schema_versioned_docs/version-v1.18.0/reference/common/perspective_mode.md
new file mode 100644
index 000000000..af2f597ff
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/perspective_mode.md
@@ -0,0 +1,12 @@
+# PerspectiveMode
+
+Perspective mode for disputed names.
+
+## Values
+
+- `accepted_by`
+- `disputed_by`
+
+## Used By
+
+- [`Perspectives`](perspectives.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/perspectives.md b/schema_versioned_docs/version-v1.18.0/reference/common/perspectives.md
new file mode 100644
index 000000000..b5e634d91
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/perspectives.md
@@ -0,0 +1,16 @@
+# Perspectives
+
+Political perspectives container.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `mode` | [`PerspectiveMode`](perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+
+## Used By
+
+- [`Division`](../divisions/division.md)
+- [`DivisionBoundary`](../divisions/division_boundary.md)
+- [`NameRule`](name_rule.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/prominence.md b/schema_versioned_docs/version-v1.18.0/reference/common/prominence.md
new file mode 100644
index 000000000..524ec9790
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/prominence.md
@@ -0,0 +1,23 @@
+# Prominence
+
+Subjective scale of feature significance or importance, with 1 being the least, and
+100 being the most, significant.
+
+This value can be used to help drive decisions about how and when to display a
+feature, and how to treat it relative to neighboring features.
+
+When populated by Overture, this value is derived from various factors including,
+but not limited to: feature and subtype, population, and capital status.
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 1`
+- `≤ 100`
+- `≥ -2147483648` (from [`int32`](../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../system/primitive/primitives.md))
+
+## Used By
+
+- [`CartographicHints`](cartographic_hints.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/scoping/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/_category_.json
new file mode 100644
index 000000000..155d669bb
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Scoping"
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/scoping/heading.md b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/heading.md
new file mode 100644
index 000000000..e59a4600d
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/heading.md
@@ -0,0 +1,17 @@
+# Heading
+
+Travel direction along an oriented path: forward or backward.
+
+## Values
+
+- `forward`
+- `backward`
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`DestinationRule`](../../transportation/types/destination_rule.md)
+- [`DestinationRule.When`](../../transportation/types/destination_rule.when.md)
+- [`ProhibitedTransitionRule`](../../transportation/types/prohibited_transition_rule.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/scoping/linearly_referenced_position.md b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/linearly_referenced_position.md
new file mode 100644
index 000000000..605af6ee2
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/linearly_referenced_position.md
@@ -0,0 +1,15 @@
+# LinearlyReferencedPosition
+
+Represents a linearly-referenced position between 0% and 100% of the distance along a path such as a road segment or a river center-line segment.
+
+Underlying type: `float64`
+
+## Constraints
+
+- `≥ 0.0`
+- `≤ 1.0`
+
+## Used By
+
+- [`ConnectorReference`](../../transportation/types/connector_reference.md)
+- [`LinearlyReferencedRange`](linearly_referenced_range.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/scoping/linearly_referenced_range.md b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/linearly_referenced_range.md
new file mode 100644
index 000000000..b08f04917
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/linearly_referenced_range.md
@@ -0,0 +1,26 @@
+# LinearlyReferencedRange
+
+Represents a non-empty range of positions along a path as a pair linearly-referenced positions. For example, the pair [0.25, 0.5] represents the range beginning 25% of the distance from the start of the path and ending 50% of the distance from the path
+
+Underlying type: `list<float64>`
+
+## Constraints
+
+- Linear reference range constraint (0.0 to 1.0). (`LinearReferenceRangeConstraint`)
+- `≥ 0.0` (from [`LinearlyReferencedPosition`](linearly_referenced_position.md))
+- `≤ 1.0` (from [`LinearlyReferencedPosition`](linearly_referenced_position.md))
+
+## Used By
+
+- [`AccessRestrictionRule`](../../transportation/types/access_restriction_rule.md)
+- [`LevelRule`](../../transportation/types/level_rule.md)
+- [`NameRule`](../name_rule.md)
+- [`ProhibitedTransitionRule`](../../transportation/types/prohibited_transition_rule.md)
+- [`RailFlagRule`](../../transportation/types/rail_flag_rule.md)
+- [`RoadFlagRule`](../../transportation/types/road_flag_rule.md)
+- [`RouteReference`](../../transportation/types/route_reference.md)
+- [`SourceItem`](../source_item.md)
+- [`SpeedLimitRule`](../../transportation/types/speed_limit_rule.md)
+- [`SubclassRule`](../../transportation/types/subclass_rule.md)
+- [`SurfaceRule`](../../transportation/types/surface_rule.md)
+- [`WidthRule`](../../transportation/types/width_rule.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/scoping/opening_hours.md b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/opening_hours.md
new file mode 100644
index 000000000..da30697ee
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/opening_hours.md
@@ -0,0 +1,12 @@
+# OpeningHours
+
+Time span or time spans during which something is open or active, specified in the OpenStreetMap
+opening hours specification: [https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification](https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification).
+
+Underlying type: `string`
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/scoping/purpose_of_use.md b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/purpose_of_use.md
new file mode 100644
index 000000000..a91e74f92
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/purpose_of_use.md
@@ -0,0 +1,18 @@
+# PurposeOfUse
+
+Reason why a person or entity travelling on the transportation network is using a particular
+location.
+
+## Values
+
+- `as_customer`
+- `at_destination`
+- `to_deliver`
+- `to_farm`
+- `for_forestry`
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/scoping/recognized_status.md b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/recognized_status.md
new file mode 100644
index 000000000..52ce0c78c
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/recognized_status.md
@@ -0,0 +1,18 @@
+# RecognizedStatus
+
+Status of the person or entity travelling as recognized by authorities controlling the particular
+location.
+
+## Values
+
+- `as_permitted`
+- `as_private`
+- `as_disabled`
+- `as_employee`
+- `as_student`
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/scoping/side.md b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/side.md
new file mode 100644
index 000000000..e8a269ef7
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/side.md
@@ -0,0 +1,15 @@
+# Side
+
+The side, left or right, on which something appears relative to a facing or heading direction
+(*e.g.*, the side of a road relative to the road orientation), or relative to the direction of
+travel of a person or vehicle.
+
+## Values
+
+- `left` - On the left relative to the facing direction
+- `right` - On the right side relative to the facing direction
+
+## Used By
+
+- [`NameRule`](../name_rule.md)
+- [`Norms`](../../divisions/types/norms.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/scoping/travel_mode.md b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/travel_mode.md
new file mode 100644
index 000000000..1a2aa0b55
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/travel_mode.md
@@ -0,0 +1,25 @@
+# TravelMode
+
+Enumerates possible travel modes.
+
+Some modes represent groups of modes.
+
+## Values
+
+- `vehicle`
+- `motor_vehicle`
+- `car`
+- `truck`
+- `motorcycle`
+- `foot`
+- `bicycle`
+- `bus`
+- `hgv`
+- `hov`
+- `emergency`
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_axle_count_selector.md b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_axle_count_selector.md
new file mode 100644
index 000000000..461dd926a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_axle_count_selector.md
@@ -0,0 +1,17 @@
+# VehicleAxleCountSelector
+
+Selects vehicles based on the number of axles they have.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `dimension` | `"axle_count"` | |
+| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
+| `value` | [`uint8`](../../system/primitive/primitives.md) | Number of axles on the vehicle |
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_height_selector.md b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_height_selector.md
new file mode 100644
index 000000000..ba56f33d7
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_height_selector.md
@@ -0,0 +1,18 @@
+# VehicleHeightSelector
+
+Selects vehicles based on their height.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `dimension` | `"height"` | |
+| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
+| `value` | [`float64`](../../system/primitive/primitives.md) | Vehicle height selection threshold in the given `unit`<br/><br/>*`≥ 0`* |
+| `unit` | [`LengthUnit`](../length_unit.md) | Height unit in which `value` is expressed |
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_length_selector.md b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_length_selector.md
new file mode 100644
index 000000000..5a6e1c017
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_length_selector.md
@@ -0,0 +1,18 @@
+# VehicleLengthSelector
+
+Selects vehicles based on their length.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `dimension` | `"length"` | |
+| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
+| `value` | [`float64`](../../system/primitive/primitives.md) | Vehicle length selection threshold in the given `unit`<br/><br/>*`≥ 0`* |
+| `unit` | [`LengthUnit`](../length_unit.md) | Length unit in which `value` is expressed |
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_relation.md b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_relation.md
new file mode 100644
index 000000000..0ac89eddd
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_relation.md
@@ -0,0 +1,19 @@
+# VehicleRelation
+
+Relational operator, such as less than or equal to.
+
+## Values
+
+- `greater_than`
+- `greater_than_equal`
+- `equal`
+- `less_than`
+- `less_than_equal`
+
+## Used By
+
+- [`VehicleAxleCountSelector`](vehicle_axle_count_selector.md)
+- [`VehicleHeightSelector`](vehicle_height_selector.md)
+- [`VehicleLengthSelector`](vehicle_length_selector.md)
+- [`VehicleWeightSelector`](vehicle_weight_selector.md)
+- [`VehicleWidthSelector`](vehicle_width_selector.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_weight_selector.md b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_weight_selector.md
new file mode 100644
index 000000000..3e42bdce1
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_weight_selector.md
@@ -0,0 +1,18 @@
+# VehicleWeightSelector
+
+Selects vehicles based on their weight.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `dimension` | `"weight"` | |
+| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
+| `value` | [`float64`](../../system/primitive/primitives.md) | Vehicle weight selection threshold in the given `unit`<br/><br/>*`≥ 0`* |
+| `unit` | [`WeightUnit`](../weight_unit.md) | Weight unit in which `value` is expressed |
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_width_selector.md b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_width_selector.md
new file mode 100644
index 000000000..f86e41b3b
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/scoping/vehicle_width_selector.md
@@ -0,0 +1,18 @@
+# VehicleWidthSelector
+
+Selects vehicles based on their width.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `dimension` | `"width"` | |
+| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
+| `value` | [`float64`](../../system/primitive/primitives.md) | Vehicle width selection threshold in the given `unit`<br/><br/>*`≥ 0`* |
+| `unit` | [`LengthUnit`](../length_unit.md) | Width unit in which `value` is expressed |
+
+## Used By
+
+- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/sort_key.md b/schema_versioned_docs/version-v1.18.0/reference/common/sort_key.md
new file mode 100644
index 000000000..1c1187168
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/sort_key.md
@@ -0,0 +1,17 @@
+# SortKey
+
+Integer indicating the recommended order in which to draw features.
+
+Features with a lower number should be drawn "in front" of features with a higher
+number.
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ -2147483648` (from [`int32`](../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../system/primitive/primitives.md))
+
+## Used By
+
+- [`CartographicHints`](cartographic_hints.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/source_item.md b/schema_versioned_docs/version-v1.18.0/reference/common/source_item.md
new file mode 100644
index 000000000..c87e57fe7
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/source_item.md
@@ -0,0 +1,37 @@
+# SourceItem
+
+Specifies the source of the data used for a feature or one of its properties.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `dataset` | `string` | Name of the dataset where the source data can be found. |
+| `license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `confidence` | [`ConfidenceScore`](confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri).<br/><br/>*Minimum length: 1* |
+| `resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names).<br/><br/>*Minimum length: 1* |
+| `version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692).<br/><br/>*Minimum length: 1* |
+| `between` | [`LinearlyReferencedRange`](scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+
+## Used By
+
+- [`Address`](../addresses/address.md)
+- [`Bathymetry`](../base/bathymetry.md)
+- [`Building`](../buildings/building.md)
+- [`BuildingPart`](../buildings/building_part.md)
+- [`Connector`](../transportation/connector.md)
+- [`Division`](../divisions/division.md)
+- [`DivisionArea`](../divisions/division_area.md)
+- [`DivisionBoundary`](../divisions/division_boundary.md)
+- [`Infrastructure`](../base/infrastructure.md)
+- [`Land`](../base/land.md)
+- [`LandCover`](../base/land_cover.md)
+- [`LandUse`](../base/land_use.md)
+- [`Place`](../places/place.md)
+- [`Segment`](../transportation/segment.md)
+- [`Water`](../base/water.md)
+- [`Sources`](sources.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/sources.md b/schema_versioned_docs/version-v1.18.0/reference/common/sources.md
new file mode 100644
index 000000000..ac48419ef
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/sources.md
@@ -0,0 +1,28 @@
+# Sources
+
+Information about the source data used to assemble the feature.
+
+Underlying type: `list<`[`SourceItem`](source_item.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Address`](../addresses/address.md)
+- [`Bathymetry`](../base/bathymetry.md)
+- [`Building`](../buildings/building.md)
+- [`BuildingPart`](../buildings/building_part.md)
+- [`Connector`](../transportation/connector.md)
+- [`Division`](../divisions/division.md)
+- [`DivisionArea`](../divisions/division_area.md)
+- [`DivisionBoundary`](../divisions/division_boundary.md)
+- [`Infrastructure`](../base/infrastructure.md)
+- [`Land`](../base/land.md)
+- [`LandCover`](../base/land_cover.md)
+- [`LandUse`](../base/land_use.md)
+- [`Place`](../places/place.md)
+- [`Segment`](../transportation/segment.md)
+- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/speed_unit.md b/schema_versioned_docs/version-v1.18.0/reference/common/speed_unit.md
new file mode 100644
index 000000000..acfd44ac0
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/speed_unit.md
@@ -0,0 +1,12 @@
+# SpeedUnit
+
+Unit of speed.
+
+## Values
+
+- `mph` - Miles per hour
+- `km/h` - Kilometers per hour
+
+## Used By
+
+- [`Speed`](../transportation/types/speed.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/common/weight_unit.md b/schema_versioned_docs/version-v1.18.0/reference/common/weight_unit.md
new file mode 100644
index 000000000..f53cb2977
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/common/weight_unit.md
@@ -0,0 +1,17 @@
+# WeightUnit
+
+Unit of weight.
+
+## Values
+
+- `oz` - One ounce in the imperial and US customary systems
+- `lb` - One pound in the imperial and US customary systems
+- `st` - One short ton, or one ton in the US customary system (2,000 pounds)
+- `lt` - One long ton, or one ton in the imperial system (2,400 pounds)
+- `g` - One gram in the metric and SI systems
+- `kg` - One kilogram in the metric and SI systems
+- `t` - One tonne in the metric and SI systems
+
+## Used By
+
+- [`VehicleWeightSelector`](scoping/vehicle_weight_selector.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/divisions/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/divisions/_category_.json
new file mode 100644
index 000000000..51eecd257
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/divisions/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Divisions",
+  "position": 4
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/divisions/division.md b/schema_versioned_docs/version-v1.18.0/reference/divisions/division.md
new file mode 100644
index 000000000..82a8b06e8
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/divisions/division.md
@@ -0,0 +1,138 @@
+---
+sidebar_position: 1
+---
+
+# Division
+
+Divisions are recognized official or non-official organizations of people as seen from a given
+political perspective.
+
+Examples include countries, provinces, cities, towns, neighborhoods, etc.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `cartography` | [`CartographicHints`](../common/cartographic_hints.md) (optional) | Cartographic hints useful when including the feature in maps |
+| `cartography.prominence` | [`Prominence`](../common/prominence.md) (optional) | Subjective scale of feature significance or importance, with 1 being the least, and 100 being the most, significant.<br/><br/>This value can be used to help drive decisions about how and when to display a feature, and how to treat it relative to neighboring features.<br/><br/>When populated by Overture, this value is derived from various factors including, but not limited to: feature and subtype, population, and capital status. |
+| `cartography.min_zoom` | [`MinZoom`](../common/min_zoom.md) (optional) | Recommended minimum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels below this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `cartography.max_zoom` | [`MaxZoom`](../common/max_zoom.md) (optional) | Recommended maximum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels above this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `cartography.sort_key` | [`SortKey`](../common/sort_key.md) (optional) | Integer indicating the recommended order in which to draw features.<br/><br/>Features with a lower number should be drawn "in front" of features with a higher number. |
+| `names` | [`Names`](../common/names.md) | All known names by which the division is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Approximate location of a position commonly associated with the real-world entity modeled by the division feature.<br/><br/>*Allowed geometry types: Point* |
+| `theme` | `"divisions"` | |
+| `type` | `"division"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `subtype` | [`DivisionSubtype`](types/division_subtype.md) | A broad classification of the division (e.g., country, region, locality, etc.).<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`*<br/>*`parent_division_id` is required when `subtype` ≠ `country`*<br/>*`parent_division_id` is forbidden when `subtype` = `country`* |
+| `country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) | ISO 3166-1 alpha-2 country code of the country or country-like entity, that this division represents or belongs to.<br/><br/>If the entity this division represents has a country code, the country property contains it. If it does not, the country property contains the country code of the first division encountered by traversing the parent_division_id chain to the root.<br/><br/>For example: - The country value for the United States is 'US' - The country value for New York City is 'US' - The country value for Puerto Rico, a dependency of the US, is 'PR'. - The country value for San Juan, Puerto Rico is 'PR'.<br/><br/>If an entity has an internationally-recognized ISO 3166-1 alpha-2 country code, it should always be used. In cases where the schema requires the code but no internationally-recognized code is available, a synthetic code may be used provided it does not conflict with any internationally-recognized codes. |
+| `hierarchies[][]` | `list<`[`Hierarchy`](types/hierarchy.md)`>` | Hierarchies in which this division participates.<br/><br/>Every division participates in at least one hierarchy. Most participate in only one. Some divisions may participate in more than one hierarchy, for example if they are claimed by different parent divisions from different political perspectives; or if there are other real-world reasons why the division or one of its ancestors has multiple parents.<br/><br/>The first hierarchy in the list is the default hierarchy, and the second-to-last entry in the default hierarchy (if there is such an entry) always corresponds to the `parent_division_id` property. The ordering of hierarchies after the first one is arbitrary.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `hierarchies[][].division_id` | [`Id`](../system/ref/id.md) | ID of a division that is an ancestor of the current division.<br/><br/>In the context of division hierarchies, the ancestor divisions of a division include the division itself, and any other division that is an ancestor of the division's parent. |
+| `hierarchies[][].subtype` | [`DivisionSubtype`](types/division_subtype.md) | |
+| `hierarchies[][].name` | [`StrippedString`](../system/stripped_string.md) | Primary name of the division |
+| `parent_division_id` | [`Id`](../system/ref/id.md) (optional) | Division ID of this division's parent division.<br/><br/>Not allowed for top-level divisions (countries) and required for all other divisions.<br/><br/>The default parent division is the parent division as seen from the default political perspective, if there is one, and is otherwise chosen somewhat arbitrarily. The hierarchies property can be used to inspect the exhaustive list of parent divisions.<br/><br/>*References `Division` (hierarchy, child of)*<br/><br/>*`parent_division_id` is required when `subtype` ≠ `country`*<br/>*`parent_division_id` is forbidden when `subtype` = `country`* |
+| `admin_level` | [`AdminLevel`](types/admin_level.md) (optional) | Integer representing the division's position in its country's administrative hierarchy, where lower numbers correspond to higher level administrative units.<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`* |
+| `class` | [`DivisionClass`](types/division_class.md) (optional) | A more specific classification of the division than is provided by `subtype`. |
+| `local_type` | [`CommonNames`](../common/common_names.md) (map, optional) | Local name for the subtype property, optionally localized.<br/><br/>For example, the Canadian province of Quebec has the subtype `"region"`, but in the local administrative hierarchy it is referred to as a province. Similarly, the Canadian Yukon territory also has subtype `"region"`, but is locally called a territory.<br/><br/>This property is localized using a standard Overture names structure. So for example, in Switzerland the top-level administrative subdivision corresponding to subtype 'region' is the canton, which may be translated in each of Switzerland's official languages as, 'canton' in French, 'kanton' in German, 'cantone' in Italian, and 'chantun' in Romansh. |
+| `region` | [`RegionCode`](../system/region_code.md) (optional) | ISO 3166-2 principal subdivision code of the subdivision-like entity this division represents or belongs to.<br/><br/>If the entity this division represents has a principal subdivision code, the region property contains it. If it does not, the region property contains the principal subdivision code of the first division encountered by traversing the `parent_division_id` chain to the root.<br/><br/>For example: - The region value for the United States is omitted. - The region value for the U.S. state of New York is 'US-NY'. - The region value for New York City is 'US-NY', which it inherits from the state   of New York. - The region value for Puerto Rico is 'US-PR'. |
+| `perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which this division is considered to be an accurate representation.<br/><br/>If this property is absent, then this division is not known to be disputed from any political perspective. Consequently, there is only one division feature representing the entire real world entity.<br/><br/>If this property is present, it means the division represents one of several alternative perspectives on the same real-world entity.<br/><br/>There are two modes of perspective:<br/><br/>1. `accepted_by` means the representation of the division is accepted by the    listed entities and would be included on a map drawn from their perspective.<br/><br/>2. `disputed_by` means the representation of the division is disputed by the    listed entities and would be excluded from a map drawn from their perspective.<br/><br/>When drawing a map from the perspective of a given country, one would start by gathering all the undisputed divisions (with no `perspectives` property), and then adding to that first all divisions explicitly accepted by the country, and second all divisions not explicitly disputed by the country. |
+| `perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `norms` | [`Norms`](types/norms.md) (optional) | Collects information about local norms and rules within the division that are generally useful for mapping and map-related use cases.<br/><br/>If the norms property or a desired sub-property of the norms property is missing on a division, but at least one of its ancestor divisions has the norms property and the desired sub-property, then the value from the nearest ancestor division may be assumed. |
+| `norms.driving_side` | [`Side`](../common/scoping/side.md) (optional) | Side of the road on which vehicles drive in the division. |
+| `population` | [`int32`](../system/primitive/primitives.md) (optional) | Population of the division<br/><br/>*`≥ 0`* |
+| `capital_division_ids` | `list<`[`Id`](../system/ref/id.md)`>` (optional) | Division IDs of this division's capital divisions. If present, this property will refer to the division IDs of the capital cities, county seats, etc. of a division.<br/><br/>*References `Division` (hierarchy, has as capital)*<br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `capital_of_divisions[]` | `list<`[`CapitalOfDivisionItem`](types/capital_of_division_item.md)`>` (optional) | Division IDs and subtypes of divisions this division is a capital of.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `capital_of_divisions[].division_id` | [`Id`](../system/ref/id.md) | ID of the division whose capital is the current division. |
+| `capital_of_divisions[].subtype` | [`DivisionSubtype`](types/division_subtype.md) | |
+| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+
+## Constraints
+
+- `admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`
+- `parent_division_id` is required when `subtype` ≠ `country`
+- `parent_division_id` is forbidden when `subtype` = `country`
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `cartography.prominence` | `29` |
+| `cartography.min_zoom` | `null` |
+| `cartography.max_zoom` | `null` |
+| `cartography.sort_key` | `null` |
+| `names.primary` | `Sia'atoutai` |
+| `names.common` | `null` |
+| `id` | `350e85f6-68ba-4114-9906-c2844815988b` |
+| `bbox.xmin` | `-175.25515747070312` |
+| `bbox.ymin` | `-21.1353702545166` |
+| `bbox.xmax` | `-175.255126953125` |
+| `bbox.ymax` | `-21.13536834716797` |
+| `geometry` | `POINT (-175.2551522 -21.1353686)` |
+| `theme` | `divisions` |
+| `type` | `division` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `n3173231082@4` |
+| `sources[0].update_time` | `2014-12-18T09:17:03+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `subtype` | `locality` |
+| `country` | `TO` |
+| `hierarchies[0][0].division_id` | `fef8748b-0c91-46ad-9f2d-976d8d2de3e9` |
+| `hierarchies[0][0].subtype` | `country` |
+| `hierarchies[0][0].name` | `Tonga` |
+| `hierarchies[0][1].division_id` | `4d67561a-2292-41bd-8996-7853d276a42c` |
+| `hierarchies[0][1].subtype` | `region` |
+| `hierarchies[0][1].name` | `Tongatapu` |
+| `hierarchies[0][2].division_id` | `8730f0cc-d436-4f11-a7d3-49085813ef44` |
+| `hierarchies[0][2].subtype` | `county` |
+| `hierarchies[0][2].name` | `Vahe Kolomotu'a` |
+| `hierarchies[0][3].division_id` | `350e85f6-68ba-4114-9906-c2844815988b` |
+| `hierarchies[0][3].subtype` | `locality` |
+| `hierarchies[0][3].name` | `Sia'atoutai` |
+| `parent_division_id` | `8730f0cc-d436-4f11-a7d3-49085813ef44` |
+| `admin_level` | `null` |
+| `class` | `village` |
+| `local_type` | `{"en": "village"}` |
+| `region` | `TO-04` |
+| `perspectives` | `null` |
+| `norms` | `null` |
+| `population` | `534` |
+| `capital_division_ids` | `null` |
+| `capital_of_divisions` | `null` |
+| `wikidata` | `null` |
+| `names.rules[0].value` | `Nafualu` |
+| `names.rules[0].variant` | `alternate` |
+| `names.rules[0].language` | `null` |
+| `names.rules[0].perspectives` | `null` |
+| `names.rules[0].between` | `null` |
+| `names.rules[0].side` | `null` |
diff --git a/schema_versioned_docs/version-v1.18.0/reference/divisions/division_area.md b/schema_versioned_docs/version-v1.18.0/reference/divisions/division_area.md
new file mode 100644
index 000000000..d5bf67bfe
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/divisions/division_area.md
@@ -0,0 +1,94 @@
+---
+sidebar_position: 1
+---
+
+# DivisionArea
+
+Division areas are polygon features that represent the land or maritime area covered by a
+division.
+
+Each division area belongs to a division which it references by ID, and for which the division
+area provides an area polygon. For ease of use, every division area repeats the subtype, names,
+country, and region properties of the division it belongs to.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `names` | [`Names`](../common/names.md) | All known names by which the owning division is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | The area covered by the division with which this area feature is associated.<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
+| `theme` | `"divisions"` | |
+| `type` | `"division_area"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `subtype` | [`DivisionSubtype`](types/division_subtype.md) | A broad classification of the division this area belongs to (e.g., country, region, locality, etc.).<br/><br/>This value is the same as the owning division's `subtype`.<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`* |
+| `class` | [`AreaClass`](types/area_class.md) | A more specific classification of the division area than is provided by `subtype`. |
+| `is_land` | `boolean` (optional) | Flag indicating whether or not the feature geometry represents the land-clipped, non-maritime boundary. The geometry can be used for map rendering, cartographic display, and similar purposes.<br/><br/>*`strict=True`*<br/><br/>*At least one of `is_land`, `is_territorial` must be `true`* |
+| `is_territorial` | `boolean` (optional) | Flag indicating whether or not the feature geometry represents Overture's best approximation of the division's territorial boundary. For coastal places, this will tend to include the water area. The geometry can be used for data processing, reverse-geocoding, and similar purposes.<br/><br/>*`strict=True`*<br/><br/>*At least one of `is_land`, `is_territorial` must be `true`* |
+| `division_id` | [`Id`](../system/ref/id.md) | Division ID of the parent division of this area.<br/><br/>*References [`Division`](division.md) (hierarchy, child of)* |
+| `country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) | ISO 3166-1 alpha-2 country code of the division this area belongs to. |
+| `region` | [`RegionCode`](../system/region_code.md) (optional) | ISO 3166-2 principal subdivision code of the division this area belongs to. |
+| `admin_level` | [`AdminLevel`](types/admin_level.md) (optional) | Integer representing the division's position in its country's administrative hierarchy, where lower numbers correspond to higher level administrative units.<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`* |
+
+## Constraints
+
+- At least one of `is_land`, `is_territorial` must be `true`
+- `admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `names.primary` | `ʻEua` |
+| `names.common` | `null` |
+| `names.rules` | `null` |
+| `id` | `eb9b112f-ec3c-47f7-b519-6f9f2e6fc2bd` |
+| `bbox.xmin` | `-174.97535705566406` |
+| `bbox.ymin` | `-21.473018646240234` |
+| `bbox.xmax` | `-174.90040588378906` |
+| `bbox.ymax` | `-21.283489227294922` |
+| `geometry` | `MULTIPOLYGON (((-174.9553949 -21.4730179, -174.9514163 -21.4719978, -174.9520108 -21.4681253, -17...` |
+| `theme` | `divisions` |
+| `type` | `division_area` |
+| `version` | `2` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `r7247527@3` |
+| `sources[0].update_time` | `2020-12-30T18:41:56+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `subtype` | `region` |
+| `class` | `land` |
+| `is_land` | `true` |
+| `is_territorial` | `false` |
+| `division_id` | `21597af0-b564-463c-a356-42c29e712b7d` |
+| `country` | `TO` |
+| `region` | `TO-01` |
+| `admin_level` | `null` |
diff --git a/schema_versioned_docs/version-v1.18.0/reference/divisions/division_boundary.md b/schema_versioned_docs/version-v1.18.0/reference/divisions/division_boundary.md
new file mode 100644
index 000000000..a0eb2b4d2
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/divisions/division_boundary.md
@@ -0,0 +1,94 @@
+---
+sidebar_position: 1
+---
+
+# DivisionBoundary
+
+Boundaries represent borders between divisions of the same subtype.
+
+Some boundaries may be disputed by the divisions on one or both sides.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Boundary line or lines<br/><br/>*Allowed geometry types: LineString, MultiLineString* |
+| `theme` | `"divisions"` | |
+| `type` | `"division_boundary"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `subtype` | [`DivisionSubtype`](types/division_subtype.md) | A broad classification of the divisions this boundary separates (e.g., country, region, locality, etc.).<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`*<br/>*`country` is required when `subtype` ≠ `country`*<br/>*`country` is forbidden when `subtype` = `country`* |
+| `class` | [`BoundaryClass`](types/boundary_class.md) | The kind of boundary: land or maritime. |
+| `is_land` | `boolean` (optional) | Flag indicating whether or not the feature geometry represents the land-clipped, non-maritime boundary. The geometry can be used for map rendering, cartographic display, and similar purposes.<br/><br/>*`strict=True`*<br/><br/>*At least one of `is_land`, `is_territorial` must be `true`* |
+| `is_territorial` | `boolean` (optional) | Flag indicating whether or not the feature geometry represents Overture's best approximation of the division's territorial boundary. For coastal places, this will tend to include the water area. The geometry can be used for data processing, reverse-geocoding, and similar purposes.<br/><br/>*`strict=True`*<br/><br/>*At least one of `is_land`, `is_territorial` must be `true`* |
+| `division_ids` | `list<`[`Id`](../system/ref/id.md)`>` | Identifies the two divisions to the left and right, respectively, of the boundary line. The left- and right-hand sides of the boundary are considered from the perspective of a person standing on the line facing in the direction in which the geometry is oriented, i.e. facing toward the end of the line.<br/><br/>The first array element is the Overture ID of the left division. The second element is the Overture ID of the right division.<br/><br/>*References [`Division`](division.md) (composition, boundary of)*<br/>*Minimum length: 2*<br/>*Maximum length: 2*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) (optional) | ISO 3166-1 alpha-2 country code of the country or country-like entity that both sides of the boundary share.<br/><br/>This property will be present on boundaries between two regions, counties, or similar entities within the same country, but will not be present on boundaries between two countries or country-like entities.<br/><br/>*`country` is required when `subtype` ≠ `country`*<br/>*`country` is forbidden when `subtype` = `country`* |
+| `region` | [`RegionCode`](../system/region_code.md) (optional) | ISO 3166-2 principal subdivision code of the subdivision-like entity that both sides of the boundary share.<br/><br/>This property will be present on boundaries between two counties, localadmins or similar entities within the same principal subdivision, but will not be present on boundaries between different principal subdivisions or countries. |
+| `admin_level` | [`AdminLevel`](types/admin_level.md) (optional) | Integer representing the division's position in its country's administrative hierarchy, where lower numbers correspond to higher level administrative units.<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`* |
+| `is_disputed` | `boolean` (optional) | Flag indicating whether this boundary is either disputed outright or is a "best guess" in a case where the boundary between two divisions is unclear.<br/><br/>If the boundary is disputed outright, this flag is true and the entities disputing it are listed in the `perspectives` property. If the boundary is simply a "best guess", this flag is true but no disputing entities are listed in `perspectives`.<br/><br/>*`strict=True`* |
+| `perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which this division boundary is considered to be an accurate representation.<br/><br/>If this property is absent, then this boundary is not known to be disputed from any political perspective. Consequently, there is only one boundary feature representing the entire real world entity.<br/><br/>If this property is present, it means the boundary represents one of several alternative perspectives on the same real-world entity.<br/><br/>There are two modes of perspective:<br/><br/>1. `accepted_by` means the representation of the boundary is accepted by the    listed entities and would be included on a map drawn from their perspective.<br/><br/>2. `disputed_by` means the representation of the boundary is disputed by the    listed entities and would be excluded from a map drawn from their    perspective.<br/><br/>When drawing a map from the perspective of a given country, one would start by gathering all the undisputed boundaries (those with no `perspectives` value); and then adding to that: first, all boundaries explicitly accepted by the country, and second, all boundaries not explicitly disputed by the country. |
+| `perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+
+## Constraints
+
+- At least one of `is_land`, `is_territorial` must be `true`
+- `admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`
+- `country` is required when `subtype` ≠ `country`
+- `country` is forbidden when `subtype` = `country`
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `2bdf68e4-860d-3d8c-a472-ccf439a5302a` |
+| `bbox.xmin` | `-147.06483459472656` |
+| `bbox.ymin` | `-15.4231538772583` |
+| `bbox.xmax` | `-147.04847717285156` |
+| `bbox.ymax` | `-15.151169776916504` |
+| `geometry` | `LINESTRING (-147.064823 -15.4231537, -147.0519131 -15.2885069, -147.048482 -15.1511701)` |
+| `theme` | `divisions` |
+| `type` | `division_boundary` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `r6063055@9` |
+| `sources[0].update_time` | `2023-07-20T00:28:40+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `sources[1].property` |  |
+| `sources[1].dataset` | `OpenStreetMap` |
+| `sources[1].license` | `null` |
+| `sources[1].record_id` | `r6063063@12` |
+| `sources[1].update_time` | `2023-07-20T00:28:40+00:00` |
+| `sources[1].confidence` | `null` |
+| `sources[1].provider` | `null` |
+| `sources[1].resource` | `null` |
+| `sources[1].version` | `null` |
+| `sources[1].between` | `null` |
+| `subtype` | `county` |
+| `class` | `maritime` |
+| `is_land` | `false` |
+| `is_territorial` | `true` |
+| `division_ids` | `["ae266459-63a4-4508-8295-0101e27d039b", "d4a6873d-885a-4f2a-bc0f-37e9d9e874e4"]` |
+| `country` | `PF` |
+| `region` | `null` |
+| `admin_level` | `null` |
+| `is_disputed` | `false` |
+| `perspectives` | `null` |
diff --git a/schema_versioned_docs/version-v1.18.0/reference/divisions/types/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/_category_.json
new file mode 100644
index 000000000..a3ec08974
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Types"
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/divisions/types/admin_level.md b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/admin_level.md
new file mode 100644
index 000000000..98e38c849
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/admin_level.md
@@ -0,0 +1,19 @@
+# AdminLevel
+
+Integer representing the division's position in its country's administrative
+hierarchy, where lower numbers correspond to higher level administrative units.
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 0`
+- `≤ 16`
+- `≥ -2147483648` (from [`int32`](../../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../../system/primitive/primitives.md))
+
+## Used By
+
+- [`Division`](../division.md)
+- [`DivisionArea`](../division_area.md)
+- [`DivisionBoundary`](../division_boundary.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/divisions/types/area_class.md b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/area_class.md
new file mode 100644
index 000000000..b0367b2ca
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/area_class.md
@@ -0,0 +1,15 @@
+# AreaClass
+
+Further classification of a division area that is more specific than its `subtype`.
+
+A division area's `class` adds detail to the broad classification found in `DivisionSubtype`.
+
+## Values
+
+- `land` - The area does not extend beyond the coastline.
+- `maritime` - The area extends beyond the coastline, in most cases to the extent of the division's
+territorial sea, if it has one.
+
+## Used By
+
+- [`DivisionArea`](../division_area.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/divisions/types/boundary_class.md b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/boundary_class.md
new file mode 100644
index 000000000..9b2d103da
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/boundary_class.md
@@ -0,0 +1,13 @@
+# BoundaryClass
+
+The kind of boundary: land or maritime.
+
+## Values
+
+- `land` - None of the boundary geometry extends beyond the coastline of either associated
+division.
+- `maritime` - All the boundary geometry extends beyond the coastline of both associated divisions.
+
+## Used By
+
+- [`DivisionBoundary`](../division_boundary.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/divisions/types/capital_of_division_item.md b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/capital_of_division_item.md
new file mode 100644
index 000000000..f7c5f1c78
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/capital_of_division_item.md
@@ -0,0 +1,14 @@
+# CapitalOfDivisionItem
+
+A division of which the owning division is the capital, together with its subtype.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `division_id` | [`Id`](../../system/ref/id.md) | ID of the division whose capital is the current division.<br/><br/>*References [`Division`](../division.md) (hierarchy, capital of)* |
+| `subtype` | [`DivisionSubtype`](division_subtype.md) | |
+
+## Used By
+
+- [`Division`](../division.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/divisions/types/division_class.md b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/division_class.md
new file mode 100644
index 000000000..f7cac4560
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/division_class.md
@@ -0,0 +1,20 @@
+# DivisionClass
+
+Further classification of a division that is more specific than its `subtype`.
+
+A division's `class` adds detail to the broad classification found in `DivisionSubtype`.
+
+## Values
+
+- `megacity` - A very large city or metropolitan area, typically having a population of 10 million or
+more. Example: Tokyo, Japan.
+- `city` - A large, permanent human settlement. Example: Guadalajara, Mexico.
+- `town` - A medium-sized permanent human settlement that is smaller than a city, but larger than a
+village. Example: Walldürn, Germany.
+- `village` - A smallish permanent human settlement that is smaller than a town, but larger than a
+hamlet. Example: Wadi El Karm, Lebanon.
+- `hamlet` - A very small, isolated human settlement in a rural area. Example: Tjarnabyggð, Iceland.
+
+## Used By
+
+- [`Division`](../division.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/divisions/types/division_subtype.md b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/division_subtype.md
new file mode 100644
index 000000000..ad061cd7e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/division_subtype.md
@@ -0,0 +1,35 @@
+# DivisionSubtype
+
+Category of the division from a finite, hierarchical, ordered list of categories (e.g., country,
+region, locality, etc.) similar to a Who's on First placetype.
+
+## Values
+
+- `country` - Largest unit of independent sovereignty, e.g., the United States, France.
+- `dependency` - A place that is not exactly a sub-region of a country but is dependent on a parent
+country for defence, passport control, etc., e.g., Puerto Rico.
+- `macroregion` - A bundle of regions, e.g., England, Scotland, Île-de-France. These exist mainly in
+Europe.
+- `region` - A state, province, region, etc. Largest sub-country administrative unit in most
+countries, except those that have dependencies or macro-regions.
+- `macrocounty` - A bundle of counties, e.g. Inverness. These exist mainly in Europe.
+- `county` - Largest sub-region administrative unit in most countries, unless they have
+macrocounties.
+- `localadmin` - An administrative unit existing in some parts of the world that contains localities
+or populated places, e.g. département de Paris. Often the contained places do not
+have independent authority. Often, but not exclusively, found in Europe.
+- `locality` - A populated place that may or may not have its own administrative authority.
+- `borough` - A local government unit subordinate to a locality.
+- `macrohood` - A super-neighborhood that contains smaller divisions of type neighborhood, e.g.
+BoCaCa (Boerum Hill, Cobble Hill, and Carroll Gardens).
+- `neighborhood` - A neighborhood. Most neighborhoods will be just this, unless there's enough granular
+detail to justify introducing macrohood or microhood divisions.
+- `microhood` - A mini-neighborhood that is contained within a division of type neighborhood.
+
+## Used By
+
+- [`CapitalOfDivisionItem`](capital_of_division_item.md)
+- [`Division`](../division.md)
+- [`DivisionArea`](../division_area.md)
+- [`DivisionBoundary`](../division_boundary.md)
+- [`HierarchyItem`](hierarchy_item.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/divisions/types/hierarchy.md b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/hierarchy.md
new file mode 100644
index 000000000..22098138b
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/hierarchy.md
@@ -0,0 +1,21 @@
+# Hierarchy
+
+A hierarchy of divisions, with the first entry being a country; each subsequent
+entry, if any, being a division that is a direct child of the previous entry; and
+the last entry representing the division that contains the hierarchy.
+
+For example, a hierarchy for the United States is simply [United States]. A
+hierarchy for the U.S. state of New Hampshire would be
+[United States, New Hampshire], and a hierarchy for the city of Concord, NH would be
+[United States, New Hampshire, Merrimack County, Concord].
+
+Underlying type: `list<`[`HierarchyItem`](hierarchy_item.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Division`](../division.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/divisions/types/hierarchy_item.md b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/hierarchy_item.md
new file mode 100644
index 000000000..ffcf3aa94
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/hierarchy_item.md
@@ -0,0 +1,16 @@
+# HierarchyItem
+
+One division in a hierarchy.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `division_id` | [`Id`](../../system/ref/id.md) | ID of a division that is an ancestor of the current division.<br/><br/>In the context of division hierarchies, the ancestor divisions of a division include the division itself, and any other division that is an ancestor of the division's parent.<br/><br/>*References [`Division`](../division.md) (hierarchy, descendant of)* |
+| `subtype` | [`DivisionSubtype`](division_subtype.md) | |
+| `name` | [`StrippedString`](../../system/stripped_string.md) | Primary name of the division<br/><br/>*Minimum length: 1* |
+
+## Used By
+
+- [`Division`](../division.md)
+- [`Hierarchy`](hierarchy.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/divisions/types/norms.md b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/norms.md
new file mode 100644
index 000000000..be619f59c
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/divisions/types/norms.md
@@ -0,0 +1,13 @@
+# Norms
+
+Local norms and standards.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `driving_side` | [`Side`](../../common/scoping/side.md) (optional) | Side of the road on which vehicles drive in the division. |
+
+## Used By
+
+- [`Division`](../division.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/places/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/places/_category_.json
new file mode 100644
index 000000000..69d3715d6
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/places/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Places",
+  "position": 5
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/places/place.md b/schema_versioned_docs/version-v1.18.0/reference/places/place.md
new file mode 100644
index 000000000..2b8b2bd63
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/places/place.md
@@ -0,0 +1,121 @@
+---
+sidebar_position: 1
+---
+
+# Place
+
+Places are point representations of real-world facilities, businesses, services, or amenities.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Position of the place. Places are point geometries.<br/><br/>*Allowed geometry types: Point* |
+| `theme` | `"places"` | |
+| `type` | `"place"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `operating_status` | [`OperatingStatus`](types/operating_status.md) (optional) | An indication of whether a place is: in continued operation, in a temporary operating hiatus, or closed permanently.<br/><br/>This is not an indication of opening hours or that the place is open/closed at the current time-of-day or day-of-week.<br/><br/>When `operating_status` is `"permanently_closed"`, the `confidence` field will be set to 0. |
+| `categories` | [`Categories`](types/categories.md) (optional) | |
+| `categories.primary` | [`SnakeCaseString`](../system/snake_case_string.md) | The primary or main category of the place. |
+| `categories.alternate` | `list<`[`SnakeCaseString`](../system/snake_case_string.md)`>` (optional) | Alternate categories of the place.<br/><br/>Some places might fit into two categories, e.g., a book store and a coffee shop. In these cases, the primary category can be augmented with additional categories. |
+| `basic_category` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The basic level category of a place.<br/><br/>This field classifies places into categories at a level that most people find intuitive. The full list of possible values it may hold can be found at (TODO).<br/><br/>The basic level category, or simply basic category, is based on a cognitive science model use in taxonomy and ontology development. The idea is to provide the category name at the level of generality that is preferred by humans in learning and memory tasks. This category to be roughly in the middle of the general-to-specific category hierarchy.<br/><br/>The full list of basic level categories is available at https://docs.overturemaps.org/guides/places/ |
+| `taxonomy` | [`Taxonomy`](types/taxonomy.md) (optional) | A structured representation of the place's category within the Overture taxonomy.<br/><br/>Provides the primary classification, full hierarchy path, and alternate categories. |
+| `taxonomy.primary` | [`SnakeCaseString`](../system/snake_case_string.md) | The primary, or most specific, category known about this place.<br/><br/>The `primary` category value must always equal the last or rightmost entry in the `hierarchy` field. |
+| `taxonomy.hierarchy` | `list<`[`SnakeCaseString`](../system/snake_case_string.md)`>` | The full primary hierarchy of categories known for this place, ordered from most general to most specific. An example hierarchy might be: `["food_and_drink", "restaurant", "casual_eatery", "gas_station_sushi"]`.<br/><br/>The rightmost, or most specific, value in the `hierarchy` must always be equal to the `primary` field. The basic level category of the place will typically be found in the middle of the primary hierarchy. The primary hierarchy does not include any of the alternate categories found in the `alternates` field. |
+| `taxonomy.alternates` | `list<`[`SnakeCaseString`](../system/snake_case_string.md)`>` (optional) | Unordered list of additional categories that are known for this place but that are not part of the primary category hierarchy.<br/><br/>Alternate categories allow a more complete picture of the place to be surfaced when it fits multiple unconnected branches in the taxonomy. For example a gas station that also sells groceries might have primary category of "gas_station" with an alternate of "grocery_store".<br/><br/>Alternate categories are not part of the primary hierarchy or another alternate category's hierarchy. In other words, if a category is a parent in the hierarchy of another category, that category can't be a primary or alternate category itself.<br/><br/>Note as well that this field is an unordered list of extra categories and does not represent a hierarchy. |
+| `confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | A score between 0 and 1 indicating how confident we are that the place exists.<br/><br/>A confidence score of 0 indicates that we are certain the place doesn't exist anymore and will always be paired with an `operating_status` of `"permanently_closed"`.<br/><br/>A confidence score of 1 indicates that we are certain the place does exist.<br/><br/>If there is no value for confidence, it means we don't have enough information on which to estimate our confidence level. |
+| `websites` | `list<`[`HttpUrl`](../pydantic/networks/http_url.md)`>` (optional) | The websites of the place.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `socials` | `list<`[`HttpUrl`](../pydantic/networks/http_url.md)`>` (optional) | The social media URLs of the place.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `emails` | `list<`[`EmailStr`](../pydantic/networks/email_str.md)`>` (optional) | The email addresses of the place.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `phones` | `list<`[`PhoneNumber`](../system/phone_number.md)`>` (optional) | The phone numbers of the place.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `brand` | [`Brand`](types/brand.md) (optional) | The brand associated with the place. |
+| `brand.names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `brand.names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `brand.names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `brand.names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `brand.names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `brand.names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `brand.names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `brand.names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `brand.names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `brand.names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `brand.names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `brand.names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `brand.wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+| `addresses[]` | `list<`[`Address`](types/address.md)`>` (optional) | The address or addresses of the place<br/><br/>*Minimum length: 1* |
+| `addresses[].freeform` | `string` (optional) | Free-form address that contains street name, house number and other address info |
+| `addresses[].locality` | `string` (optional) | City, town, or neighborhood component of the place address |
+| `addresses[].postcode` | `string` (optional) | Postal code component of the place address |
+| `addresses[].region` | [`RegionCode`](../system/region_code.md) (optional) | An ISO 3166-2 principal subdivision code |
+| `addresses[].country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) (optional) | An ISO 3166-1 alpha-2 country code |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `99003ee6-e75b-4dd6-8a8a-53a5a716c50d` |
+| `bbox.xmin` | `-150.46875` |
+| `bbox.ymin` | `-79.17134094238281` |
+| `bbox.xmax` | `-150.46875` |
+| `bbox.ymax` | `-79.17133331298828` |
+| `geometry` | `POINT (-150.46875 -79.1713346)` |
+| `theme` | `places` |
+| `type` | `place` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `meta` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `107663894904826` |
+| `sources[0].update_time` | `2025-06-30T07:00:00+00:00` |
+| `sources[0].confidence` | `0.7337175792507205` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `operating_status` | `open` |
+| `categories.primary` | `hotel` |
+| `categories.alternate` | `null` |
+| `basic_category` | `null` |
+| `taxonomy` | `null` |
+| `confidence` | `0.7337175792507205` |
+| `websites` | `["https://www.superhotel.co.jp/s_hotels/beppu/"]` |
+| `socials` | `["https://www.facebook.com/107663894904826"]` |
+| `emails` | `null` |
+| `phones` | `["+81977009000"]` |
+| `brand.names.primary` | `SUPER HOTEL` |
+| `brand.names.common` | `null` |
+| `brand.names.rules` | `null` |
+| `brand.wikidata` | `null` |
+| `addresses[0].freeform` | `秋田県横手市駅前町１３−８` |
+| `addresses[0].locality` | `横手市` |
+| `addresses[0].postcode` | `013-0036` |
+| `addresses[0].region` | `null` |
+| `addresses[0].country` | `JP` |
+| `names.primary` | `スーパーホテル別府駅前` |
+| `names.common` | `null` |
+| `names.rules` | `null` |
diff --git a/schema_versioned_docs/version-v1.18.0/reference/places/types/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/places/types/_category_.json
new file mode 100644
index 000000000..a3ec08974
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/places/types/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Types"
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/places/types/address.md b/schema_versioned_docs/version-v1.18.0/reference/places/types/address.md
new file mode 100644
index 000000000..b64d5be16
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/places/types/address.md
@@ -0,0 +1,17 @@
+# Address
+
+An address associated with a place.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `freeform` | `string` (optional) | Free-form address that contains street name, house number and other address info |
+| `locality` | `string` (optional) | City, town, or neighborhood component of the place address |
+| `postcode` | `string` (optional) | Postal code component of the place address |
+| `region` | [`RegionCode`](../../system/region_code.md) (optional) | An ISO 3166-2 principal subdivision code |
+| `country` | [`CountryCodeAlpha2`](../../system/country_code_alpha2.md) (optional) | An ISO 3166-1 alpha-2 country code |
+
+## Used By
+
+- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/places/types/brand.md b/schema_versioned_docs/version-v1.18.0/reference/places/types/brand.md
new file mode 100644
index 000000000..65ebf269d
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/places/types/brand.md
@@ -0,0 +1,27 @@
+# Brand
+
+A brand associated with a place.
+
+A location with multiple brands is modeled as multiple separate places, each with its own brand.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `names` | [`Names`](../../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `wikidata` | [`WikidataId`](../../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+
+## Used By
+
+- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/places/types/categories.md b/schema_versioned_docs/version-v1.18.0/reference/places/types/categories.md
new file mode 100644
index 000000000..fbb5a64d2
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/places/types/categories.md
@@ -0,0 +1,16 @@
+# Categories
+
+Categories a place belongs to.
+
+Complete list is available on GitHub: [https://github.com/OvertureMaps/schema/blob/main/docs/schema/concepts/by-theme/places/overture_categories.csv](https://github.com/OvertureMaps/schema/blob/main/docs/schema/concepts/by-theme/places/overture_categories.csv)
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `primary` | [`SnakeCaseString`](../../system/snake_case_string.md) | The primary or main category of the place. |
+| `alternate` | `list<`[`SnakeCaseString`](../../system/snake_case_string.md)`>` (optional) | Alternate categories of the place.<br/><br/>Some places might fit into two categories, e.g., a book store and a coffee shop. In these cases, the primary category can be augmented with additional categories.<br/><br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+
+## Used By
+
+- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/places/types/operating_status.md b/schema_versioned_docs/version-v1.18.0/reference/places/types/operating_status.md
new file mode 100644
index 000000000..61b17c7fe
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/places/types/operating_status.md
@@ -0,0 +1,19 @@
+# OperatingStatus
+
+General indication of whether a place is: in continued operation, in a temporary operating
+hiatus, or closed permanently.
+
+Operating status should not be confused with opening hours or operating hours. In particular,
+the status `"open"` does not mean the place is open *right now*, it means that in general the
+place is continuing to operate normally, as opposed to being in an operating hiatus
+(`"temporarily_closed"`) or shuttered (`"permanently_closed"`).
+
+## Values
+
+- `open`
+- `permanently_closed`
+- `temporarily_closed`
+
+## Used By
+
+- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/places/types/taxonomy.md b/schema_versioned_docs/version-v1.18.0/reference/places/types/taxonomy.md
new file mode 100644
index 000000000..33f5b4da9
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/places/types/taxonomy.md
@@ -0,0 +1,17 @@
+# Taxonomy
+
+A structured representation of the place's category within the Overture taxonomy.
+
+Provides the primary classification, full hierarchy path, and alternate categories.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `primary` | [`SnakeCaseString`](../../system/snake_case_string.md) | The primary, or most specific, category known about this place.<br/><br/>The `primary` category value must always equal the last or rightmost entry in the `hierarchy` field. |
+| `hierarchy` | `list<`[`SnakeCaseString`](../../system/snake_case_string.md)`>` | The full primary hierarchy of categories known for this place, ordered from most general to most specific. An example hierarchy might be: `["food_and_drink", "restaurant", "casual_eatery", "gas_station_sushi"]`.<br/><br/>The rightmost, or most specific, value in the `hierarchy` must always be equal to the `primary` field. The basic level category of the place will typically be found in the middle of the primary hierarchy. The primary hierarchy does not include any of the alternate categories found in the `alternates` field.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `alternates` | `list<`[`SnakeCaseString`](../../system/snake_case_string.md)`>` (optional) | Unordered list of additional categories that are known for this place but that are not part of the primary category hierarchy.<br/><br/>Alternate categories allow a more complete picture of the place to be surfaced when it fits multiple unconnected branches in the taxonomy. For example a gas station that also sells groceries might have primary category of "gas_station" with an alternate of "grocery_store".<br/><br/>Alternate categories are not part of the primary hierarchy or another alternate category's hierarchy. In other words, if a category is a parent in the hierarchy of another category, that category can't be a primary or alternate category itself.<br/><br/>Note as well that this field is an unordered list of extra categories and does not represent a hierarchy.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+
+## Used By
+
+- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/pydantic/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/pydantic/_category_.json
new file mode 100644
index 000000000..6bc65c372
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/pydantic/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Pydantic",
+  "position": 8
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/pydantic/networks/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/pydantic/networks/_category_.json
new file mode 100644
index 000000000..8dc67bc4c
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/pydantic/networks/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Networks"
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/pydantic/networks/email_str.md b/schema_versioned_docs/version-v1.18.0/reference/pydantic/networks/email_str.md
new file mode 100644
index 000000000..3bf99260b
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/pydantic/networks/email_str.md
@@ -0,0 +1,7 @@
+# EmailStr
+
+See: [Pydantic docs](https://docs.pydantic.dev/latest/api/networks/#pydantic.networks.EmailStr)
+
+## Used By
+
+- [`Place`](../../places/place.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/pydantic/networks/http_url.md b/schema_versioned_docs/version-v1.18.0/reference/pydantic/networks/http_url.md
new file mode 100644
index 000000000..b4b25f0ef
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/pydantic/networks/http_url.md
@@ -0,0 +1,9 @@
+# HttpUrl
+
+A type that will accept any http or https URL.
+
+See: [Pydantic docs](https://docs.pydantic.dev/latest/api/networks/#pydantic.networks.HttpUrl)
+
+## Used By
+
+- [`Place`](../../places/place.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/system/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/system/_category_.json
new file mode 100644
index 000000000..22378997a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/system/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "System",
+  "position": 9
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/system/country_code_alpha2.md b/schema_versioned_docs/version-v1.18.0/reference/system/country_code_alpha2.md
new file mode 100644
index 000000000..815aaacfa
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/system/country_code_alpha2.md
@@ -0,0 +1,18 @@
+# CountryCodeAlpha2
+
+An ISO-3166-1 alpha-2 country code.
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only ISO 3166-1 alpha-2 country codes. (`CountryCodeAlpha2Constraint`, pattern: `^[A-Z]{2}$`)
+
+## Used By
+
+- [`Address`](../addresses/address.md)
+- [`Address`](../places/types/address.md)
+- [`Division`](../divisions/division.md)
+- [`DivisionArea`](../divisions/division_area.md)
+- [`DivisionBoundary`](../divisions/division_boundary.md)
+- [`Perspectives`](../common/perspectives.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/system/hex_color.md b/schema_versioned_docs/version-v1.18.0/reference/system/hex_color.md
new file mode 100644
index 000000000..a22c9c1fb
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/system/hex_color.md
@@ -0,0 +1,20 @@
+# HexColor
+
+A color represented as an #RRGGBB or #RGB hexadecimal string.
+
+For example:
+
+- `"#ff0000"` or `#f00` for pure red 🟥
+- `"#ffa500"` for bright orange 🟧
+- `"#000000"` or `"#000"` for black ⬛
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only hexadecimal color codes (e.g., #FF0000 or #FFF). (`HexColorConstraint`, pattern: `^#[0-9A-Fa-f]{3}([0-9A-Fa-f]{3})?$`)
+
+## Used By
+
+- [`Building`](../buildings/building.md)
+- [`BuildingPart`](../buildings/building_part.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/system/json_pointer.md b/schema_versioned_docs/version-v1.18.0/reference/system/json_pointer.md
new file mode 100644
index 000000000..6363abdc1
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/system/json_pointer.md
@@ -0,0 +1,23 @@
+# JsonPointer
+
+A JSON Pointer
+
+As described in `the JSON Pointer specification, RFC-6901`_.
+
+.. _the JSON Pointer specification, RFC-6901: [https://rfc-editor.org/rfc/rfc6901.html](https://rfc-editor.org/rfc/rfc6901.html)
+
+For example:
+
+- `""` (root value)
+- `"/connectors/"`
+- `"/connectors/0/at"`
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only valid JSON Pointer values (RFC 6901). (`JsonPointerConstraint`)
+
+## Used By
+
+- [`SourceItem`](../common/source_item.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/system/language_tag.md b/schema_versioned_docs/version-v1.18.0/reference/system/language_tag.md
new file mode 100644
index 000000000..c3145671a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/system/language_tag.md
@@ -0,0 +1,27 @@
+# LanguageTag
+
+A BCP-47 language tag.
+
+As described in `Tags for Identifying Languages, BCP-47`_.
+
+.. _Tags for Identifying Languages, BCP-47: [https://www.rfc-editor.org/rfc/bcp/bcp47.txt](https://www.rfc-editor.org/rfc/bcp/bcp47.txt)
+
+For example:
+
+- `"en"`
+- `"en-US"`
+- `"fr-CA"`
+- `"zh-Hant-TW"`
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only `BCP-47`_ language tags. (`LanguageTagConstraint`, pattern: `^(?:(?:[A-Za-z]{2,3}(?:-[A-Za-z]{3}){0,3}?)|(?:[A-Za-z]{4,8}))(?:-[A-Za-z]{4})?(?:-[A-Za-z]{2}|[0-9]{3})?(?:-(?:[A-Za-z0-9]{5,8}|[0-9][A-Za-z0-9]{3}))*(?:-[A-WY-Za-wy-z0-9](?:-[A-Za-z0-9]{2,8})+)*$`)
+
+## Used By
+
+- [`Division`](../divisions/division.md)
+- [`NameRule`](../common/name_rule.md)
+- [`Names`](../common/names.md)
+- [`CommonNames`](../common/common_names.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/system/no_whitespace_string.md b/schema_versioned_docs/version-v1.18.0/reference/system/no_whitespace_string.md
new file mode 100644
index 000000000..09c2186f1
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/system/no_whitespace_string.md
@@ -0,0 +1,14 @@
+# NoWhitespaceString
+
+A string that contains no whitespace characters.
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only strings that contain no whitespace characters. (`NoWhitespaceConstraint`, pattern: `^\S+$`)
+
+## Used By
+
+- [`SourceItem`](../common/source_item.md)
+- [`Id`](ref/id.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/system/phone_number.md b/schema_versioned_docs/version-v1.18.0/reference/system/phone_number.md
new file mode 100644
index 000000000..8bfed0469
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/system/phone_number.md
@@ -0,0 +1,13 @@
+# PhoneNumber
+
+An international phone number.
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only international phone numbers. (`PhoneNumberConstraint`, pattern: `^\+\d{1,3}[\s\-\(\)0-9]+$`)
+
+## Used By
+
+- [`Place`](../places/place.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/system/primitive/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/system/primitive/_category_.json
new file mode 100644
index 000000000..ee6c4309a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/system/primitive/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Primitive"
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/system/primitive/geometry.md b/schema_versioned_docs/version-v1.18.0/reference/system/primitive/geometry.md
new file mode 100644
index 000000000..25d26fde7
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/system/primitive/geometry.md
@@ -0,0 +1,11 @@
+# Geometry Types
+
+Spatial types for representing geographic features.
+
+## Types
+
+| Type | Description |
+| -----: | ------------- |
+| `Geometry` | GeoJSON geometry value (Point, LineString, Polygon, etc.) |
+| `BBox` | Bounding box as 4 or 6 coordinate values: [west, south, east, north] or [west, south, min-altitude, east, north, max-altitude] |
+| `GeometryType` | Enumeration of geometry types: `geometry_collection`, `line_string`, `multi_line_string`, `multi_point`, `multi_polygon`, `point`, `polygon` |
\ No newline at end of file
diff --git a/schema_versioned_docs/version-v1.18.0/reference/system/primitive/primitives.md b/schema_versioned_docs/version-v1.18.0/reference/system/primitive/primitives.md
new file mode 100644
index 000000000..8b0415a7d
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/system/primitive/primitives.md
@@ -0,0 +1,27 @@
+# Primitive Types
+
+Numeric types used for schema field definitions.
+
+## Integer Types
+
+| Type | Range | Description |
+| -----: | :-----: | ------------- |
+| `int8` | -128 to 127 | Portable 8-bit signed integer. |
+| `int16` | -32,768 to 32,767 | Portable 16-bit signed integer. |
+| `int32` | -2,147,483,648 to 2,147,483,647 | Portable 32-bit signed integer. |
+| `int64` | -2^63 to 2^63-1 | Portable 64-bit signed integer. |
+
+## Unsigned Integer Types
+
+| Type | Range | Description |
+| -----: | :-----: | ------------- |
+| `uint8` | 0 to 255 | Portable 8-bit unsigned integer. |
+| `uint16` | 0 to 65,535 | Portable 16-bit unsigned integer. |
+| `uint32` | 0 to 4,294,967,295 | Portable 32-bit unsigned integer. |
+
+## Floating Point Types
+
+| Type | Precision | Description |
+| -----: | :---------: | ------------- |
+| `float32` | ~7 decimal digits | Portable IEEE 32-bit floating point number. |
+| `float64` | ~15 decimal digits | Portable IEEE 64-bit floating point number. |
diff --git a/schema_versioned_docs/version-v1.18.0/reference/system/ref/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/system/ref/_category_.json
new file mode 100644
index 000000000..a3d90fc8f
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/system/ref/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Ref"
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/system/ref/id.md b/schema_versioned_docs/version-v1.18.0/reference/system/ref/id.md
new file mode 100644
index 000000000..59a1fc75a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/system/ref/id.md
@@ -0,0 +1,33 @@
+# Id
+
+A unique identifier.
+
+Underlying type: `string`
+
+## Constraints
+
+- Minimum length: 1
+- Allows only strings that contain no whitespace characters. (`NoWhitespaceConstraint`, pattern: `^\S+$`) (from [`NoWhitespaceString`](../no_whitespace_string.md))
+
+## Used By
+
+- [`Address`](../../addresses/address.md)
+- [`Bathymetry`](../../base/bathymetry.md)
+- [`Building`](../../buildings/building.md)
+- [`BuildingPart`](../../buildings/building_part.md)
+- [`CapitalOfDivisionItem`](../../divisions/types/capital_of_division_item.md)
+- [`Connector`](../../transportation/connector.md)
+- [`ConnectorReference`](../../transportation/types/connector_reference.md)
+- [`DestinationRule`](../../transportation/types/destination_rule.md)
+- [`Division`](../../divisions/division.md)
+- [`DivisionArea`](../../divisions/division_area.md)
+- [`DivisionBoundary`](../../divisions/division_boundary.md)
+- [`HierarchyItem`](../../divisions/types/hierarchy_item.md)
+- [`Infrastructure`](../../base/infrastructure.md)
+- [`Land`](../../base/land.md)
+- [`LandCover`](../../base/land_cover.md)
+- [`LandUse`](../../base/land_use.md)
+- [`Place`](../../places/place.md)
+- [`Segment`](../../transportation/segment.md)
+- [`SequenceEntry`](../../transportation/types/sequence_entry.md)
+- [`Water`](../../base/water.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/system/region_code.md b/schema_versioned_docs/version-v1.18.0/reference/system/region_code.md
new file mode 100644
index 000000000..bf2f016ee
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/system/region_code.md
@@ -0,0 +1,16 @@
+# RegionCode
+
+An ISO 3166-2 principal subdivision code.
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only ISO 3166-2 principal subdivision codes. (`RegionCodeConstraint`, pattern: `^[A-Z]{2}-[A-Z0-9]{1,3}$`)
+
+## Used By
+
+- [`Address`](../places/types/address.md)
+- [`Division`](../divisions/division.md)
+- [`DivisionArea`](../divisions/division_area.md)
+- [`DivisionBoundary`](../divisions/division_boundary.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/system/snake_case_string.md b/schema_versioned_docs/version-v1.18.0/reference/system/snake_case_string.md
new file mode 100644
index 000000000..4bfeb76e8
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/system/snake_case_string.md
@@ -0,0 +1,16 @@
+# SnakeCaseString
+
+A string that looks like a snake case identifier, like a Python variable name (*e.g.*, `foo_bar`).
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only strings that look like snake case identifiers, *e.g.* `"foo_bar"`. (`SnakeCaseConstraint`, pattern: `^[a-z0-9]+(_[a-z0-9]+)*$`)
+
+## Used By
+
+- [`Categories`](../places/types/categories.md)
+- [`Place`](../places/place.md)
+- [`SourceItem`](../common/source_item.md)
+- [`Taxonomy`](../places/types/taxonomy.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/system/stripped_string.md b/schema_versioned_docs/version-v1.18.0/reference/system/stripped_string.md
new file mode 100644
index 000000000..5600ca2d7
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/system/stripped_string.md
@@ -0,0 +1,22 @@
+# StrippedString
+
+A string without leading or trailing whitespace.
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only strings that have no leading/trailing whitespace. (`StrippedConstraint`, pattern: `^(\S(.*\S)?)?\Z`)
+
+## Used By
+
+- [`Address`](../addresses/address.md)
+- [`AddressLevel`](../addresses/types/address_level.md)
+- [`DestinationLabels`](../transportation/types/destination_labels.md)
+- [`Division`](../divisions/division.md)
+- [`HierarchyItem`](../divisions/types/hierarchy_item.md)
+- [`NameRule`](../common/name_rule.md)
+- [`Names`](../common/names.md)
+- [`RouteReference`](../transportation/types/route_reference.md)
+- [`SourceItem`](../common/source_item.md)
+- [`CommonNames`](../common/common_names.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/system/wikidata_id.md b/schema_versioned_docs/version-v1.18.0/reference/system/wikidata_id.md
new file mode 100644
index 000000000..ebef7cee6
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/system/wikidata_id.md
@@ -0,0 +1,23 @@
+# WikidataId
+
+A wikidata ID, as found on [https://www.wikidata.org/](https://www.wikidata.org/).
+
+- `"Q42"`
+- `"Q11643"`
+- `"Q116257497"`
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only Wikidata identifiers (Q followed by digits). (`WikidataIdConstraint`, pattern: `^Q\d+$`)
+
+## Used By
+
+- [`Brand`](../places/types/brand.md)
+- [`Division`](../divisions/division.md)
+- [`Infrastructure`](../base/infrastructure.md)
+- [`Land`](../base/land.md)
+- [`LandUse`](../base/land_use.md)
+- [`RouteReference`](../transportation/types/route_reference.md)
+- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/transportation/_category_.json
new file mode 100644
index 000000000..597025adb
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Transportation",
+  "position": 6
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/connector.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/connector.md
new file mode 100644
index 000000000..51f41cab3
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/connector.md
@@ -0,0 +1,55 @@
+---
+sidebar_position: 1
+---
+
+# Connector
+
+Connectors create physical connections between segments.
+
+Connectors are compatible with GeoJSON Point features.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Position of the connector<br/><br/>*Allowed geometry types: Point* |
+| `theme` | `"transportation"` | |
+| `type` | `"connector"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `39542bee-230f-4b91-b7e5-a9b58e0c59b1` |
+| `bbox.xmin` | `-176.54730224609375` |
+| `bbox.ymin` | `-43.96794891357422` |
+| `bbox.xmax` | `-176.54727172851562` |
+| `bbox.ymax` | `-43.96794128417969` |
+| `geometry` | `POINT (-176.5472979 -43.9679472)` |
+| `theme` | `transportation` |
+| `type` | `connector` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `null` |
+| `sources[0].update_time` | `null` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/segment.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/segment.md
new file mode 100644
index 000000000..328bbf2ba
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/segment.md
@@ -0,0 +1,174 @@
+---
+sidebar_position: 1
+---
+
+# Segment
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/primitive/geometry.md) | Segment centerline<br/><br/>*Allowed geometry types: LineString* |
+| `theme` | `"transportation"` | |
+| `type` | `"segment"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `subtype` | [`Subtype`](types/subtype.md) | Broad category of transportation segment. |
+| `access_restrictions[]` | [`AccessRules`](types/access_rules.md) (list, optional) | Rules governing access to this road segment |
+| `access_restrictions[].access_type` | [`AccessType`](types/access_type.md) | |
+| `access_restrictions[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing AccessRestrictionRule applies to. |
+| `access_restrictions[].when` | [`AccessRestrictionRule.When`](types/access_restriction_rule.when.md) (optional) | Scopes for AccessRestrictionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
+| `access_restrictions[].when.heading` | [`Heading`](../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing AccessRestrictionRule applies to. |
+| `access_restrictions[].when.during` | [`OpeningHours`](../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing AccessRestrictionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
+| `access_restrictions[].when.mode` | `list<`[`TravelMode`](../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing AccessRestrictionRule applies to. |
+| `access_restrictions[].when.using` | `list<`[`PurposeOfUse`](../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing AccessRestrictionRule applies to. |
+| `access_restrictions[].when.recognized` | `list<`[`RecognizedStatus`](../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing AccessRestrictionRule applies to. |
+| `access_restrictions[].when.vehicle` | [`VehicleAxleCountSelector`](../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing AccessRestrictionRule applies to. |
+| `connectors[]` | `list<`[`ConnectorReference`](types/connector_reference.md)`>` (optional) | List of connectors which this segment is physically connected to and their relative location. Each connector is a possible routing decision point, meaning it defines a place along the segment in which there is possibility to transition to other segments which share the same connector.<br/><br/>*Minimum length: 2*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `connectors[].connector_id` | [`Id`](../system/ref/id.md) | A unique identifier |
+| `connectors[].at` | [`LinearlyReferencedPosition`](../common/scoping/linearly_referenced_position.md) (optional) | The linearly-referenced position on the geometry, specified as a percentage displacement from the start of the geometry, that the containing ConnectorReference applies to. |
+| `level_rules[]` | [`LevelRules`](types/level_rules.md) (list, optional) | Defines the Z-order, i.e. stacking order, of the road segment. |
+| `level_rules[].value` | [`Level`](../common/level.md) | Z-order of the feature where 0 is visual level |
+| `level_rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing LevelRule applies to. |
+| `routes[]` | [`Routes`](types/routes.md) (list, optional) | Routes this segment belongs to |
+| `routes[].name` | [`StrippedString`](../system/stripped_string.md) (optional) | Full name of the route |
+| `routes[].network` | [`StrippedString`](../system/stripped_string.md) (optional) | Name of the highway system this route belongs to |
+| `routes[].ref` | [`StrippedString`](../system/stripped_string.md) (optional) | Code or number used to reference the route |
+| `routes[].symbol` | [`StrippedString`](../system/stripped_string.md) (optional) | URL or description of route signage |
+| `routes[].wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+| `routes[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RouteReference applies to. |
+| `subclass_rules[]` | [`SubclassRules`](types/subclass_rules.md) (list, optional) | Set of subclasses scoped along segment |
+| `subclass_rules[].value` | [`Subclass`](types/subclass.md) | |
+| `subclass_rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SubclassRule applies to. |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `class` *(Road)* | [`RoadClass`](types/road_class.md) | |
+| `destinations[]` *(Road)* | [`Destinations`](types/destinations.md) (list, optional) | Describes objects that can be reached by following a transportation segment in the same way those objects are described on signposts or ground writing that a traveller following the segment would observe in the real world. This allows navigation systems to refer to signs and observable writing that a traveller actually sees. |
+| `destinations[].from_connector_id` | [`Id`](../system/ref/id.md) | Identifies the point of physical connection on this segment before which the destination sign or marking is visible. |
+| `destinations[].to_connector_id` | [`Id`](../system/ref/id.md) | Identifies the point of physical connection on the segment identified by 'to_segment_id' to transition to for reaching the destination(s). |
+| `destinations[].to_segment_id` | [`Id`](../system/ref/id.md) | Identifies the segment to transition to reach the destination(s) labeled on the sign or marking. |
+| `destinations[].final_heading` | [`Heading`](../common/scoping/heading.md) | Direction of travel on the segment identified by 'to_segment_id' that leads to the destination. |
+| `destinations[].labels[]` | `list<`[`DestinationLabels`](types/destination_labels.md)`>` (optional) | Labeled destinations that can be reached by following the segment. |
+| `destinations[].labels[].value` | [`StrippedString`](../system/stripped_string.md) | Names the object that is reached |
+| `destinations[].labels[].type` | [`DestinationLabelType`](types/destination_label_type.md) | |
+| `destinations[].symbols` | `list<`[`DestinationSignSymbol`](types/destination_sign_symbol.md)`>` (optional) | A collection of symbols or icons present on the sign next to current destination label. |
+| `destinations[].when` | [`DestinationRule.When`](types/destination_rule.when.md) (optional) | Scope for DestinationRule: |
+| `destinations[].when.heading` | [`Heading`](../common/scoping/heading.md) | The heading, either forward or backward, that the containing DestinationRule applies to. |
+| `prohibited_transitions[]` *(Road)* | [`ProhibitedTransitions`](types/prohibited_transitions.md) (list, optional) | Rules preventing transitions from this segment to another segment. |
+| `prohibited_transitions[].sequence[]` | `list<`[`SequenceEntry`](types/sequence_entry.md)`>` | Ordered sequence of connector/segment pairs that it is prohibited to follow from this segment. |
+| `prohibited_transitions[].sequence[].connector_id` | [`Id`](../system/ref/id.md) | Identifies the point of physical connection between the previous segment in the sequence and the segment in this sequence entry. |
+| `prohibited_transitions[].sequence[].segment_id` | [`Id`](../system/ref/id.md) | Identifies the segment that the previous segment in the sequence is physically connected to via the sequence entry's connector. |
+| `prohibited_transitions[].final_heading` | [`Heading`](../common/scoping/heading.md) | Direction of travel that is prohibited on the destination segment of the sequence. |
+| `prohibited_transitions[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing ProhibitedTransitionRule applies to. |
+| `prohibited_transitions[].when` | [`ProhibitedTransitionRule.When`](types/prohibited_transition_rule.when.md) (optional) | Scopes for ProhibitedTransitionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
+| `prohibited_transitions[].when.heading` | [`Heading`](../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing ProhibitedTransitionRule applies to. |
+| `prohibited_transitions[].when.during` | [`OpeningHours`](../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing ProhibitedTransitionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
+| `prohibited_transitions[].when.mode` | `list<`[`TravelMode`](../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing ProhibitedTransitionRule applies to. |
+| `prohibited_transitions[].when.using` | `list<`[`PurposeOfUse`](../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing ProhibitedTransitionRule applies to. |
+| `prohibited_transitions[].when.recognized` | `list<`[`RecognizedStatus`](../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing ProhibitedTransitionRule applies to. |
+| `prohibited_transitions[].when.vehicle` | [`VehicleAxleCountSelector`](../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing ProhibitedTransitionRule applies to. |
+| `road_flags[]` *(Road)* | [`RoadFlags`](types/road_flags.md) (list, optional) | Set of boolean attributes applicable to roads. May be specified either as a single flag array of flag values, or as an array of flag rules. |
+| `road_flags[].values` | `list<`[`RoadFlag`](types/road_flag.md)`>` | |
+| `road_flags[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RoadFlagRule applies to. |
+| `road_surface[]` *(Road)* | [`Surfaces`](types/surfaces.md) (list, optional) | Physical surface of the road. May either be specified as a single global value for the segment, or as an array of surface rules. |
+| `road_surface[].value` | [`RoadSurface`](types/road_surface.md) | |
+| `road_surface[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SurfaceRule applies to. |
+| `speed_limits[]` *(Road)* | [`SpeedLimits`](types/speed_limits.md) (list, optional) | Rules governing speed on this road segment |
+| `speed_limits[].max_speed` | [`Speed`](types/speed.md) (optional) | |
+| `speed_limits[].max_speed.value` | [`SpeedValue`](types/speed_value.md) | Speed value |
+| `speed_limits[].max_speed.unit` | [`SpeedUnit`](../common/speed_unit.md) | |
+| `speed_limits[].min_speed` | [`Speed`](types/speed.md) (optional) | |
+| `speed_limits[].min_speed.value` | [`SpeedValue`](types/speed_value.md) | Speed value |
+| `speed_limits[].min_speed.unit` | [`SpeedUnit`](../common/speed_unit.md) | |
+| `speed_limits[].is_max_speed_variable` | `boolean` (optional) | Indicates a variable speed corridor |
+| `speed_limits[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SpeedLimitRule applies to. |
+| `speed_limits[].when` | [`SpeedLimitRule.When`](types/speed_limit_rule.when.md) (optional) | Scopes for SpeedLimitRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
+| `speed_limits[].when.heading` | [`Heading`](../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing SpeedLimitRule applies to. |
+| `speed_limits[].when.during` | [`OpeningHours`](../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing SpeedLimitRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
+| `speed_limits[].when.mode` | `list<`[`TravelMode`](../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing SpeedLimitRule applies to. |
+| `speed_limits[].when.using` | `list<`[`PurposeOfUse`](../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing SpeedLimitRule applies to. |
+| `speed_limits[].when.recognized` | `list<`[`RecognizedStatus`](../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing SpeedLimitRule applies to. |
+| `speed_limits[].when.vehicle` | [`VehicleAxleCountSelector`](../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing SpeedLimitRule applies to. |
+| `subclass` *(Road)* | [`Subclass`](types/subclass.md) (optional) | |
+| `width_rules[]` *(Road)* | [`WidthRules`](types/width_rules.md) (list, optional) | Edge-to-edge width of the road modeled by this segment, in meters.<br/><br/>Examples: (1) If this segment models a carriageway without sidewalk, this value represents the edge-to-edge width of the carriageway, inclusive of any shoulder. (2) If this segment models a sidewalk by itself, this value represents the edge-to-edge width of the sidewalk. (3) If this segment models a combined sidewalk and carriageway, this value represents the edge-to-edge width inclusive of sidewalk. |
+| `width_rules[].value` | [`Width`](types/width.md) | |
+| `width_rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing WidthRule applies to. |
+| `class` *(Rail)* | [`RailClass`](types/rail_class.md) | |
+| `rail_flags[]` *(Rail)* | [`RailFlags`](types/rail_flags.md) (list, optional) | Set of boolean attributes applicable to railways. May be specified either as a single flag array of flag values, or as an array of flag rules. |
+| `rail_flags[].values` | `list<`[`RailFlag`](types/rail_flag.md)`>` | |
+| `rail_flags[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RailFlagRule applies to. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `1bc62f3b-08b5-42b8-89fe-36f685f60455` |
+| `bbox.xmin` | `-176.5650177001953` |
+| `bbox.ymin` | `-43.954410552978516` |
+| `bbox.xmax` | `-176.56361389160156` |
+| `bbox.ymax` | `-43.953250885009766` |
+| `geometry` | `LINESTRING (-176.5636191 -43.954404, -176.5643637 -43.9538145, -176.5647264 -43.9535274, -176.564...` |
+| `theme` | `transportation` |
+| `type` | `segment` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `w53435546@6` |
+| `sources[0].update_time` | `2021-05-03T06:37:03+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `subtype` | `road` |
+| `access_restrictions` | `null` |
+| `connectors[0].connector_id` | `15b2c131-9137-4add-88c6-2acd3fa61355` |
+| `connectors[0].at` | `0.0` |
+| `connectors[1].connector_id` | `23ae2702-ef77-4d2e-b39d-77360b696d20` |
+| `connectors[1].at` | `0.523536154` |
+| `connectors[2].connector_id` | `8e944ce1-4b81-49eb-a823-7d98779c855c` |
+| `connectors[2].at` | `1.0` |
+| `level_rules` | `null` |
+| `routes` | `null` |
+| `subclass_rules` | `null` |
+| `names.primary` | `Meteorological Lane` |
+| `names.common` | `null` |
+| `destinations` | `null` |
+| `prohibited_transitions` | `null` |
+| `road_flags` | `null` |
+| `road_surface[0].value` | `gravel` |
+| `road_surface[0].between` | `null` |
+| `speed_limits` | `null` |
+| `subclass` | `null` |
+| `width_rules` | `null` |
+| `class` | `residential` |
+| `rail_flags` | `null` |
+| `names.rules[0].value` | `Meteorological Lane` |
+| `names.rules[0].variant` | `common` |
+| `names.rules[0].language` | `null` |
+| `names.rules[0].perspectives` | `null` |
+| `names.rules[0].between` | `null` |
+| `names.rules[0].side` | `null` |
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/_category_.json b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/_category_.json
new file mode 100644
index 000000000..a3ec08974
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Types"
+}
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/access_restriction_rule.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/access_restriction_rule.md
new file mode 100644
index 000000000..8324d767c
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/access_restriction_rule.md
@@ -0,0 +1,20 @@
+# AccessRestrictionRule
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `access_type` | [`AccessType`](access_type.md) | |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing AccessRestrictionRule applies to. |
+| `when` | [`AccessRestrictionRule.When`](access_restriction_rule.when.md) (optional) | Scopes for AccessRestrictionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
+| `when.heading` | [`Heading`](../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing AccessRestrictionRule applies to. |
+| `when.during` | [`OpeningHours`](../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing AccessRestrictionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
+| `when.mode` | `list<`[`TravelMode`](../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing AccessRestrictionRule applies to. |
+| `when.using` | `list<`[`PurposeOfUse`](../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing AccessRestrictionRule applies to. |
+| `when.recognized` | `list<`[`RecognizedStatus`](../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing AccessRestrictionRule applies to. |
+| `when.vehicle` | [`VehicleAxleCountSelector`](../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing AccessRestrictionRule applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`AccessRules`](access_rules.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/access_restriction_rule.when.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/access_restriction_rule.when.md
new file mode 100644
index 000000000..780d8ef3e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/access_restriction_rule.when.md
@@ -0,0 +1,22 @@
+# AccessRestrictionRule.When
+
+Scopes for AccessRestrictionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `heading` | [`Heading`](../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing AccessRestrictionRule applies to.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `during` | [`OpeningHours`](../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing AccessRestrictionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `mode` | `list<`[`TravelMode`](../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing AccessRestrictionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `using` | `list<`[`PurposeOfUse`](../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing AccessRestrictionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `recognized` | `list<`[`RecognizedStatus`](../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing AccessRestrictionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `vehicle` | [`VehicleAxleCountSelector`](../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing AccessRestrictionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+
+## Constraints
+
+- At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set
+
+## Used By
+
+- [`AccessRestrictionRule`](access_restriction_rule.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/access_rules.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/access_rules.md
new file mode 100644
index 000000000..1f3341a71
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/access_rules.md
@@ -0,0 +1,14 @@
+# AccessRules
+
+Rules governing access to this road segment
+
+Underlying type: `list<`[`AccessRestrictionRule`](access_restriction_rule.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/access_type.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/access_type.md
new file mode 100644
index 000000000..e77c8ab8a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/access_type.md
@@ -0,0 +1,11 @@
+# AccessType
+
+## Values
+
+- `allowed`
+- `denied`
+- `designated`
+
+## Used By
+
+- [`AccessRestrictionRule`](access_restriction_rule.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/connector_reference.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/connector_reference.md
new file mode 100644
index 000000000..632eed33a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/connector_reference.md
@@ -0,0 +1,15 @@
+# ConnectorReference
+
+Contains the GERS ID and relative position between 0 and 1 of a connector feature along the
+segment.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `connector_id` | [`Id`](../../system/ref/id.md) | A unique identifier<br/><br/>*References [`Connector`](../connector.md) (association, connects to)* |
+| `at` | [`LinearlyReferencedPosition`](../../common/scoping/linearly_referenced_position.md) (optional) | The linearly-referenced position on the geometry, specified as a percentage displacement from the start of the geometry, that the containing ConnectorReference applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_label_type.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_label_type.md
new file mode 100644
index 000000000..cf2ccb11f
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_label_type.md
@@ -0,0 +1,16 @@
+# DestinationLabelType
+
+Indicates what special symbol/icon is present on a signpost, visible as road marking or
+similar.
+
+## Values
+
+- `street`
+- `country`
+- `route_ref`
+- `toward_route_ref`
+- `unknown`
+
+## Used By
+
+- [`DestinationLabels`](destination_labels.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_labels.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_labels.md
new file mode 100644
index 000000000..578aaaace
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_labels.md
@@ -0,0 +1,14 @@
+# DestinationLabels
+
+The type of object of the destination label.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`StrippedString`](../../system/stripped_string.md) | Names the object that is reached<br/><br/>*Minimum length: 1* |
+| `type` | [`DestinationLabelType`](destination_label_type.md) | |
+
+## Used By
+
+- [`DestinationRule`](destination_rule.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_rule.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_rule.md
new file mode 100644
index 000000000..2c340c56e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_rule.md
@@ -0,0 +1,25 @@
+# DestinationRule
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `from_connector_id` | [`Id`](../../system/ref/id.md) | Identifies the point of physical connection on this segment before which the destination sign or marking is visible. |
+| `to_connector_id` | [`Id`](../../system/ref/id.md) | Identifies the point of physical connection on the segment identified by 'to_segment_id' to transition to for reaching the destination(s). |
+| `to_segment_id` | [`Id`](../../system/ref/id.md) | Identifies the segment to transition to reach the destination(s) labeled on the sign or marking. |
+| `final_heading` | [`Heading`](../../common/scoping/heading.md) | Direction of travel on the segment identified by 'to_segment_id' that leads to the destination. |
+| `labels[]` | `list<`[`DestinationLabels`](destination_labels.md)`>` (optional) | Labeled destinations that can be reached by following the segment.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `labels`, `symbols` must be set* |
+| `labels[].value` | [`StrippedString`](../../system/stripped_string.md) | Names the object that is reached |
+| `labels[].type` | [`DestinationLabelType`](destination_label_type.md) | |
+| `symbols` | `list<`[`DestinationSignSymbol`](destination_sign_symbol.md)`>` (optional) | A collection of symbols or icons present on the sign next to current destination label.<br/><br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `labels`, `symbols` must be set* |
+| `when` | [`DestinationRule.When`](destination_rule.when.md) (optional) | Scope for DestinationRule: |
+| `when.heading` | [`Heading`](../../common/scoping/heading.md) | The heading, either forward or backward, that the containing DestinationRule applies to. |
+
+## Constraints
+
+- At least one of `labels`, `symbols` must be set
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`Destinations`](destinations.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_rule.when.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_rule.when.md
new file mode 100644
index 000000000..0d48f31f3
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_rule.when.md
@@ -0,0 +1,13 @@
+# DestinationRule.When
+
+Scope for DestinationRule: 
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `heading` | [`Heading`](../../common/scoping/heading.md) | The heading, either forward or backward, that the containing DestinationRule applies to. |
+
+## Used By
+
+- [`DestinationRule`](destination_rule.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_sign_symbol.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_sign_symbol.md
new file mode 100644
index 000000000..ec81dbe19
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/destination_sign_symbol.md
@@ -0,0 +1,31 @@
+# DestinationSignSymbol
+
+Indicates what special symbol/icon is present on a signpost, visible as road marking or
+similar.
+
+## Values
+
+- `motorway`
+- `airport`
+- `hospital`
+- `center`
+- `industrial`
+- `parking`
+- `bus`
+- `train_station`
+- `rest_area`
+- `ferry`
+- `motorroad`
+- `fuel`
+- `viewpoint`
+- `fuel_diesel`
+- `food`
+- `lodging`
+- `info`
+- `camp_site`
+- `interchange`
+- `restrooms`
+
+## Used By
+
+- [`DestinationRule`](destination_rule.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/destinations.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/destinations.md
new file mode 100644
index 000000000..d2c434eb6
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/destinations.md
@@ -0,0 +1,9 @@
+# Destinations
+
+Describes objects that can be reached by following a transportation segment in the same way those objects are described on signposts or ground writing that a traveller following the segment would observe in the real world. This allows navigation systems to refer to signs and observable writing that a traveller actually sees.
+
+Underlying type: `list<`[`DestinationRule`](destination_rule.md)`>`
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/level_rule.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/level_rule.md
new file mode 100644
index 000000000..1612c0b2e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/level_rule.md
@@ -0,0 +1,16 @@
+# LevelRule
+
+A single level rule defining the Z-order, i.e. stacking order, applicable within a given scope
+on the road segment.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`Level`](../../common/level.md) | Z-order of the feature where 0 is visual level |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing LevelRule applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`LevelRules`](level_rules.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/level_rules.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/level_rules.md
new file mode 100644
index 000000000..f95284be6
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/level_rules.md
@@ -0,0 +1,9 @@
+# LevelRules
+
+Defines the Z-order, i.e. stacking order, of the road segment.
+
+Underlying type: `list<`[`LevelRule`](level_rule.md)`>`
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/prohibited_transition_rule.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/prohibited_transition_rule.md
new file mode 100644
index 000000000..a78a45c03
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/prohibited_transition_rule.md
@@ -0,0 +1,23 @@
+# ProhibitedTransitionRule
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `sequence[]` | `list<`[`SequenceEntry`](sequence_entry.md)`>` | Ordered sequence of connector/segment pairs that it is prohibited to follow from this segment.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `sequence[].connector_id` | [`Id`](../../system/ref/id.md) | Identifies the point of physical connection between the previous segment in the sequence and the segment in this sequence entry. |
+| `sequence[].segment_id` | [`Id`](../../system/ref/id.md) | Identifies the segment that the previous segment in the sequence is physically connected to via the sequence entry's connector. |
+| `final_heading` | [`Heading`](../../common/scoping/heading.md) | Direction of travel that is prohibited on the destination segment of the sequence. |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing ProhibitedTransitionRule applies to. |
+| `when` | [`ProhibitedTransitionRule.When`](prohibited_transition_rule.when.md) (optional) | Scopes for ProhibitedTransitionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
+| `when.heading` | [`Heading`](../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing ProhibitedTransitionRule applies to. |
+| `when.during` | [`OpeningHours`](../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing ProhibitedTransitionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
+| `when.mode` | `list<`[`TravelMode`](../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing ProhibitedTransitionRule applies to. |
+| `when.using` | `list<`[`PurposeOfUse`](../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing ProhibitedTransitionRule applies to. |
+| `when.recognized` | `list<`[`RecognizedStatus`](../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing ProhibitedTransitionRule applies to. |
+| `when.vehicle` | [`VehicleAxleCountSelector`](../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing ProhibitedTransitionRule applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`ProhibitedTransitions`](prohibited_transitions.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/prohibited_transition_rule.when.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/prohibited_transition_rule.when.md
new file mode 100644
index 000000000..1c38a5d60
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/prohibited_transition_rule.when.md
@@ -0,0 +1,22 @@
+# ProhibitedTransitionRule.When
+
+Scopes for ProhibitedTransitionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `heading` | [`Heading`](../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing ProhibitedTransitionRule applies to.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `during` | [`OpeningHours`](../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing ProhibitedTransitionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `mode` | `list<`[`TravelMode`](../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing ProhibitedTransitionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `using` | `list<`[`PurposeOfUse`](../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing ProhibitedTransitionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `recognized` | `list<`[`RecognizedStatus`](../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing ProhibitedTransitionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `vehicle` | [`VehicleAxleCountSelector`](../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing ProhibitedTransitionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+
+## Constraints
+
+- At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set
+
+## Used By
+
+- [`ProhibitedTransitionRule`](prohibited_transition_rule.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/prohibited_transitions.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/prohibited_transitions.md
new file mode 100644
index 000000000..2a4a5179e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/prohibited_transitions.md
@@ -0,0 +1,9 @@
+# ProhibitedTransitions
+
+Rules preventing transitions from this segment to another segment.
+
+Underlying type: `list<`[`ProhibitedTransitionRule`](prohibited_transition_rule.md)`>`
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/rail_class.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/rail_class.md
new file mode 100644
index 000000000..c43bb6a6a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/rail_class.md
@@ -0,0 +1,18 @@
+# RailClass
+
+Captures the kind of rail segment.
+
+## Values
+
+- `funicular`
+- `light_rail`
+- `monorail`
+- `narrow_gauge`
+- `standard_gauge`
+- `subway`
+- `tram`
+- `unknown`
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/rail_flag.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/rail_flag.md
new file mode 100644
index 000000000..9316a8129
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/rail_flag.md
@@ -0,0 +1,20 @@
+# RailFlag
+
+Simple flags that can be on or off for a railway segment.
+
+Specifies physical characteristics and can overlap.
+
+## Values
+
+- `is_bridge`
+- `is_tunnel`
+- `is_under_construction`
+- `is_abandoned`
+- `is_covered`
+- `is_passenger`
+- `is_freight`
+- `is_disused`
+
+## Used By
+
+- [`RailFlagRule`](rail_flag_rule.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/rail_flag_rule.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/rail_flag_rule.md
new file mode 100644
index 000000000..52273bde4
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/rail_flag_rule.md
@@ -0,0 +1,15 @@
+# RailFlagRule
+
+Rail-specific flag rule with geometric scoping only.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `values` | `list<`[`RailFlag`](rail_flag.md)`>` | *Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RailFlagRule applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`RailFlags`](rail_flags.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/rail_flags.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/rail_flags.md
new file mode 100644
index 000000000..806331852
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/rail_flags.md
@@ -0,0 +1,14 @@
+# RailFlags
+
+Set of boolean attributes applicable to railways. May be specified either as a single flag array of flag values, or as an array of flag rules.
+
+Underlying type: `list<`[`RailFlagRule`](rail_flag_rule.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_class.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_class.md
new file mode 100644
index 000000000..d18b7735a
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_class.md
@@ -0,0 +1,27 @@
+# RoadClass
+
+Captures the kind of road and its position in the road network hierarchy.
+
+## Values
+
+- `motorway`
+- `primary`
+- `secondary`
+- `tertiary`
+- `residential`
+- `living_street`
+- `trunk`
+- `unclassified`
+- `service`
+- `pedestrian`
+- `footway`
+- `steps`
+- `path`
+- `track`
+- `cycleway`
+- `bridleway`
+- `unknown`
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_flag.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_flag.md
new file mode 100644
index 000000000..a2448e725
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_flag.md
@@ -0,0 +1,19 @@
+# RoadFlag
+
+Simple flags that can be on or off for a road segment.
+
+Specifies physical characteristics and can overlap.
+
+## Values
+
+- `is_bridge`
+- `is_link`
+- `is_tunnel`
+- `is_under_construction`
+- `is_abandoned`
+- `is_covered`
+- `is_indoor`
+
+## Used By
+
+- [`RoadFlagRule`](road_flag_rule.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_flag_rule.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_flag_rule.md
new file mode 100644
index 000000000..4ff3120c9
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_flag_rule.md
@@ -0,0 +1,15 @@
+# RoadFlagRule
+
+Road-specific flag rule with geometric scoping only.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `values` | `list<`[`RoadFlag`](road_flag.md)`>` | *Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RoadFlagRule applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`RoadFlags`](road_flags.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_flags.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_flags.md
new file mode 100644
index 000000000..88445c57d
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_flags.md
@@ -0,0 +1,14 @@
+# RoadFlags
+
+Set of boolean attributes applicable to roads. May be specified either as a single flag array of flag values, or as an array of flag rules.
+
+Underlying type: `list<`[`RoadFlagRule`](road_flag_rule.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_surface.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_surface.md
new file mode 100644
index 000000000..6ac837769
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/road_surface.md
@@ -0,0 +1,17 @@
+# RoadSurface
+
+Physical surface of the road.
+
+## Values
+
+- `unknown`
+- `paved`
+- `unpaved`
+- `gravel`
+- `dirt`
+- `paving_stones`
+- `metal`
+
+## Used By
+
+- [`SurfaceRule`](surface_rule.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/route_reference.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/route_reference.md
new file mode 100644
index 000000000..4433bcf41
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/route_reference.md
@@ -0,0 +1,19 @@
+# RouteReference
+
+Route reference with linear referencing support.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `name` | [`StrippedString`](../../system/stripped_string.md) (optional) | Full name of the route<br/><br/>*Minimum length: 1* |
+| `network` | [`StrippedString`](../../system/stripped_string.md) (optional) | Name of the highway system this route belongs to<br/><br/>*Minimum length: 1* |
+| `ref` | [`StrippedString`](../../system/stripped_string.md) (optional) | Code or number used to reference the route<br/><br/>*Minimum length: 1* |
+| `symbol` | [`StrippedString`](../../system/stripped_string.md) (optional) | URL or description of route signage<br/><br/>*Minimum length: 1* |
+| `wikidata` | [`WikidataId`](../../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RouteReference applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`Routes`](routes.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/routes.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/routes.md
new file mode 100644
index 000000000..72143b256
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/routes.md
@@ -0,0 +1,9 @@
+# Routes
+
+Routes this segment belongs to
+
+Underlying type: `list<`[`RouteReference`](route_reference.md)`>`
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/sequence_entry.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/sequence_entry.md
new file mode 100644
index 000000000..859b96c5c
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/sequence_entry.md
@@ -0,0 +1,14 @@
+# SequenceEntry
+
+A segment/connector pair in a prohibited transition sequence.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `connector_id` | [`Id`](../../system/ref/id.md) | Identifies the point of physical connection between the previous segment in the sequence and the segment in this sequence entry. |
+| `segment_id` | [`Id`](../../system/ref/id.md) | Identifies the segment that the previous segment in the sequence is physically connected to via the sequence entry's connector. |
+
+## Used By
+
+- [`ProhibitedTransitionRule`](prohibited_transition_rule.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed.md
new file mode 100644
index 000000000..728a27352
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed.md
@@ -0,0 +1,14 @@
+# Speed
+
+A speed value, i.e. a certain number of distance units travelled per unit time.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`SpeedValue`](speed_value.md) | Speed value |
+| `unit` | [`SpeedUnit`](../../common/speed_unit.md) | |
+
+## Used By
+
+- [`SpeedLimitRule`](speed_limit_rule.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed_limit_rule.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed_limit_rule.md
new file mode 100644
index 000000000..ed02b113e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed_limit_rule.md
@@ -0,0 +1,32 @@
+# SpeedLimitRule
+
+An individual speed limit rule.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `max_speed` | [`Speed`](speed.md) (optional) | *At least one of `max_speed`, `min_speed` must be set* |
+| `max_speed.value` | [`SpeedValue`](speed_value.md) | Speed value |
+| `max_speed.unit` | [`SpeedUnit`](../../common/speed_unit.md) | |
+| `min_speed` | [`Speed`](speed.md) (optional) | *At least one of `max_speed`, `min_speed` must be set* |
+| `min_speed.value` | [`SpeedValue`](speed_value.md) | Speed value |
+| `min_speed.unit` | [`SpeedUnit`](../../common/speed_unit.md) | |
+| `is_max_speed_variable` | `boolean` (optional) | Indicates a variable speed corridor<br/><br/>*`strict=True`* |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SpeedLimitRule applies to. |
+| `when` | [`SpeedLimitRule.When`](speed_limit_rule.when.md) (optional) | Scopes for SpeedLimitRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
+| `when.heading` | [`Heading`](../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing SpeedLimitRule applies to. |
+| `when.during` | [`OpeningHours`](../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing SpeedLimitRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
+| `when.mode` | `list<`[`TravelMode`](../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing SpeedLimitRule applies to. |
+| `when.using` | `list<`[`PurposeOfUse`](../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing SpeedLimitRule applies to. |
+| `when.recognized` | `list<`[`RecognizedStatus`](../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing SpeedLimitRule applies to. |
+| `when.vehicle` | [`VehicleAxleCountSelector`](../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing SpeedLimitRule applies to. |
+
+## Constraints
+
+- At least one of `max_speed`, `min_speed` must be set
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`SpeedLimits`](speed_limits.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed_limit_rule.when.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed_limit_rule.when.md
new file mode 100644
index 000000000..f9a4b0918
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed_limit_rule.when.md
@@ -0,0 +1,22 @@
+# SpeedLimitRule.When
+
+Scopes for SpeedLimitRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `heading` | [`Heading`](../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing SpeedLimitRule applies to.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `during` | [`OpeningHours`](../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing SpeedLimitRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `mode` | `list<`[`TravelMode`](../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing SpeedLimitRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `using` | `list<`[`PurposeOfUse`](../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing SpeedLimitRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `recognized` | `list<`[`RecognizedStatus`](../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing SpeedLimitRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `vehicle` | [`VehicleAxleCountSelector`](../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing SpeedLimitRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+
+## Constraints
+
+- At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set
+
+## Used By
+
+- [`SpeedLimitRule`](speed_limit_rule.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed_limits.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed_limits.md
new file mode 100644
index 000000000..c42f47267
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed_limits.md
@@ -0,0 +1,14 @@
+# SpeedLimits
+
+Rules governing speed on this road segment
+
+Underlying type: `list<`[`SpeedLimitRule`](speed_limit_rule.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed_value.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed_value.md
new file mode 100644
index 000000000..8b4983f6b
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/speed_value.md
@@ -0,0 +1,16 @@
+# SpeedValue
+
+Speed value
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 1`
+- `≤ 350`
+- `≥ -2147483648` (from [`int32`](../../system/primitive/primitives.md))
+- `≤ 2147483647` (from [`int32`](../../system/primitive/primitives.md))
+
+## Used By
+
+- [`Speed`](speed.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/subclass.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/subclass.md
new file mode 100644
index 000000000..f91d5d42e
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/subclass.md
@@ -0,0 +1,18 @@
+# Subclass
+
+Refines expected usage of the segment, must not overlap.
+
+## Values
+
+- `link`
+- `sidewalk`
+- `crosswalk`
+- `parking_aisle`
+- `driveway`
+- `alley`
+- `cycle_crossing`
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`SubclassRule`](subclass_rule.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/subclass_rule.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/subclass_rule.md
new file mode 100644
index 000000000..3b67cc1db
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/subclass_rule.md
@@ -0,0 +1,15 @@
+# SubclassRule
+
+Set of subclasses scoped along segment.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`Subclass`](subclass.md) | |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SubclassRule applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`SubclassRules`](subclass_rules.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/subclass_rules.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/subclass_rules.md
new file mode 100644
index 000000000..a8322e9e1
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/subclass_rules.md
@@ -0,0 +1,9 @@
+# SubclassRules
+
+Set of subclasses scoped along segment
+
+Underlying type: `list<`[`SubclassRule`](subclass_rule.md)`>`
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/subtype.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/subtype.md
new file mode 100644
index 000000000..e24c2f7e4
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/subtype.md
@@ -0,0 +1,13 @@
+# Subtype
+
+Transportation segment subtype classification.
+
+## Values
+
+- `road`
+- `rail`
+- `water`
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/surface_rule.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/surface_rule.md
new file mode 100644
index 000000000..2b4e12ed9
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/surface_rule.md
@@ -0,0 +1,13 @@
+# SurfaceRule
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`RoadSurface`](road_surface.md) | |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SurfaceRule applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`Surfaces`](surfaces.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/surfaces.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/surfaces.md
new file mode 100644
index 000000000..846f48828
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/surfaces.md
@@ -0,0 +1,14 @@
+# Surfaces
+
+Physical surface of the road. May either be specified as a single global value for the segment, or as an array of surface rules.
+
+Underlying type: `list<`[`SurfaceRule`](surface_rule.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/width.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/width.md
new file mode 100644
index 000000000..c7e6d5ec4
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/width.md
@@ -0,0 +1,11 @@
+# Width
+
+Underlying type: `float64`
+
+## Constraints
+
+- `> 0`
+
+## Used By
+
+- [`WidthRule`](width_rule.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/width_rule.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/width_rule.md
new file mode 100644
index 000000000..5b954eebe
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/width_rule.md
@@ -0,0 +1,13 @@
+# WidthRule
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`Width`](width.md) | |
+| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing WidthRule applies to. |
+
+## Used By
+
+- [`Segment`](../segment.md)
+- [`WidthRules`](width_rules.md)
diff --git a/schema_versioned_docs/version-v1.18.0/reference/transportation/types/width_rules.md b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/width_rules.md
new file mode 100644
index 000000000..1c5cbf035
--- /dev/null
+++ b/schema_versioned_docs/version-v1.18.0/reference/transportation/types/width_rules.md
@@ -0,0 +1,16 @@
+# WidthRules
+
+Edge-to-edge width of the road modeled by this segment, in meters.
+
+Examples: (1) If this segment models a carriageway without sidewalk, this value represents the edge-to-edge width of the carriageway, inclusive of any shoulder. (2) If this segment models a sidewalk by itself, this value represents the edge-to-edge width of the sidewalk. (3) If this segment models a combined sidewalk and carriageway, this value represents the edge-to-edge width inclusive of sidewalk.
+
+Underlying type: `list<`[`WidthRule`](width_rule.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v2.0.0/index.md b/schema_versioned_docs/version-v2.0.0/index.md
new file mode 100644
index 000000000..234c9dc12
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/index.md
@@ -0,0 +1,58 @@
+---
+id: index
+slug: /
+title: Schema Reference
+sidebar_label: Overview
+description: Pydantic schemas for Overture Maps data
+pagination_label: Schema Reference Overview
+---
+
+# Overture Maps Schema
+
+:::note
+This section has been recently updated to reflect changes in our schema modeling. We welcome your feedback in [GitHub Discussions](https://github.com/OvertureMaps/data/discussions).
+:::
+
+The Overture Maps schema defines the structure, properties, and constraints for all features across six themes: addresses, base, buildings, divisions, places, and transportation. The reference pages in this section document the theme-based and shared modules in the schema.
+
+The schema is authored as [Pydantic](https://docs.pydantic.dev/) models and the reference documentation is generated from those models. The source code lives in the [OvertureMaps/schema](https://github.com/OvertureMaps/schema) repository on GitHub.
+
+:::tip[Found an error on this page?]
+This page is generated from the Pydantic models in [OvertureMaps/schema](https://github.com/OvertureMaps/schema/issues). Please file an issue there for changes.
+:::
+
+## Why Use Pydantic to Define Data Schemas?
+
+This project addresses a fundamental challenge in data consumption: bridging the semantic gap between raw data and human understanding while enabling machine-actionable workflows.
+
+## Why Schema at All: Beyond Raw Data
+
+Take a column like `pop_2020`. Is it total population? Population density per square kilometer? Working-age population? Without a schema, you're left sampling values and guessing from column names.
+
+Compare this to OpenStreetMap's approach: features use well-known key-value pairs like `building=residential` or `addr:housenumber=42` that have semantic meaning and can be looked up on the OSM wiki. This creates a step toward a schema — shared vocabulary with documented semantics used across a vast dataset. However, OSM tags remain free-form: multiple valid ways to express the same concept, no built-in validation, and complex downstream validation because of undocumented keys that might have meaning to someone, somewhere. A schema provides the structured alternative: explicit types, clear validation rules, and semantic meaning that both humans and systems can rely on.
+
+Data files containing only column names and values aren't fully documented. External metadata files typically focus on how data was collected and encoded, not on semantic meaning or validation rules. Data consumers struggle to understand what datasets contain and which columns they need for their goals.
+
+## Why Pydantic Over JSON Schema: Solving Multiple Problems
+
+We initially chose JSON Schema because it aligned with our mental model and promised to solve our problems as we understood them. But JSON Schema surfaced several pain points:
+
+- **Authoring difficulty:** Hard to write correctly, difficult to verify, limited IDE support, no refactoring capabilities
+- **Tooling gaps:** Generic tools can't tailor output for specific applications like ours
+- **Development friction:** Schema changes required manual coordination across multiple artifacts
+
+Pydantic addresses these systematically: author in Python with full IDE support, generate tailored documentation, and automatically produce the specific artifacts each workflow needs. Pydantic can also produce JSON Schema, so any application that requires it can use it while we gain all the Python benefits during authoring.
+
+## The Result: Faster Understanding, Higher Quality
+
+Instead of spending time deciphering what columns mean and whether data matches expectations, users can focus on their actual goals: analysis, visualization, integration. Quality improves because validation happens automatically rather than through manual inspection.
+
+The fundamental approach — human-readable authoring that generates machine-actionable outputs — has broader applications beyond Overture and geospatial data. We hope others will adapt these patterns for linking with Overture data or modeling their own domains entirely.
+
+## Schema Modules
+
+Browse the schema reference in the sidebar. Modules are organized by theme and shared components:
+
+**Themes:** Addresses, Base, Buildings, Divisions, Places, Transportation
+
+**Shared:** Core (names, sources, cartographic hints), System (country codes, language tags, geometry primitives)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/addresses/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/addresses/_category_.json
new file mode 100644
index 000000000..29c13add5
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/addresses/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Addresses",
+  "position": 1
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/addresses/address.md b/schema_versioned_docs/version-v2.0.0/reference/addresses/address.md
new file mode 100644
index 000000000..713959798
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/addresses/address.md
@@ -0,0 +1,82 @@
+---
+sidebar_position: 1
+---
+
+# Address
+
+Addresses are structured labels for the geographic locations where businesses and individuals
+reside.
+
+While address formats around the world have some general points in common, the specifics vary
+extensively from place to place. The rules for dividing an address up into parts or fields vary,
+as do the names of those parts or fields.
+
+The address schema uses a simplified approach to capture the common structure of addresses
+worldwide while accommodating local variance. The schema is heavily based on the OpenAddresses
+([www.openaddresses.io](https://www.openaddresses.io)) project.
+
+For sub-country administrative levels (and non-administrative levels such as neighborhoods), the
+schema provides the `address_levels` field. This is where the names of cities and towns,
+provinces, state, and regions, and similar addressing units are found.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/geometric.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/geometric.md) | Position of the address. Addresses are point geometries.<br/><br/>*Allowed geometry types: Point* |
+| `theme` | `"addresses"` | |
+| `type` | `"address"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` (optional) | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `address_levels[]` | `list<`[`AddressLevel`](types/address_level.md)`>` (optional) | Names of the sub-country addressing areas the address belongs to, including the city or locality, in descending order of generality.<br/><br/>The list is sorted so that the highest, or most general, level comes first (*e.g.*, region) and the lowest, or most particular level, comes last (*e.g.*, city or town).<br/><br/>The number of items in this list and their meaning is country-dependent. For example, in the United States, we expect two items: the state, and the locality or municipality within the state. Other countries might have as few as one, or even three or more.<br/><br/>When a specific level that is required for a country is not known. most likely because the data provider has not supplied it and we have not derived it from another source, the list item corresponding to that level must be present, but its `value` field should be omitted.<br/><br/>*Minimum length: 1*<br/>*Maximum length: 5* |
+| `address_levels[].value` | [`StrippedString`](../system/stripped_string.md) (optional) | A string without leading or trailing whitespace |
+| `country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) | The country the address belongs to, as an ISO 3166-1 alpha-2 country code. |
+| `number` | [`StrippedString`](../system/stripped_string.md) (optional) | The house number.<br/><br/>This field does not necessarily contain an integer or even a number. Values such as "74B", "189 1/2", and "208.5", where the non-integer or non-number part is part of the house number, not a unit number, are in common use.<br/><br/>*Minimum length: 1* |
+| `postal_city` | [`StrippedString`](../system/stripped_string.md) (optional) | The postal authority designated city name, if applicable.<br/><br/>In some countries or regions, a mailing address may need to specify a different city name than the city that actually contains the address coordinates. This optional field can be used to specify the alternate city name to use.<br/><br/>For example:<br/><br/>- The postal city for the US address *716 East County Road, Winchester, Indiana*   is Ridgeville. - The postal city for the Slovenian address *Tomaj 71, 6221 Tomaj, Slovenia* is   Dutovlje.<br/><br/>*Minimum length: 1* |
+| `postcode` | [`StrippedString`](../system/stripped_string.md) (optional) | The postal code.<br/><br/>*Minimum length: 1* |
+| `street` | [`StrippedString`](../system/stripped_string.md) (optional) | The street name.<br/><br/>The street name can include a type (*e.g.*, "Street" or "St", "Boulevard" or "Blvd", *etc.*) and a directional (*e.g.*, "NW" or "Northwest", "S" or "Sud"). Both type and directional, if present, may be either a prefix or a suffix to the primary name. They may either be fully spelled-out or abbreviated.<br/><br/>*Minimum length: 1* |
+| `unit` | [`StrippedString`](../system/stripped_string.md) (optional) | The secondary address unit designator.<br/><br/>In the case where the primary street address is divided into secondary units, which may be apartments, floors, or even buildings if the primary street address is a campus, this field names the specific secondary unit being addressed.<br/><br/>*Minimum length: 1* |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `416ab01c-d836-4c4f-aedc-2f30941ce94d` |
+| `bbox.xmin` | `-176.56381225585938` |
+| `bbox.ymin` | `-43.94719696044922` |
+| `bbox.xmax` | `-176.56378173828125` |
+| `bbox.ymax` | `-43.94718933105469` |
+| `geometry` | `POINT (-176.5637854 -43.9471955)` |
+| `theme` | `addresses` |
+| `type` | `address` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenAddresses/LINZ` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `null` |
+| `sources[0].update_time` | `null` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `address_levels[0].value` | `Chatham Islands` |
+| `address_levels[1].value` | `Chatham Island` |
+| `country` | `NZ` |
+| `number` | `54` |
+| `postal_city` | `null` |
+| `postcode` | `null` |
+| `street` | `Tikitiki Hill Road` |
+| `unit` | `null` |
diff --git a/schema_versioned_docs/version-v2.0.0/reference/addresses/types/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/addresses/types/_category_.json
new file mode 100644
index 000000000..a3ec08974
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/addresses/types/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Types"
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/addresses/types/address_level.md b/schema_versioned_docs/version-v2.0.0/reference/addresses/types/address_level.md
new file mode 100644
index 000000000..b0762021c
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/addresses/types/address_level.md
@@ -0,0 +1,26 @@
+# AddressLevel
+
+A sub-country addressing unit, such as a region, city, or neighborhood, that is less specific
+than a street name and not a postal code.
+
+In the following address, the terms `Montréal` and `QC` are address levels:
+
+```
+3998 Rue De Bullion, Montréal, QC H2W 2E4
+```
+
+The number of address levels per address is country-dependent.
+
+Other addressing systems may use the terms "administrative level" or "admin level"  for the
+same concept. We have chosen the term "address level" to communicate the fact that in some
+countries and regions, address levels do not necessarily correspond to administrative units.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`StrippedString`](../../system/stripped_string.md) (optional) | A string without leading or trailing whitespace<br/><br/>*Minimum length: 1* |
+
+## Used By
+
+- [`Address`](../address.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/base/_category_.json
new file mode 100644
index 000000000..b6b444780
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Base",
+  "position": 2
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/bathymetry.md b/schema_versioned_docs/version-v2.0.0/reference/base/bathymetry.md
new file mode 100644
index 000000000..d74e8501a
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/bathymetry.md
@@ -0,0 +1,65 @@
+---
+sidebar_position: 1
+---
+
+# Bathymetry
+
+Bathymetry features provide topographic representations of underwater areas, such as parts of
+lake beds or ocean floors.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/geometric.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/geometric.md) | Shape of the underwater area, which may be a polygon or multi-polygon.<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
+| `theme` | `"base"` | |
+| `type` | `"bathymetry"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` (optional) | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `depth` | [`Depth`](types/depth.md) | Depth below surface level of the feature in meters. |
+| `cartography` | [`CartographicHints`](../common/cartographic_hints.md) (optional) | Cartographic hints useful when including the feature in maps |
+| `cartography.prominence` | [`Prominence`](../common/prominence.md) (optional) | Subjective scale of feature significance or importance, with 1 being the least, and 100 being the most, significant.<br/><br/>This value can be used to help drive decisions about how and when to display a feature, and how to treat it relative to neighboring features.<br/><br/>When populated by Overture, this value is derived from various factors including, but not limited to: feature and subtype, population, and capital status. |
+| `cartography.min_zoom` | [`MinZoom`](../common/min_zoom.md) (optional) | Recommended minimum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels below this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `cartography.max_zoom` | [`MaxZoom`](../common/max_zoom.md) (optional) | Recommended maximum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels above this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `cartography.sort_key` | [`SortKey`](../common/sort_key.md) (optional) | Integer indicating the recommended order in which to draw features.<br/><br/>Features with a lower number should be drawn "in front" of features with a higher number. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `5d40bd6c-db14-5492-b29f-5e25a59032bc` |
+| `bbox.xmin` | `-175.12791442871094` |
+| `bbox.ymin` | `-77.9718246459961` |
+| `bbox.xmax` | `-170.05111694335938` |
+| `bbox.ymax` | `-75.64299774169922` |
+| `geometry` | `MULTIPOLYGON (((-170.71296928 -76.744313428, -170.719841483 -76.757076376, -170.731061124 -76.761...` |
+| `theme` | `base` |
+| `type` | `bathymetry` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `ETOPO/GLOBathy` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `2024-12-09T00:00:00.000Z` |
+| `sources[0].update_time` | `null` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `depth` | `500` |
+| `cartography.prominence` | `null` |
+| `cartography.min_zoom` | `null` |
+| `cartography.max_zoom` | `null` |
+| `cartography.sort_key` | `12` |
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/infrastructure.md b/schema_versioned_docs/version-v2.0.0/reference/base/infrastructure.md
new file mode 100644
index 000000000..f8cd7d8ad
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/infrastructure.md
@@ -0,0 +1,83 @@
+---
+sidebar_position: 1
+---
+
+# Infrastructure
+
+Infrastructure features provide basic information about real-world infrastructure entities
+such as bridges, airports, runways, aerialways, communication towers, and power lines.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/geometric.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/geometric.md) | Geometry of the infrastructure feature, which may be a point, line string, polygon, or multi-polygon.<br/><br/>*Allowed geometry types: LineString, MultiPolygon, Point, Polygon* |
+| `theme` | `"base"` | |
+| `type` | `"infrastructure"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` (optional) | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `class` | [`InfrastructureClass`](types/infrastructure_class.md) | |
+| `subtype` | [`InfrastructureSubtype`](types/infrastructure_subtype.md) | |
+| `height` | [`Height`](types/height.md) (optional) | Height of the feature in meters. |
+| `surface` | [`SurfaceMaterial`](types/surface_material.md) (optional) | |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level. A feature without a level is at visual level. |
+| `source_tags` | [`SourceTags`](types/source_tags.md) (map, optional) | Key/value pairs imported directly from the source data without change.<br/><br/>This field provides access to raw OSM entity tags for features sourced from OpenStreetMap. |
+| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `e9e3d506-89c0-3473-8cee-5e5ac6596d6c` |
+| `bbox.xmin` | `-180.0` |
+| `bbox.ymin` | `-82.42408752441406` |
+| `bbox.xmax` | `-179.99998474121094` |
+| `bbox.ymax` | `-82.42407989501953` |
+| `geometry` | `POINT (-179.9999994 -82.42408)` |
+| `theme` | `base` |
+| `type` | `infrastructure` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `n7674174803@2` |
+| `sources[0].update_time` | `2023-04-07T17:37:48+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `class` | `information` |
+| `subtype` | `pedestrian` |
+| `height` | `null` |
+| `surface` | `null` |
+| `names.primary` | `1306 km to South Pole` |
+| `names.common` | `null` |
+| `names.rules` | `null` |
+| `level` | `null` |
+| `source_tags` | `{"description": "1036 km to South Pole.", "information": "route_marker", "note": "The road contin...` |
+| `wikidata` | `Q800558` |
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/land.md b/schema_versioned_docs/version-v2.0.0/reference/base/land.md
new file mode 100644
index 000000000..9c8bdfcf1
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/land.md
@@ -0,0 +1,93 @@
+---
+sidebar_position: 1
+---
+
+# Land
+
+Land features are representations of physical land surfaces.
+
+In Overture data releases, land features are sourced from OpenStreetMap. TODO. Finish this when
+I get more info from Jennings.
+
+
+
+Physical representations of land surfaces.
+
+Global land derived from the inverse of OSM Coastlines. Translates `natural` tags from OpenStreetMap.
+
+TODO: Update this description when the relationship to `land_cover` is better understood.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/geometric.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/geometric.md) | Geometry of the land feature, which may be a point, line string, polygon, or multi-polygon.<br/><br/>*Allowed geometry types: LineString, MultiPolygon, Point, Polygon* |
+| `theme` | `"base"` | |
+| `type` | `"land"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` (optional) | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `class` | [`LandClass`](types/land_class.md) | |
+| `subtype` | [`LandSubtype`](types/land_subtype.md) | |
+| `elevation` | [`Elevation`](types/elevation.md) (optional) | Elevation above sea level of the feature in meters. |
+| `surface` | [`SurfaceMaterial`](types/surface_material.md) (optional) | |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level. A feature without a level is at visual level. |
+| `source_tags` | [`SourceTags`](types/source_tags.md) (map, optional) | Key/value pairs imported directly from the source data without change.<br/><br/>This field provides access to raw OSM entity tags for features sourced from OpenStreetMap. |
+| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `70fc3596-a987-3fea-820c-c016c0a2f0da` |
+| `bbox.xmin` | `-178.7000274658203` |
+| `bbox.ymin` | `-85.45001220703125` |
+| `bbox.xmax` | `-178.6999969482422` |
+| `bbox.ymax` | `-85.44999694824219` |
+| `geometry` | `POINT (-178.7 -85.45)` |
+| `theme` | `base` |
+| `type` | `land` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `n11693475112@1` |
+| `sources[0].update_time` | `2024-03-05T09:23:39+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `class` | `cliff` |
+| `subtype` | `physical` |
+| `elevation` | `null` |
+| `surface` | `null` |
+| `names.primary` | `Dismal Buttress` |
+| `names.common` | `null` |
+| `names.rules` | `null` |
+| `level` | `null` |
+| `source_tags` | `{"natural": "cliff", "ref:linz:place_id": "12318", "wikipedia": "en:Dismal Buttress"}` |
+| `wikidata` | `Q5282342` |
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/land_cover.md b/schema_versioned_docs/version-v2.0.0/reference/base/land_cover.md
new file mode 100644
index 000000000..9495bc1ba
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/land_cover.md
@@ -0,0 +1,72 @@
+---
+sidebar_position: 1
+---
+
+# LandCover
+
+Land cover features indicate the primary natural or artificial surface material covering a land
+area on the earth, including vegetation types like forests and crops, built environments like
+cities, and natural surfaces like wetlands or barren ground.
+
+Land cover features relate to `LandUse` features in the following way: land cover is the
+physical thing covering the land, while land use is the human use to which the land is being
+put.
+
+TODO: Explain relationship to `Land` features.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/geometric.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/geometric.md) | Shape of the covered land area, which may be a polygon or multi-polygon.<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
+| `theme` | `"base"` | |
+| `type` | `"land_cover"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` (optional) | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `subtype` | [`LandCoverSubtype`](types/land_cover_subtype.md) | |
+| `cartography` | [`CartographicHints`](../common/cartographic_hints.md) (optional) | Cartographic hints useful when including the feature in maps |
+| `cartography.prominence` | [`Prominence`](../common/prominence.md) (optional) | Subjective scale of feature significance or importance, with 1 being the least, and 100 being the most, significant.<br/><br/>This value can be used to help drive decisions about how and when to display a feature, and how to treat it relative to neighboring features.<br/><br/>When populated by Overture, this value is derived from various factors including, but not limited to: feature and subtype, population, and capital status. |
+| `cartography.min_zoom` | [`MinZoom`](../common/min_zoom.md) (optional) | Recommended minimum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels below this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `cartography.max_zoom` | [`MaxZoom`](../common/max_zoom.md) (optional) | Recommended maximum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels above this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `cartography.sort_key` | [`SortKey`](../common/sort_key.md) (optional) | Integer indicating the recommended order in which to draw features.<br/><br/>Features with a lower number should be drawn "in front" of features with a higher number. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `c347312d-012b-5e73-8bd3-a10d04b2981d` |
+| `bbox.xmin` | `-180.0001983642578` |
+| `bbox.ymin` | `65.95172119140625` |
+| `bbox.xmax` | `-179.99313354492188` |
+| `bbox.ymax` | `65.96218872070312` |
+| `geometry` | `POLYGON ((-179.99877531181616 65.95172539425603, -179.99740705536922 65.95265577758867, -179.9975...` |
+| `theme` | `base` |
+| `type` | `land_cover` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `ESA WorldCover` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `null` |
+| `sources[0].update_time` | `2024-11-07T00:00:00+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `subtype` | `barren` |
+| `cartography.prominence` | `null` |
+| `cartography.min_zoom` | `8` |
+| `cartography.max_zoom` | `15` |
+| `cartography.sort_key` | `3` |
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/land_use.md b/schema_versioned_docs/version-v2.0.0/reference/base/land_use.md
new file mode 100644
index 000000000..39c265574
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/land_use.md
@@ -0,0 +1,88 @@
+---
+sidebar_position: 1
+---
+
+# LandUse
+
+Land use features specify the predominant human use of an area of land, for example commercial
+activity, recreation, farming, housing, education, or military use.
+
+Land use features relate to `LandCover` features in the following way: land use is the human
+activity being done with the land, while land cover is the physical thing that covers it.
+
+TODO: Explain relationship to `Land` features.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/geometric.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/geometric.md) | Geometry of the land use area, which may be a point, line string, polygon, or multi-polygon.<br/><br/>*Allowed geometry types: LineString, MultiPolygon, Point, Polygon* |
+| `theme` | `"base"` | |
+| `type` | `"land_use"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` (optional) | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `class` | [`LandUseClass`](types/land_use_class.md) | |
+| `subtype` | [`LandUseSubtype`](types/land_use_subtype.md) | |
+| `elevation` | [`Elevation`](types/elevation.md) (optional) | Elevation above sea level of the feature in meters. |
+| `surface` | [`SurfaceMaterial`](types/surface_material.md) (optional) | |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level. A feature without a level is at visual level. |
+| `source_tags` | [`SourceTags`](types/source_tags.md) (map, optional) | Key/value pairs imported directly from the source data without change.<br/><br/>This field provides access to raw OSM entity tags for features sourced from OpenStreetMap. |
+| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `1e1f6095-5bd2-3fdb-a422-41351b848e9d` |
+| `bbox.xmin` | `-176.56825256347656` |
+| `bbox.ymin` | `-43.96001052856445` |
+| `bbox.xmax` | `-176.56231689453125` |
+| `bbox.ymax` | `-43.95420837402344` |
+| `geometry` | `POLYGON ((-176.5623454 -43.9567812, -176.5627644 -43.9561272, -176.5626898 -43.9557432, -176.5624...` |
+| `theme` | `base` |
+| `type` | `land_use` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `w56117029@3` |
+| `sources[0].update_time` | `2010-04-24T22:35:13+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `class` | `golf_course` |
+| `subtype` | `golf` |
+| `elevation` | `null` |
+| `surface` | `null` |
+| `names.primary` | `Chatham Islands Golf Club` |
+| `names.common` | `null` |
+| `names.rules` | `null` |
+| `level` | `null` |
+| `source_tags` | `{"LINZ:source_version": "V16", "attribution": "http://wiki.osm.org/wiki/Attribution#LINZ", "leisu...` |
+| `wikidata` | `null` |
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/types/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/base/types/_category_.json
new file mode 100644
index 000000000..a3ec08974
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/types/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Types"
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/types/depth.md b/schema_versioned_docs/version-v2.0.0/reference/base/types/depth.md
new file mode 100644
index 000000000..aa063f5ae
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/types/depth.md
@@ -0,0 +1,15 @@
+# Depth
+
+Depth below surface level of the feature in meters.
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 0`
+- `≥ -2147483648` (from [`int32`](../../system/numeric.md))
+- `≤ 2147483647` (from [`int32`](../../system/numeric.md))
+
+## Used By
+
+- [`Bathymetry`](../bathymetry.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/types/elevation.md b/schema_versioned_docs/version-v2.0.0/reference/base/types/elevation.md
new file mode 100644
index 000000000..59228b6e5
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/types/elevation.md
@@ -0,0 +1,16 @@
+# Elevation
+
+Elevation above sea level of the feature in meters.
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≤ 9000`
+- `≥ -2147483648` (from [`int32`](../../system/numeric.md))
+- `≤ 2147483647` (from [`int32`](../../system/numeric.md))
+
+## Used By
+
+- [`Land`](../land.md)
+- [`LandUse`](../land_use.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/types/height.md b/schema_versioned_docs/version-v2.0.0/reference/base/types/height.md
new file mode 100644
index 000000000..6a4b542fb
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/types/height.md
@@ -0,0 +1,13 @@
+# Height
+
+Height of the feature in meters.
+
+Underlying type: `float64`
+
+## Constraints
+
+- `> 0`
+
+## Used By
+
+- [`Infrastructure`](../infrastructure.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/types/infrastructure_class.md b/schema_versioned_docs/version-v2.0.0/reference/base/types/infrastructure_class.md
new file mode 100644
index 000000000..b8cc4043a
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/types/infrastructure_class.md
@@ -0,0 +1,176 @@
+# InfrastructureClass
+
+Further classification of the type of infrastructure.
+
+The infrastructure class adds detail to the broad classification of `InfrastructureSubtype`.
+
+## Values
+
+- `aerialway_station`
+- `airport`
+- `airport_gate`
+- `airstrip`
+- `apron`
+- `aqueduct`
+- `artwork`
+- `atm`
+- `barrier`
+- `bell_tower`
+- `bench`
+- `bicycle_parking`
+- `bicycle_rental`
+- `block`
+- `boardwalk`
+- `bollard`
+- `border_control`
+- `breakwater`
+- `bridge`
+- `bridge_support`
+- `bump_gate`
+- `bus_route`
+- `bus_station`
+- `bus_stop`
+- `bus_trap`
+- `cable`
+- `cable_barrier`
+- `cable_car`
+- `cable_distribution`
+- `camp_site`
+- `cantilever`
+- `catenary_mast`
+- `cattle_grid`
+- `chain`
+- `chair_lift`
+- `charging_station`
+- `city_wall`
+- `communication_line`
+- `communication_pole`
+- `communication_tower`
+- `connection`
+- `cooling`
+- `covered`
+- `crossing`
+- `cutline`
+- `cycle_barrier`
+- `dam`
+- `defensive`
+- `ditch`
+- `diving`
+- `drag_lift`
+- `drain`
+- `drinking_water`
+- `entrance`
+- `fence`
+- `ferry_terminal`
+- `fire_hydrant`
+- `fountain`
+- `full-height_turnstile`
+- `gasometer`
+- `gate`
+- `generator`
+- `give_way`
+- `gondola`
+- `goods`
+- `guard_rail`
+- `hampshire_gate`
+- `handrail`
+- `hedge`
+- `height_restrictor`
+- `heliostat`
+- `helipad`
+- `heliport`
+- `hose`
+- `information`
+- `insulator`
+- `international_airport`
+- `j-bar`
+- `jersey_barrier`
+- `kerb`
+- `kissing_gate`
+- `launchpad`
+- `lift_gate`
+- `lighting`
+- `lightning_protection`
+- `magic_carpet`
+- `manhole`
+- `milestone`
+- `military_airport`
+- `minaret`
+- `minor_line`
+- `mixed_lift`
+- `mobile_phone_tower`
+- `monitoring`
+- `motorcycle_parking`
+- `motorway_junction`
+- `movable`
+- `municipal_airport`
+- `observation`
+- `parking`
+- `parking_entrance`
+- `parking_space`
+- `pedestrian_crossing`
+- `picnic_table`
+- `pier`
+- `pipeline`
+- `plant`
+- `planter`
+- `platform`
+- `platter`
+- `portal`
+- `post_box`
+- `power_line`
+- `power_pole`
+- `power_tower`
+- `private_airport`
+- `pylon`
+- `quay`
+- `radar`
+- `railway_halt`
+- `railway_station`
+- `recycling`
+- `regional_airport`
+- `reservoir_covered`
+- `retaining_wall`
+- `roller_coaster`
+- `rope_tow`
+- `runway`
+- `sally_port`
+- `seaplane_airport`
+- `sewer`
+- `silo`
+- `siren`
+- `stile`
+- `stop`
+- `stop_position`
+- `stopway`
+- `storage_tank`
+- `street_cabinet`
+- `street_lamp`
+- `substation`
+- `subway_station`
+- `swing_gate`
+- `switch`
+- `t-bar`
+- `taxilane`
+- `taxiway`
+- `terminal`
+- `toilets`
+- `toll_booth`
+- `traffic_signals`
+- `transformer`
+- `trestle`
+- `utility_pole`
+- `vending_machine`
+- `viaduct`
+- `viewpoint`
+- `wall`
+- `waste_basket`
+- `waste_disposal`
+- `watchtower`
+- `water_tower`
+- `weir`
+- `zip_line`
+
+## Used By
+
+- [`Infrastructure`](../infrastructure.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/types/infrastructure_subtype.md b/schema_versioned_docs/version-v2.0.0/reference/base/types/infrastructure_subtype.md
new file mode 100644
index 000000000..c7432d702
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/types/infrastructure_subtype.md
@@ -0,0 +1,30 @@
+# InfrastructureSubtype
+
+Broadest classification of the type of infrastructure.
+
+This broad classification can be refined by `InfrastructureClass`.
+
+## Values
+
+- `aerialway`
+- `airport`
+- `barrier`
+- `bridge`
+- `communication`
+- `emergency`
+- `manhole`
+- `pedestrian`
+- `pier`
+- `power`
+- `quay`
+- `recreation`
+- `tower`
+- `transit`
+- `transportation`
+- `utility`
+- `waste_management`
+- `water`
+
+## Used By
+
+- [`Infrastructure`](../infrastructure.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/types/land_class.md b/schema_versioned_docs/version-v2.0.0/reference/base/types/land_class.md
new file mode 100644
index 000000000..8c63ddaf1
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/types/land_class.md
@@ -0,0 +1,54 @@
+# LandClass
+
+Further classification of the land.
+
+The land class adds detail to the broad classification of `LandSubtype`.
+
+## Values
+
+- `archipelago`
+- `bare_rock`
+- `beach`
+- `cave_entrance`
+- `cliff`
+- `desert`
+- `dune`
+- `fell`
+- `forest`
+- `glacier`
+- `grass`
+- `grassland`
+- `heath`
+- `hill`
+- `island`
+- `islet`
+- `land`
+- `meadow`
+- `meteor_crater`
+- `mountain_range`
+- `peak`
+- `peninsula`
+- `plateau`
+- `reef`
+- `ridge`
+- `rock`
+- `saddle`
+- `sand`
+- `scree`
+- `scrub`
+- `shingle`
+- `shrub`
+- `shrubbery`
+- `stone`
+- `tree`
+- `tree_row`
+- `tundra`
+- `valley`
+- `volcanic_caldera_rim`
+- `volcano`
+- `wetland`
+- `wood`
+
+## Used By
+
+- [`Land`](../land.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/types/land_cover_subtype.md b/schema_versioned_docs/version-v2.0.0/reference/base/types/land_cover_subtype.md
new file mode 100644
index 000000000..8a9676ae8
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/types/land_cover_subtype.md
@@ -0,0 +1,20 @@
+# LandCoverSubtype
+
+Primary or dominant material covering the land.
+
+## Values
+
+- `barren`
+- `crop`
+- `forest`
+- `grass`
+- `mangrove`
+- `moss`
+- `shrub`
+- `snow`
+- `urban`
+- `wetland`
+
+## Used By
+
+- [`LandCover`](../land_cover.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/types/land_subtype.md b/schema_versioned_docs/version-v2.0.0/reference/base/types/land_subtype.md
new file mode 100644
index 000000000..9e92c91af
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/types/land_subtype.md
@@ -0,0 +1,25 @@
+# LandSubtype
+
+Broadest classification of the land.
+
+This broad classification can be refined by `LandClass`.
+
+## Values
+
+- `crater`
+- `desert`
+- `forest`
+- `glacier`
+- `grass`
+- `land`
+- `physical`
+- `reef`
+- `rock`
+- `sand`
+- `shrub`
+- `tree`
+- `wetland`
+
+## Used By
+
+- [`Land`](../land.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/types/land_use_class.md b/schema_versioned_docs/version-v2.0.0/reference/base/types/land_use_class.md
new file mode 100644
index 000000000..5c9531d89
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/types/land_use_class.md
@@ -0,0 +1,121 @@
+# LandUseClass
+
+Further classification of the land use.
+
+The land use class adds detail to the broad classification of `LandUseSubtype`.
+
+## Values
+
+- `aboriginal_land`
+- `airfield`
+- `allotments`
+- `animal_keeping`
+- `aquaculture`
+- `barracks`
+- `base`
+- `beach_resort`
+- `brownfield`
+- `bunker`
+- `camp_site`
+- `cemetery`
+- `clinic`
+- `college`
+- `commercial`
+- `connection`
+- `construction`
+- `danger_area`
+- `doctors`
+- `dog_park`
+- `downhill`
+- `driving_range`
+- `driving_school`
+- `education`
+- `environmental`
+- `fairway`
+- `farmland`
+- `farmyard`
+- `fatbike`
+- `flowerbed`
+- `forest`
+- `garages`
+- `garden`
+- `golf_course`
+- `grass`
+- `grave_yard`
+- `green`
+- `greenfield`
+- `greenhouse_horticulture`
+- `highway`
+- `hike`
+- `hospital`
+- `ice_skate`
+- `industrial`
+- `institutional`
+- `kindergarten`
+- `landfill`
+- `lateral_water_hazard`
+- `logging`
+- `marina`
+- `meadow`
+- `military`
+- `military_hospital`
+- `military_school`
+- `music_school`
+- `national_park`
+- `natural_monument`
+- `nature_reserve`
+- `naval_base`
+- `nordic`
+- `nuclear_explosion_site`
+- `obstacle_course`
+- `orchard`
+- `park`
+- `peat_cutting`
+- `pedestrian`
+- `pitch`
+- `plant_nursery`
+- `playground`
+- `plaza`
+- `protected`
+- `protected_landscape_seascape`
+- `quarry`
+- `railway`
+- `range`
+- `recreation_ground`
+- `religious`
+- `residential`
+- `resort`
+- `retail`
+- `rough`
+- `salt_pond`
+- `school`
+- `schoolyard`
+- `ski_jump`
+- `skitour`
+- `sled`
+- `sleigh`
+- `snow_park`
+- `species_management_area`
+- `stadium`
+- `state_park`
+- `static_caravan`
+- `strict_nature_reserve`
+- `tee`
+- `theme_park`
+- `track`
+- `traffic_island`
+- `training_area`
+- `trench`
+- `university`
+- `village_green`
+- `vineyard`
+- `water_hazard`
+- `water_park`
+- `wilderness_area`
+- `winter_sports`
+- `works`
+- `zoo`
+
+## Used By
+
+- [`LandUse`](../land_use.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/types/land_use_subtype.md b/schema_versioned_docs/version-v2.0.0/reference/base/types/land_use_subtype.md
new file mode 100644
index 000000000..3acc75d21
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/types/land_use_subtype.md
@@ -0,0 +1,36 @@
+# LandUseSubtype
+
+Broadest classification of the land use.
+
+This broad classification can be refined by `LandUseClass`.
+
+## Values
+
+- `agriculture`
+- `aquaculture`
+- `campground`
+- `cemetery`
+- `construction`
+- `developed`
+- `education`
+- `entertainment`
+- `golf`
+- `grass`
+- `horticulture`
+- `landfill`
+- `managed`
+- `medical`
+- `military`
+- `park`
+- `pedestrian`
+- `protected`
+- `recreation`
+- `religious`
+- `residential`
+- `resource_extraction`
+- `transportation`
+- `winter_sports`
+
+## Used By
+
+- [`LandUse`](../land_use.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/types/source_tags.md b/schema_versioned_docs/version-v2.0.0/reference/base/types/source_tags.md
new file mode 100644
index 000000000..41f50ae8f
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/types/source_tags.md
@@ -0,0 +1,15 @@
+# SourceTags
+
+Key/value pairs imported directly from the source data without change.
+
+This field provides access to raw OSM entity tags for features sourced from
+OpenStreetMap.
+
+Underlying type: `map<string, Any>`
+
+## Used By
+
+- [`Infrastructure`](../infrastructure.md)
+- [`Land`](../land.md)
+- [`LandUse`](../land_use.md)
+- [`Water`](../water.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/types/surface_material.md b/schema_versioned_docs/version-v2.0.0/reference/base/types/surface_material.md
new file mode 100644
index 000000000..707f5a6a2
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/types/surface_material.md
@@ -0,0 +1,36 @@
+# SurfaceMaterial
+
+Material that makes up the surface of `Infrastructure` and `Land` features.
+
+## Values
+
+- `asphalt`
+- `cobblestone`
+- `compacted`
+- `concrete`
+- `concrete_plates`
+- `dirt`
+- `earth`
+- `fine_gravel`
+- `grass`
+- `gravel`
+- `ground`
+- `paved`
+- `paving_stones`
+- `pebblestone`
+- `recreation_grass`
+- `recreation_paved`
+- `recreation_sand`
+- `rubber`
+- `sand`
+- `sett`
+- `tartan`
+- `unpaved`
+- `wood`
+- `woodchips`
+
+## Used By
+
+- [`Infrastructure`](../infrastructure.md)
+- [`Land`](../land.md)
+- [`LandUse`](../land_use.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/types/water_class.md b/schema_versioned_docs/version-v2.0.0/reference/base/types/water_class.md
new file mode 100644
index 000000000..def472f93
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/types/water_class.md
@@ -0,0 +1,47 @@
+# WaterClass
+
+Further description of the type of water body.
+
+The water class adds detail to the broad classification of `WaterSubtype`.
+
+## Values
+
+- `basin`
+- `bay`
+- `blowhole`
+- `canal`
+- `cape`
+- `ditch`
+- `dock`
+- `drain`
+- `fairway`
+- `fish_pass`
+- `fishpond`
+- `geyser`
+- `hot_spring`
+- `lagoon`
+- `lake`
+- `moat`
+- `ocean`
+- `oxbow`
+- `pond`
+- `reflecting_pool`
+- `reservoir`
+- `river`
+- `salt_pond`
+- `sea`
+- `sewage`
+- `shoal`
+- `spring`
+- `strait`
+- `stream`
+- `swimming_pool`
+- `tidal_channel`
+- `wastewater`
+- `water`
+- `water_storage`
+- `waterfall`
+
+## Used By
+
+- [`Water`](../water.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/types/water_subtype.md b/schema_versioned_docs/version-v2.0.0/reference/base/types/water_subtype.md
new file mode 100644
index 000000000..987dc1af3
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/types/water_subtype.md
@@ -0,0 +1,24 @@
+# WaterSubtype
+
+The broad classification of water body such as river, ocean or lake.
+
+This broad classification can be refined using `WaterClass`.
+
+## Values
+
+- `canal`
+- `human_made`
+- `lake`
+- `ocean`
+- `physical`
+- `pond`
+- `reservoir`
+- `river`
+- `spring`
+- `stream`
+- `wastewater`
+- `water`
+
+## Used By
+
+- [`Water`](../water.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/base/water.md b/schema_versioned_docs/version-v2.0.0/reference/base/water.md
new file mode 100644
index 000000000..bd33f19ce
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/base/water.md
@@ -0,0 +1,104 @@
+---
+sidebar_position: 1
+---
+
+# Water
+
+Water features represent ocean and inland water bodies.
+
+In Overture data releases, water features are sourced from OpenStreetMap. There are two main
+categories of water feature: ocean and inland water bodies.
+
+Ocean
+-----
+The `subytpe` value `"ocean"` indicates an ocean area feature whose geometry represents the
+surface area of an ocean or part of an ocean. Ocean area may be tiled into many small polygons
+of consistent complexity to ensure manageable geometry. In Overture data releases, ocean area
+features are created from OpenStreetMap coastlines data (`natural=coastline`) using a QA'd
+version of the output from the OSMCoastline tool. In aggregate, all the ocean area features
+represent the inverse of the land features with subtype `"land"` and class `"land"`.
+
+The names and recommended label position for oceans and seas can be found in features with the
+subtype `"physical"` and the class `"ocean"` or `"sea"`.
+
+Inland Water
+------------
+Subtypes other than `"ocean"` (and `"physical"`) represent inland water bodies. In Overture data
+releases, these features are sourced from the OpenStreetMap tag `natural=*` where the tag value
+indicates a water body, as well as the tags `natural=water`,  `waterway=*`,
+and `water=*`.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/geometric.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/geometric.md) | Geometry of the water feature, which may be a point, line string, polygon, or multi-polygon.<br/><br/>*Allowed geometry types: LineString, MultiPolygon, Point, Polygon* |
+| `theme` | `"base"` | |
+| `type` | `"water"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` (optional) | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `class` | [`WaterClass`](types/water_class.md) | |
+| `subtype` | [`WaterSubtype`](types/water_subtype.md) | |
+| `is_intermittent` | `boolean` (optional) | Whether the water body exists intermittently, not permanently<br/><br/>*`strict=True`* |
+| `is_salt` | `boolean` (optional) | Whether the water body contains salt water<br/><br/>*`strict=True`* |
+| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level. A feature without a level is at visual level. |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `source_tags` | [`SourceTags`](types/source_tags.md) (map, optional) | Key/value pairs imported directly from the source data without change.<br/><br/>This field provides access to raw OSM entity tags for features sourced from OpenStreetMap. |
+| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `6bbb5fe5-bf26-3efa-b120-0a7079b60840` |
+| `bbox.xmin` | `-177.03179931640625` |
+| `bbox.ymin` | `-84.93480682373047` |
+| `bbox.xmax` | `-177.0317840576172` |
+| `bbox.ymax` | `-84.9347915649414` |
+| `geometry` | `POINT (-177.031799 -84.934793)` |
+| `theme` | `base` |
+| `type` | `water` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `n11109190647@2` |
+| `sources[0].update_time` | `2024-02-11T05:52:05+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `class` | `cape` |
+| `subtype` | `physical` |
+| `is_intermittent` | `null` |
+| `is_salt` | `null` |
+| `level` | `null` |
+| `names.primary` | `Thanksgiving Point` |
+| `names.common` | `null` |
+| `names.rules` | `null` |
+| `source_tags` | `{"natural": "cape", "ref:linz:place_id": "13433"}` |
+| `wikidata` | `Q33140589` |
diff --git a/schema_versioned_docs/version-v2.0.0/reference/buildings/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/buildings/_category_.json
new file mode 100644
index 000000000..3e85a3e78
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/buildings/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Buildings",
+  "position": 3
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/buildings/building.md b/schema_versioned_docs/version-v2.0.0/reference/buildings/building.md
new file mode 100644
index 000000000..123f0fdce
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/buildings/building.md
@@ -0,0 +1,108 @@
+---
+sidebar_position: 1
+---
+
+# Building
+
+Buildings are man-made structures with roofs that exist permanently in one place.
+
+A building's geometry represents the two-dimensional footprint of the building as viewed from
+directly above, looking down. Fields such as `height` and `num_floors` allow the
+three-dimensional shape to be approximated. Some buildings, identified by the `has_parts` field,
+have associated `BuildingPart` features which can be used to generate a more representative 3D
+model of the building.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/geometric.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/geometric.md) | The building's footprint or roofprint (if traced from aerial/satellite imagery).<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
+| `theme` | `"buildings"` | |
+| `type` | `"building"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` (optional) | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `subtype` | [`BuildingSubtype`](types/building_subtype.md) (optional) | A broad classification of the current use and purpose of the building.<br/><br/>If the current use of the building no longer accords with the original built purpose, the current use should be specified. For example, a building built as a train station but later converted into a shopping mall would have the value `"commercial"` rather than `"transportation"`. |
+| `class` | [`BuildingClass`](types/building_class.md) (optional) | A more specific classification of the current use and purpose of the building.<br/><br/>If the current use of the building no longer accords with the original built purpose, the current use should be specified. |
+| `has_parts` | `boolean` (optional) | Whether the building has associated building part features<br/><br/>*`strict=True`* |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level. A feature without a level is at visual level. |
+| `height` | [`float64`](../system/numeric.md) (optional) | Height of the building or part in meters.<br/><br/>This is the distance from the lowest point to the highest point.<br/><br/>*`> 0`* |
+| `is_underground` | `boolean` (optional) | Whether the entire building or part is completely below ground.<br/><br/>The underground flag is useful for display purposes. Buildings and building parts that are entirely below ground can be styled differently or omitted from the rendered image.<br/><br/>This flag is conceptually different from the `level` field, which indicates relative z-ordering and, notably, can be negative even if the building is entirely above-ground.<br/><br/>*`strict=True`* |
+| `num_floors` | [`int32`](../system/numeric.md) (optional) | Number of above-ground floors of the building or part.<br/><br/>*`> 0`* |
+| `num_floors_underground` | [`int32`](../system/numeric.md) (optional) | Number of below-ground floors of the building or part.<br/><br/>*`> 0`* |
+| `min_height` | [`float64`](../system/numeric.md) (optional) | Altitude above ground where the bottom of the building or building part starts.<br/><br/>If present, this value indicates that the lowest part of the building or building part starts is above ground level. |
+| `min_floor` | [`int32`](../system/numeric.md) (optional) | Start floor of this building or part.<br/><br/>If present, this value indicates that the building or part is "floating" and its bottom-most floor is above ground level, usually because it is part of a larger building in which some parts do reach down to ground level. An example is a building that has an entry road or driveway at ground level into an interior courtyard, where part of the building bridges above the entry road. This property may sometimes be populated when `min_height` is missing and in these cases can be used as a proxy for `min_height`.<br/><br/>*`> 0`* |
+| `facade_color` | [`HexColor`](../system/hex_color.md) (optional) | Facade color in `#rgb` or `#rrggbb` hex notation |
+| `facade_material` | [`FacadeMaterial`](types/facade_material.md) (optional) | Outer surface material of the facade |
+| `roof_material` | [`RoofMaterial`](types/roof_material.md) (optional) | Outer surface material of the roof |
+| `roof_shape` | [`RoofShape`](types/roof_shape.md) (optional) | Shape of the roof |
+| `roof_direction` | [`float64`](../system/numeric.md) (optional) | Bearing of the roof ridge line in degrees<br/><br/>*`≥ 0`*<br/>*`< 360`* |
+| `roof_orientation` | [`RoofOrientation`](types/roof_orientation.md) (optional) | Orientation of the roof shape relative to the footprint shape |
+| `roof_color` | [`HexColor`](../system/hex_color.md) (optional) | The roof color in `#rgb` or `#rrggbb` hex notation |
+| `roof_height` | [`float64`](../system/numeric.md) (optional) | Height of the roof in meters.<br/><br/>This is the distance from the base of the roof to its highest point. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `148f35b1-7bc1-4180-9280-10d39b13883b` |
+| `bbox.xmin` | `-176.643798828125` |
+| `bbox.ymin` | `-43.9938850402832` |
+| `bbox.xmax` | `-176.64349365234375` |
+| `bbox.ymax` | `-43.993709564208984` |
+| `geometry` | `POLYGON ((-176.6435004 -43.9938042, -176.6435738 -43.9937107, -176.6437726 -43.9937913, -176.6436...` |
+| `theme` | `buildings` |
+| `type` | `building` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `w519166507@1` |
+| `sources[0].update_time` | `2017-08-27T21:39:50+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `subtype` | `null` |
+| `class` | `null` |
+| `has_parts` | `false` |
+| `names` | `null` |
+| `level` | `null` |
+| `height` | `null` |
+| `is_underground` | `false` |
+| `num_floors` | `null` |
+| `num_floors_underground` | `null` |
+| `min_height` | `null` |
+| `min_floor` | `null` |
+| `facade_color` | `null` |
+| `facade_material` | `null` |
+| `roof_material` | `null` |
+| `roof_shape` | `null` |
+| `roof_direction` | `null` |
+| `roof_orientation` | `null` |
+| `roof_color` | `null` |
+| `roof_height` | `null` |
diff --git a/schema_versioned_docs/version-v2.0.0/reference/buildings/building_part.md b/schema_versioned_docs/version-v2.0.0/reference/buildings/building_part.md
new file mode 100644
index 000000000..69826cee8
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/buildings/building_part.md
@@ -0,0 +1,107 @@
+---
+sidebar_position: 1
+---
+
+# BuildingPart
+
+Building parts represent parts of larger building features. They allow buildings to be modeled
+in rich detail suitable for creating realistic 3D models.
+
+Every building part is associated with a parent `Building` feature via the `building_id` field.
+In addition, a building part has a footprint geometry and may include additional details such as
+its height, the number of floors, and the color and material of its facade and roof.
+
+Building parts can float or be stacked on top of each other. The `min_height`, `min_floor`,
+`height`, and `num_floors`, fields can be used to arrange the parts correctly along the
+vertical dimension.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/geometric.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/geometric.md) | The footprint or roofprint of the building part.<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
+| `theme` | `"buildings"` | |
+| `type` | `"building_part"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` (optional) | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `building_id` | [`Id`](../system/ref/id.md) | The building to which this part belongs<br/><br/>*References [`Building`](building.md) (composition, part of)* |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level. A feature without a level is at visual level. |
+| `height` | [`float64`](../system/numeric.md) (optional) | Height of the building or part in meters.<br/><br/>This is the distance from the lowest point to the highest point.<br/><br/>*`> 0`* |
+| `is_underground` | `boolean` (optional) | Whether the entire building or part is completely below ground.<br/><br/>The underground flag is useful for display purposes. Buildings and building parts that are entirely below ground can be styled differently or omitted from the rendered image.<br/><br/>This flag is conceptually different from the `level` field, which indicates relative z-ordering and, notably, can be negative even if the building is entirely above-ground.<br/><br/>*`strict=True`* |
+| `num_floors` | [`int32`](../system/numeric.md) (optional) | Number of above-ground floors of the building or part.<br/><br/>*`> 0`* |
+| `num_floors_underground` | [`int32`](../system/numeric.md) (optional) | Number of below-ground floors of the building or part.<br/><br/>*`> 0`* |
+| `min_height` | [`float64`](../system/numeric.md) (optional) | Altitude above ground where the bottom of the building or building part starts.<br/><br/>If present, this value indicates that the lowest part of the building or building part starts is above ground level. |
+| `min_floor` | [`int32`](../system/numeric.md) (optional) | Start floor of this building or part.<br/><br/>If present, this value indicates that the building or part is "floating" and its bottom-most floor is above ground level, usually because it is part of a larger building in which some parts do reach down to ground level. An example is a building that has an entry road or driveway at ground level into an interior courtyard, where part of the building bridges above the entry road. This property may sometimes be populated when `min_height` is missing and in these cases can be used as a proxy for `min_height`.<br/><br/>*`> 0`* |
+| `facade_color` | [`HexColor`](../system/hex_color.md) (optional) | Facade color in `#rgb` or `#rrggbb` hex notation |
+| `facade_material` | [`FacadeMaterial`](types/facade_material.md) (optional) | Outer surface material of the facade |
+| `roof_material` | [`RoofMaterial`](types/roof_material.md) (optional) | Outer surface material of the roof |
+| `roof_shape` | [`RoofShape`](types/roof_shape.md) (optional) | Shape of the roof |
+| `roof_direction` | [`float64`](../system/numeric.md) (optional) | Bearing of the roof ridge line in degrees<br/><br/>*`≥ 0`*<br/>*`< 360`* |
+| `roof_orientation` | [`RoofOrientation`](types/roof_orientation.md) (optional) | Orientation of the roof shape relative to the footprint shape |
+| `roof_color` | [`HexColor`](../system/hex_color.md) (optional) | The roof color in `#rgb` or `#rrggbb` hex notation |
+| `roof_height` | [`float64`](../system/numeric.md) (optional) | Height of the roof in meters.<br/><br/>This is the distance from the base of the roof to its highest point. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `19412d64-51ac-3d6a-ac2f-8a8c8b91bb60` |
+| `bbox.xmin` | `-73.24630737304688` |
+| `bbox.ymin` | `-39.81101608276367` |
+| `bbox.xmax` | `-73.24613952636719` |
+| `bbox.ymax` | `-39.81088638305664` |
+| `geometry` | `POLYGON ((-73.2462509 -39.8108937, -73.2462755 -39.8109047, -73.246291 -39.8109182, -73.2463022 -...` |
+| `theme` | `buildings` |
+| `type` | `building_part` |
+| `version` | `0` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `w223076787@2` |
+| `sources[0].update_time` | `2014-10-31T22:55:36+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `building_id` | `bd663bd4-1844-4d7d-a400-114de051cf49` |
+| `names` | `null` |
+| `level` | `3` |
+| `height` | `null` |
+| `is_underground` | `false` |
+| `num_floors` | `null` |
+| `num_floors_underground` | `null` |
+| `min_height` | `null` |
+| `min_floor` | `null` |
+| `facade_color` | `null` |
+| `facade_material` | `null` |
+| `roof_material` | `null` |
+| `roof_shape` | `null` |
+| `roof_direction` | `null` |
+| `roof_orientation` | `null` |
+| `roof_color` | `null` |
+| `roof_height` | `null` |
diff --git a/schema_versioned_docs/version-v2.0.0/reference/buildings/types/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/buildings/types/_category_.json
new file mode 100644
index 000000000..a3ec08974
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/buildings/types/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Types"
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/buildings/types/building_class.md b/schema_versioned_docs/version-v2.0.0/reference/buildings/types/building_class.md
new file mode 100644
index 000000000..0c996c16d
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/buildings/types/building_class.md
@@ -0,0 +1,100 @@
+# BuildingClass
+
+Further classification of the type and purpose of a building.
+
+The building class adds detail to the broad classification of `BuildingSubtype`.
+
+## Values
+
+- `agricultural`
+- `allotment_house`
+- `apartments`
+- `barn`
+- `beach_hut`
+- `boathouse`
+- `bridge_structure`
+- `bungalow`
+- `bunker`
+- `cabin`
+- `carport`
+- `cathedral`
+- `chapel`
+- `church`
+- `civic`
+- `college`
+- `commercial`
+- `cowshed`
+- `detached`
+- `digester`
+- `dormitory`
+- `dwelling_house`
+- `factory`
+- `farm`
+- `farm_auxiliary`
+- `fire_station`
+- `garage`
+- `garages`
+- `ger`
+- `glasshouse`
+- `government`
+- `grandstand`
+- `greenhouse`
+- `guardhouse`
+- `hangar`
+- `hospital`
+- `hotel`
+- `house`
+- `houseboat`
+- `hut`
+- `industrial`
+- `kindergarten`
+- `kiosk`
+- `library`
+- `manufacture`
+- `military`
+- `monastery`
+- `mosque`
+- `office`
+- `outbuilding`
+- `parking`
+- `pavilion`
+- `post_office`
+- `presbytery`
+- `public`
+- `religious`
+- `residential`
+- `retail`
+- `roof`
+- `school`
+- `semi`
+- `semidetached_house`
+- `service`
+- `shed`
+- `shelter`
+- `shrine`
+- `silo`
+- `slurry_tank`
+- `sports_centre`
+- `sports_hall`
+- `stable`
+- `stadium`
+- `static_caravan`
+- `stilt_house`
+- `storage_tank`
+- `sty`
+- `supermarket`
+- `synagogue`
+- `temple`
+- `terrace`
+- `toilets`
+- `train_station`
+- `transformer_tower`
+- `transportation`
+- `trullo`
+- `university`
+- `warehouse`
+- `wayside_shrine`
+
+## Used By
+
+- [`Building`](../building.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/buildings/types/building_subtype.md b/schema_versioned_docs/version-v2.0.0/reference/buildings/types/building_subtype.md
new file mode 100644
index 000000000..7069cf95e
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/buildings/types/building_subtype.md
@@ -0,0 +1,25 @@
+# BuildingSubtype
+
+Broadest classification of the type and purpose of a building.
+
+This broad classification can be refined by `BuildingClass`.
+
+## Values
+
+- `agricultural`
+- `civic`
+- `commercial`
+- `education`
+- `entertainment`
+- `industrial`
+- `medical`
+- `military`
+- `outbuilding`
+- `religious`
+- `residential`
+- `service`
+- `transportation`
+
+## Used By
+
+- [`Building`](../building.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/buildings/types/facade_material.md b/schema_versioned_docs/version-v2.0.0/reference/buildings/types/facade_material.md
new file mode 100644
index 000000000..13a5a8c41
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/buildings/types/facade_material.md
@@ -0,0 +1,22 @@
+# FacadeMaterial
+
+The outer surface material of building facade.
+
+## Values
+
+- `brick`
+- `cement_block`
+- `clay`
+- `concrete`
+- `glass`
+- `metal`
+- `plaster`
+- `plastic`
+- `stone`
+- `timber_framing`
+- `wood`
+
+## Used By
+
+- [`Building`](../building.md)
+- [`BuildingPart`](../building_part.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/buildings/types/roof_material.md b/schema_versioned_docs/version-v2.0.0/reference/buildings/types/roof_material.md
new file mode 100644
index 000000000..1efc1f022
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/buildings/types/roof_material.md
@@ -0,0 +1,25 @@
+# RoofMaterial
+
+The outermost material of the roof.
+
+## Values
+
+- `concrete`
+- `copper`
+- `eternit`
+- `glass`
+- `grass`
+- `gravel`
+- `metal`
+- `plastic`
+- `roof_tiles`
+- `slate`
+- `solar_panels`
+- `tar_paper`
+- `thatch`
+- `wood`
+
+## Used By
+
+- [`Building`](../building.md)
+- [`BuildingPart`](../building_part.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/buildings/types/roof_orientation.md b/schema_versioned_docs/version-v2.0.0/reference/buildings/types/roof_orientation.md
new file mode 100644
index 000000000..443af22a2
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/buildings/types/roof_orientation.md
@@ -0,0 +1,16 @@
+# RoofOrientation
+
+Orientation of the roof shape relative to the footprint shape.
+
+The members of this enumeration, `"across"` and `"along"`, are borrowed from the OpenStreetMap
+`roof:orientation=*` tag and have the same meanings as they do in OSM.
+
+## Values
+
+- `across` - The roof ridge runs perpendicular to the longer of the two building edges, parallel to the shorter
+- `along` - The roof ridge runs parallel to the longer of the two building edges
+
+## Used By
+
+- [`Building`](../building.md)
+- [`BuildingPart`](../building_part.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/buildings/types/roof_shape.md b/schema_versioned_docs/version-v2.0.0/reference/buildings/types/roof_shape.md
new file mode 100644
index 000000000..f1271e095
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/buildings/types/roof_shape.md
@@ -0,0 +1,25 @@
+# RoofShape
+
+The shape of the roof.
+
+## Values
+
+- `dome`
+- `flat`
+- `gabled`
+- `gambrel`
+- `half_hipped`
+- `hipped`
+- `mansard`
+- `onion`
+- `pyramidal`
+- `round`
+- `saltbox`
+- `sawtooth`
+- `skillion`
+- `spherical`
+
+## Used By
+
+- [`Building`](../building.md)
+- [`BuildingPart`](../building_part.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/common/_category_.json
new file mode 100644
index 000000000..44fea45e2
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Common",
+  "position": 7
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/cartographic_hints.md b/schema_versioned_docs/version-v2.0.0/reference/common/cartographic_hints.md
new file mode 100644
index 000000000..33c58438b
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/cartographic_hints.md
@@ -0,0 +1,18 @@
+# CartographicHints
+
+Cartographic hints for optimal use of Overture features in map-making.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `prominence` | [`Prominence`](prominence.md) (optional) | Subjective scale of feature significance or importance, with 1 being the least, and 100 being the most, significant.<br/><br/>This value can be used to help drive decisions about how and when to display a feature, and how to treat it relative to neighboring features.<br/><br/>When populated by Overture, this value is derived from various factors including, but not limited to: feature and subtype, population, and capital status. |
+| `min_zoom` | [`MinZoom`](min_zoom.md) (optional) | Recommended minimum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels below this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `max_zoom` | [`MaxZoom`](max_zoom.md) (optional) | Recommended maximum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels above this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `sort_key` | [`SortKey`](sort_key.md) (optional) | Integer indicating the recommended order in which to draw features.<br/><br/>Features with a lower number should be drawn "in front" of features with a higher number. |
+
+## Used By
+
+- [`Bathymetry`](../base/bathymetry.md)
+- [`Division`](../divisions/division.md)
+- [`LandCover`](../base/land_cover.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/common_names.md b/schema_versioned_docs/version-v2.0.0/reference/common/common_names.md
new file mode 100644
index 000000000..2d1950d78
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/common_names.md
@@ -0,0 +1,10 @@
+# CommonNames
+
+A mapping from language to the most commonly used or recognized name in that language.
+
+Underlying type: `map<`[`LanguageTag`](../system/language_tag.md)`,`[`StrippedString`](../system/stripped_string.md)`>`
+
+## Used By
+
+- [`Division`](../divisions/division.md)
+- [`Names`](names.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/confidence_score.md b/schema_versioned_docs/version-v2.0.0/reference/common/confidence_score.md
new file mode 100644
index 000000000..42256524e
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/confidence_score.md
@@ -0,0 +1,15 @@
+# ConfidenceScore
+
+Confidence score between 0.0 and 1.0
+
+Underlying type: `float64`
+
+## Constraints
+
+- `≥ 0.0`
+- `≤ 1.0`
+
+## Used By
+
+- [`Place`](../places/place.md)
+- [`SourceItem`](source_item.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/feature_version.md b/schema_versioned_docs/version-v2.0.0/reference/common/feature_version.md
new file mode 100644
index 000000000..ea77a41af
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/feature_version.md
@@ -0,0 +1,27 @@
+# FeatureVersion
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 0`
+- `≥ -2147483648` (from [`int32`](../system/numeric.md))
+- `≤ 2147483647` (from [`int32`](../system/numeric.md))
+
+## Used By
+
+- [`Address`](../addresses/address.md)
+- [`Bathymetry`](../base/bathymetry.md)
+- [`Building`](../buildings/building.md)
+- [`BuildingPart`](../buildings/building_part.md)
+- [`Connector`](../transportation/connector.md)
+- [`Division`](../divisions/division.md)
+- [`DivisionArea`](../divisions/division_area.md)
+- [`DivisionBoundary`](../divisions/division_boundary.md)
+- [`Infrastructure`](../base/infrastructure.md)
+- [`Land`](../base/land.md)
+- [`LandCover`](../base/land_cover.md)
+- [`LandUse`](../base/land_use.md)
+- [`Place`](../places/place.md)
+- [`Segment`](../transportation/segment.md)
+- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/length_unit.md b/schema_versioned_docs/version-v2.0.0/reference/common/length_unit.md
new file mode 100644
index 000000000..44750a380
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/length_unit.md
@@ -0,0 +1,19 @@
+# LengthUnit
+
+Unit of length.
+
+## Values
+
+- `in` - One inch in the imperial and US customary systems
+- `ft` - One foot in the imperial and US customary systems (12 inches)
+- `yd` - One yard in the imperial and US customary systems (three feet)
+- `mi` - One mile in the imperial and US customary systems (1,760 yards)
+- `cm` - One centimeter in the metric and SI systems
+- `m` - One meter in the metric and SI systems
+- `km` - One kilometer in the metric and SI systems
+
+## Used By
+
+- [`VehicleHeightSelector`](scoping/vehicle_height_selector.md)
+- [`VehicleLengthSelector`](scoping/vehicle_length_selector.md)
+- [`VehicleWidthSelector`](scoping/vehicle_width_selector.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/level.md b/schema_versioned_docs/version-v2.0.0/reference/common/level.md
new file mode 100644
index 000000000..0235af31e
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/level.md
@@ -0,0 +1,20 @@
+# Level
+
+Z-order of the feature where 0 is visual level
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ -2147483648` (from [`int32`](../system/numeric.md))
+- `≤ 2147483647` (from [`int32`](../system/numeric.md))
+
+## Used By
+
+- [`Building`](../buildings/building.md)
+- [`BuildingPart`](../buildings/building_part.md)
+- [`Infrastructure`](../base/infrastructure.md)
+- [`Land`](../base/land.md)
+- [`LandUse`](../base/land_use.md)
+- [`LevelRule`](../transportation/types/segment/level_rule.md)
+- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/max_zoom.md b/schema_versioned_docs/version-v2.0.0/reference/common/max_zoom.md
new file mode 100644
index 000000000..bdd0f65f4
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/max_zoom.md
@@ -0,0 +1,23 @@
+# MaxZoom
+
+Recommended maximum tile zoom level in which this feature should be displayed.
+
+It is recommended that the feature be hidden at zoom levels above this value.
+
+Zoom levels follow the Slippy Maps convention, documented in the following
+references:
+- [https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames](https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames)
+- [https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection](https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection)
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 0`
+- `≤ 23`
+- `≥ -2147483648` (from [`int32`](../system/numeric.md))
+- `≤ 2147483647` (from [`int32`](../system/numeric.md))
+
+## Used By
+
+- [`CartographicHints`](cartographic_hints.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/min_zoom.md b/schema_versioned_docs/version-v2.0.0/reference/common/min_zoom.md
new file mode 100644
index 000000000..4bb6c81db
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/min_zoom.md
@@ -0,0 +1,23 @@
+# MinZoom
+
+Recommended minimum tile zoom level in which this feature should be displayed.
+
+It is recommended that the feature be hidden at zoom levels below this value.
+
+Zoom levels follow the Slippy Maps convention, documented in the following
+references:
+- [https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames](https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames)
+- [https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection](https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection)
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 0`
+- `≤ 23`
+- `≥ -2147483648` (from [`int32`](../system/numeric.md))
+- `≤ 2147483647` (from [`int32`](../system/numeric.md))
+
+## Used By
+
+- [`CartographicHints`](cartographic_hints.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/name_rule.md b/schema_versioned_docs/version-v2.0.0/reference/common/name_rule.md
new file mode 100644
index 000000000..4b1c0308b
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/name_rule.md
@@ -0,0 +1,32 @@
+# NameRule
+
+A rule that can be evaluated to determine the name in advanced scenarios.
+
+Name rules are used for cases where the primary name is not sufficient; the common name is not
+the right fit for the use case and another variant is needed; or where the name only applies in
+certain specific circumstances.
+
+Examples might include:
+- An official, alternate, or short name.
+- A name that only applies to part of a linear path like a road segment (geometric range
+  scoping).
+- A name that only applies to the left or right side of a linear path like a road segment (side
+  scoping).
+- A name that is only accepted by some political perspectives.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`StrippedString`](../system/stripped_string.md) | The actual name value.<br/><br/>*Minimum length: 1* |
+| `variant` | [`NameVariant`](name_variant.md) | The name variant for this name rule. |
+| `language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `perspectives` | [`Perspectives`](perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `perspectives.mode` | [`PerspectiveMode`](perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `between` | [`LinearlyReferencedRange`](scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `side` | [`Side`](scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+
+## Used By
+
+- [`Names`](names.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/name_variant.md b/schema_versioned_docs/version-v2.0.0/reference/common/name_variant.md
new file mode 100644
index 000000000..ea9fa475c
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/name_variant.md
@@ -0,0 +1,22 @@
+# NameVariant
+
+Name variant used in a `NameRule`.
+
+## Values
+
+- `common` - The most commonly used or recognized name for a feature in the specified language.
+
+In a `Names` value, most common names will appear in the `Names.common` field and will
+not need to be specified as `NameRule` values in `Names.rules`. This member of the
+enumeration should only be used to construct a `NameRule` if the common name needs to
+be scoped in some way and therefore cannot be accurately represented in `CommonNames`.
+- `official` - The legally or administratively recognized name, often used by government agencies or
+official documents.
+- `alternate` - An alternative name, which may be a historical name, a local colloquial name, or some
+other well-known name is not the common name.
+- `short` - An abbreviated or shortened version of the name, which may be an acronym or some other
+commonly-used short form. An example is "NYC" for New York City.
+
+## Used By
+
+- [`NameRule`](name_rule.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/names.md b/schema_versioned_docs/version-v2.0.0/reference/common/names.md
new file mode 100644
index 000000000..220658c59
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/names.md
@@ -0,0 +1,33 @@
+# Names
+
+Multilingual names container.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name.<br/><br/>*Minimum length: 1* |
+| `common` | [`CommonNames`](common_names.md) (map, optional) | |
+| `rules[]` | `list<`[`NameRule`](name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `rules[].variant` | [`NameVariant`](name_variant.md) | The name variant for this name rule. |
+| `rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `rules[].perspectives` | [`Perspectives`](perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `rules[].perspectives.mode` | [`PerspectiveMode`](perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `rules[].between` | [`LinearlyReferencedRange`](scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `rules[].side` | [`Side`](scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+
+## Used By
+
+- [`Brand`](../places/types/brand.md)
+- [`Building`](../buildings/building.md)
+- [`BuildingPart`](../buildings/building_part.md)
+- [`Division`](../divisions/division.md)
+- [`DivisionArea`](../divisions/division_area.md)
+- [`Infrastructure`](../base/infrastructure.md)
+- [`Land`](../base/land.md)
+- [`LandUse`](../base/land_use.md)
+- [`Place`](../places/place.md)
+- [`Segment`](../transportation/segment.md)
+- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/perspective_mode.md b/schema_versioned_docs/version-v2.0.0/reference/common/perspective_mode.md
new file mode 100644
index 000000000..af2f597ff
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/perspective_mode.md
@@ -0,0 +1,12 @@
+# PerspectiveMode
+
+Perspective mode for disputed names.
+
+## Values
+
+- `accepted_by`
+- `disputed_by`
+
+## Used By
+
+- [`Perspectives`](perspectives.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/perspectives.md b/schema_versioned_docs/version-v2.0.0/reference/common/perspectives.md
new file mode 100644
index 000000000..b5e634d91
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/perspectives.md
@@ -0,0 +1,16 @@
+# Perspectives
+
+Political perspectives container.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `mode` | [`PerspectiveMode`](perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+
+## Used By
+
+- [`Division`](../divisions/division.md)
+- [`DivisionBoundary`](../divisions/division_boundary.md)
+- [`NameRule`](name_rule.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/prominence.md b/schema_versioned_docs/version-v2.0.0/reference/common/prominence.md
new file mode 100644
index 000000000..3294dca48
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/prominence.md
@@ -0,0 +1,23 @@
+# Prominence
+
+Subjective scale of feature significance or importance, with 1 being the least, and
+100 being the most, significant.
+
+This value can be used to help drive decisions about how and when to display a
+feature, and how to treat it relative to neighboring features.
+
+When populated by Overture, this value is derived from various factors including,
+but not limited to: feature and subtype, population, and capital status.
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 1`
+- `≤ 100`
+- `≥ -2147483648` (from [`int32`](../system/numeric.md))
+- `≤ 2147483647` (from [`int32`](../system/numeric.md))
+
+## Used By
+
+- [`CartographicHints`](cartographic_hints.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/scoping/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/_category_.json
new file mode 100644
index 000000000..155d669bb
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Scoping"
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/scoping/heading.md b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/heading.md
new file mode 100644
index 000000000..c34335000
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/heading.md
@@ -0,0 +1,17 @@
+# Heading
+
+Travel direction along an oriented path: forward or backward.
+
+## Values
+
+- `forward`
+- `backward`
+
+## Used By
+
+- [`AccessRule.When`](../../transportation/types/segment/access_rule.when.md)
+- [`DestinationRule`](../../transportation/types/segment/destination_rule.md)
+- [`DestinationRule.When`](../../transportation/types/segment/destination_rule.when.md)
+- [`ProhibitedTransitionRule`](../../transportation/types/segment/prohibited_transition_rule.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/segment/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/segment/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/scoping/linearly_referenced_position.md b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/linearly_referenced_position.md
new file mode 100644
index 000000000..d13d2f35d
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/linearly_referenced_position.md
@@ -0,0 +1,15 @@
+# LinearlyReferencedPosition
+
+Represents a linearly-referenced position between 0% and 100% of the distance along a path such as a road segment or a river center-line segment.
+
+Underlying type: `float64`
+
+## Constraints
+
+- `≥ 0.0`
+- `≤ 1.0`
+
+## Used By
+
+- [`ConnectorReference`](../../transportation/types/segment/connector_reference.md)
+- [`LinearlyReferencedRange`](linearly_referenced_range.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/scoping/linearly_referenced_range.md b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/linearly_referenced_range.md
new file mode 100644
index 000000000..91fe99dd7
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/linearly_referenced_range.md
@@ -0,0 +1,26 @@
+# LinearlyReferencedRange
+
+Represents a non-empty range of positions along a path as a pair linearly-referenced positions. For example, the pair [0.25, 0.5] represents the range beginning 25% of the distance from the start of the path and ending 50% of the distance from the path
+
+Underlying type: `list<float64>`
+
+## Constraints
+
+- Linear reference range constraint (0.0 to 1.0). (`LinearReferenceRangeConstraint`)
+- `≥ 0.0` (from [`LinearlyReferencedPosition`](linearly_referenced_position.md))
+- `≤ 1.0` (from [`LinearlyReferencedPosition`](linearly_referenced_position.md))
+
+## Used By
+
+- [`AccessRule`](../../transportation/types/segment/access_rule.md)
+- [`LevelRule`](../../transportation/types/segment/level_rule.md)
+- [`NameRule`](../name_rule.md)
+- [`ProhibitedTransitionRule`](../../transportation/types/segment/prohibited_transition_rule.md)
+- [`RailFlagRule`](../../transportation/types/segment/rail_flag_rule.md)
+- [`RoadFlagRule`](../../transportation/types/segment/road_flag_rule.md)
+- [`RoadSubclassRule`](../../transportation/types/segment/road_subclass_rule.md)
+- [`RoadSurfaceRule`](../../transportation/types/segment/road_surface_rule.md)
+- [`RouteReference`](../../transportation/types/segment/route_reference.md)
+- [`SourceItem`](../source_item.md)
+- [`SpeedLimitRule`](../../transportation/types/segment/speed_limit_rule.md)
+- [`WidthRule`](../../transportation/types/segment/width_rule.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/scoping/opening_hours.md b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/opening_hours.md
new file mode 100644
index 000000000..c943bc8ca
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/opening_hours.md
@@ -0,0 +1,12 @@
+# OpeningHours
+
+Time span or time spans during which something is open or active, specified in the OpenStreetMap
+opening hours specification: [https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification](https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification).
+
+Underlying type: `string`
+
+## Used By
+
+- [`AccessRule.When`](../../transportation/types/segment/access_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/segment/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/segment/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/scoping/purpose_of_use.md b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/purpose_of_use.md
new file mode 100644
index 000000000..c6f024218
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/purpose_of_use.md
@@ -0,0 +1,18 @@
+# PurposeOfUse
+
+Reason why a person or entity travelling on the transportation network is using a particular
+location.
+
+## Values
+
+- `as_customer`
+- `at_destination`
+- `to_deliver`
+- `to_farm`
+- `for_forestry`
+
+## Used By
+
+- [`AccessRule.When`](../../transportation/types/segment/access_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/segment/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/segment/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/scoping/recognized_status.md b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/recognized_status.md
new file mode 100644
index 000000000..03930e106
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/recognized_status.md
@@ -0,0 +1,18 @@
+# RecognizedStatus
+
+Status of the person or entity travelling as recognized by authorities controlling the particular
+location.
+
+## Values
+
+- `as_permitted`
+- `as_private`
+- `as_disabled`
+- `as_employee`
+- `as_student`
+
+## Used By
+
+- [`AccessRule.When`](../../transportation/types/segment/access_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/segment/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/segment/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/scoping/side.md b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/side.md
new file mode 100644
index 000000000..e8a269ef7
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/side.md
@@ -0,0 +1,15 @@
+# Side
+
+The side, left or right, on which something appears relative to a facing or heading direction
+(*e.g.*, the side of a road relative to the road orientation), or relative to the direction of
+travel of a person or vehicle.
+
+## Values
+
+- `left` - On the left relative to the facing direction
+- `right` - On the right side relative to the facing direction
+
+## Used By
+
+- [`NameRule`](../name_rule.md)
+- [`Norms`](../../divisions/types/norms.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/scoping/travel_mode.md b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/travel_mode.md
new file mode 100644
index 000000000..cbd5fee43
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/travel_mode.md
@@ -0,0 +1,25 @@
+# TravelMode
+
+Enumerates possible travel modes.
+
+Some modes represent groups of modes.
+
+## Values
+
+- `vehicle`
+- `motor_vehicle` - Includes car, truck and motorcycle
+- `car`
+- `truck`
+- `motorcycle`
+- `foot`
+- `bicycle`
+- `bus`
+- `hgv`
+- `hov`
+- `emergency`
+
+## Used By
+
+- [`AccessRule.When`](../../transportation/types/segment/access_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/segment/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/segment/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_axle_count_selector.md b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_axle_count_selector.md
new file mode 100644
index 000000000..bc91a410b
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_axle_count_selector.md
@@ -0,0 +1,17 @@
+# VehicleAxleCountSelector
+
+Selects vehicles based on the number of axles they have.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `dimension` | `"axle_count"` | |
+| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
+| `value` | [`float64`](../../system/numeric.md) | Number of axles on the vehicle<br/><br/>*`≥ 1`*<br/>*`≤ 100`*<br/>*Must be a whole number* |
+
+## Used By
+
+- [`AccessRule.When`](../../transportation/types/segment/access_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/segment/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/segment/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_height_selector.md b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_height_selector.md
new file mode 100644
index 000000000..b03bbfe9b
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_height_selector.md
@@ -0,0 +1,18 @@
+# VehicleHeightSelector
+
+Selects vehicles based on their height.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `dimension` | `"height"` | |
+| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
+| `value` | [`float64`](../../system/numeric.md) | Vehicle height selection threshold in the given `unit`<br/><br/>*`≥ 0`* |
+| `unit` | [`LengthUnit`](../length_unit.md) | Height unit in which `value` is expressed |
+
+## Used By
+
+- [`AccessRule.When`](../../transportation/types/segment/access_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/segment/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/segment/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_length_selector.md b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_length_selector.md
new file mode 100644
index 000000000..985c93bb8
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_length_selector.md
@@ -0,0 +1,18 @@
+# VehicleLengthSelector
+
+Selects vehicles based on their length.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `dimension` | `"length"` | |
+| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
+| `value` | [`float64`](../../system/numeric.md) | Vehicle length selection threshold in the given `unit`<br/><br/>*`≥ 0`* |
+| `unit` | [`LengthUnit`](../length_unit.md) | Length unit in which `value` is expressed |
+
+## Used By
+
+- [`AccessRule.When`](../../transportation/types/segment/access_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/segment/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/segment/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_relation.md b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_relation.md
new file mode 100644
index 000000000..0ac89eddd
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_relation.md
@@ -0,0 +1,19 @@
+# VehicleRelation
+
+Relational operator, such as less than or equal to.
+
+## Values
+
+- `greater_than`
+- `greater_than_equal`
+- `equal`
+- `less_than`
+- `less_than_equal`
+
+## Used By
+
+- [`VehicleAxleCountSelector`](vehicle_axle_count_selector.md)
+- [`VehicleHeightSelector`](vehicle_height_selector.md)
+- [`VehicleLengthSelector`](vehicle_length_selector.md)
+- [`VehicleWeightSelector`](vehicle_weight_selector.md)
+- [`VehicleWidthSelector`](vehicle_width_selector.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_weight_selector.md b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_weight_selector.md
new file mode 100644
index 000000000..0209ec237
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_weight_selector.md
@@ -0,0 +1,18 @@
+# VehicleWeightSelector
+
+Selects vehicles based on their weight.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `dimension` | `"weight"` | |
+| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
+| `value` | [`float64`](../../system/numeric.md) | Vehicle weight selection threshold in the given `unit`<br/><br/>*`≥ 0`* |
+| `unit` | [`WeightUnit`](../weight_unit.md) | Weight unit in which `value` is expressed |
+
+## Used By
+
+- [`AccessRule.When`](../../transportation/types/segment/access_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/segment/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/segment/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_width_selector.md b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_width_selector.md
new file mode 100644
index 000000000..591ef6efc
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/scoping/vehicle_width_selector.md
@@ -0,0 +1,18 @@
+# VehicleWidthSelector
+
+Selects vehicles based on their width.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `dimension` | `"width"` | |
+| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
+| `value` | [`float64`](../../system/numeric.md) | Vehicle width selection threshold in the given `unit`<br/><br/>*`≥ 0`* |
+| `unit` | [`LengthUnit`](../length_unit.md) | Width unit in which `value` is expressed |
+
+## Used By
+
+- [`AccessRule.When`](../../transportation/types/segment/access_rule.when.md)
+- [`ProhibitedTransitionRule.When`](../../transportation/types/segment/prohibited_transition_rule.when.md)
+- [`SpeedLimitRule.When`](../../transportation/types/segment/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/sort_key.md b/schema_versioned_docs/version-v2.0.0/reference/common/sort_key.md
new file mode 100644
index 000000000..9ab65e983
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/sort_key.md
@@ -0,0 +1,17 @@
+# SortKey
+
+Integer indicating the recommended order in which to draw features.
+
+Features with a lower number should be drawn "in front" of features with a higher
+number.
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ -2147483648` (from [`int32`](../system/numeric.md))
+- `≤ 2147483647` (from [`int32`](../system/numeric.md))
+
+## Used By
+
+- [`CartographicHints`](cartographic_hints.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/source_item.md b/schema_versioned_docs/version-v2.0.0/reference/common/source_item.md
new file mode 100644
index 000000000..27bdb65c1
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/source_item.md
@@ -0,0 +1,37 @@
+# SourceItem
+
+Specifies the source of the data used for a feature or one of its properties.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `dataset` | `string` (optional) | Name of the dataset where the source data can be found. |
+| `license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `confidence` | [`ConfidenceScore`](confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri).<br/><br/>*Minimum length: 1* |
+| `resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names).<br/><br/>*Minimum length: 1* |
+| `version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692).<br/><br/>*Minimum length: 1* |
+| `between` | [`LinearlyReferencedRange`](scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+
+## Used By
+
+- [`Address`](../addresses/address.md)
+- [`Bathymetry`](../base/bathymetry.md)
+- [`Building`](../buildings/building.md)
+- [`BuildingPart`](../buildings/building_part.md)
+- [`Connector`](../transportation/connector.md)
+- [`Division`](../divisions/division.md)
+- [`DivisionArea`](../divisions/division_area.md)
+- [`DivisionBoundary`](../divisions/division_boundary.md)
+- [`Infrastructure`](../base/infrastructure.md)
+- [`Land`](../base/land.md)
+- [`LandCover`](../base/land_cover.md)
+- [`LandUse`](../base/land_use.md)
+- [`Place`](../places/place.md)
+- [`Segment`](../transportation/segment.md)
+- [`Water`](../base/water.md)
+- [`Sources`](sources.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/sources.md b/schema_versioned_docs/version-v2.0.0/reference/common/sources.md
new file mode 100644
index 000000000..ac48419ef
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/sources.md
@@ -0,0 +1,28 @@
+# Sources
+
+Information about the source data used to assemble the feature.
+
+Underlying type: `list<`[`SourceItem`](source_item.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Address`](../addresses/address.md)
+- [`Bathymetry`](../base/bathymetry.md)
+- [`Building`](../buildings/building.md)
+- [`BuildingPart`](../buildings/building_part.md)
+- [`Connector`](../transportation/connector.md)
+- [`Division`](../divisions/division.md)
+- [`DivisionArea`](../divisions/division_area.md)
+- [`DivisionBoundary`](../divisions/division_boundary.md)
+- [`Infrastructure`](../base/infrastructure.md)
+- [`Land`](../base/land.md)
+- [`LandCover`](../base/land_cover.md)
+- [`LandUse`](../base/land_use.md)
+- [`Place`](../places/place.md)
+- [`Segment`](../transportation/segment.md)
+- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/speed_unit.md b/schema_versioned_docs/version-v2.0.0/reference/common/speed_unit.md
new file mode 100644
index 000000000..4f0cf11ed
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/speed_unit.md
@@ -0,0 +1,12 @@
+# SpeedUnit
+
+Unit of speed.
+
+## Values
+
+- `mph` - Miles per hour
+- `km/h` - Kilometers per hour
+
+## Used By
+
+- [`Speed`](../transportation/types/segment/speed.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/common/weight_unit.md b/schema_versioned_docs/version-v2.0.0/reference/common/weight_unit.md
new file mode 100644
index 000000000..f53cb2977
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/common/weight_unit.md
@@ -0,0 +1,17 @@
+# WeightUnit
+
+Unit of weight.
+
+## Values
+
+- `oz` - One ounce in the imperial and US customary systems
+- `lb` - One pound in the imperial and US customary systems
+- `st` - One short ton, or one ton in the US customary system (2,000 pounds)
+- `lt` - One long ton, or one ton in the imperial system (2,400 pounds)
+- `g` - One gram in the metric and SI systems
+- `kg` - One kilogram in the metric and SI systems
+- `t` - One tonne in the metric and SI systems
+
+## Used By
+
+- [`VehicleWeightSelector`](scoping/vehicle_weight_selector.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/divisions/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/divisions/_category_.json
new file mode 100644
index 000000000..51eecd257
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/divisions/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Divisions",
+  "position": 4
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/divisions/division.md b/schema_versioned_docs/version-v2.0.0/reference/divisions/division.md
new file mode 100644
index 000000000..a069a7cb4
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/divisions/division.md
@@ -0,0 +1,132 @@
+---
+sidebar_position: 1
+---
+
+# Division
+
+Divisions are recognized official or non-official organizations of people as seen from a given
+political perspective.
+
+Examples include countries, provinces, cities, towns, neighborhoods, etc.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `cartography` | [`CartographicHints`](../common/cartographic_hints.md) (optional) | Cartographic hints useful when including the feature in maps |
+| `cartography.prominence` | [`Prominence`](../common/prominence.md) (optional) | Subjective scale of feature significance or importance, with 1 being the least, and 100 being the most, significant.<br/><br/>This value can be used to help drive decisions about how and when to display a feature, and how to treat it relative to neighboring features.<br/><br/>When populated by Overture, this value is derived from various factors including, but not limited to: feature and subtype, population, and capital status. |
+| `cartography.min_zoom` | [`MinZoom`](../common/min_zoom.md) (optional) | Recommended minimum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels below this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `cartography.max_zoom` | [`MaxZoom`](../common/max_zoom.md) (optional) | Recommended maximum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels above this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
+| `cartography.sort_key` | [`SortKey`](../common/sort_key.md) (optional) | Integer indicating the recommended order in which to draw features.<br/><br/>Features with a lower number should be drawn "in front" of features with a higher number. |
+| `names` | [`Names`](../common/names.md) | All known names by which the division is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/geometric.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/geometric.md) | Approximate location of a position commonly associated with the real-world entity modeled by the division feature.<br/><br/>*Allowed geometry types: Point* |
+| `theme` | `"divisions"` | |
+| `type` | `"division"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` (optional) | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `subtype` | [`DivisionSubtype`](types/division_subtype.md) | A broad classification of the division (e.g., country, region, locality, etc.).<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`*<br/>*`parent_division_id` is required when `subtype` ≠ `country`*<br/>*`parent_division_id` is forbidden when `subtype` = `country`* |
+| `country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) | ISO 3166-1 alpha-2 country code of the country or country-like entity, that this division represents or belongs to.<br/><br/>If the entity this division represents has a country code, the country property contains it. If it does not, the country property contains the country code of the first division encountered by traversing the parent_division_id chain to the root.<br/><br/>For example: - The country value for the United States is 'US' - The country value for New York City is 'US' - The country value for Puerto Rico, a dependency of the US, is 'PR'. - The country value for San Juan, Puerto Rico is 'PR'.<br/><br/>If an entity has an internationally-recognized ISO 3166-1 alpha-2 country code, it should always be used. In cases where the schema requires the code but no internationally-recognized code is available, a synthetic code may be used provided it does not conflict with any internationally-recognized codes. |
+| `hierarchies[][]` | `list<`[`Hierarchy`](types/hierarchy.md)`>` | Hierarchies in which this division participates.<br/><br/>Every division participates in at least one hierarchy. Most participate in only one. Some divisions may participate in more than one hierarchy, for example if they are claimed by different parent divisions from different political perspectives; or if there are other real-world reasons why the division or one of its ancestors has multiple parents.<br/><br/>The first hierarchy in the list is the default hierarchy, and the second-to-last entry in the default hierarchy (if there is such an entry) always corresponds to the `parent_division_id` property. The ordering of hierarchies after the first one is arbitrary.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `hierarchies[][].division_id` | [`Id`](../system/ref/id.md) | ID of a division that is an ancestor of the current division.<br/><br/>In the context of division hierarchies, the ancestor divisions of a division include the division itself, and any other division that is an ancestor of the division's parent. |
+| `hierarchies[][].subtype` | [`DivisionSubtype`](types/division_subtype.md) | |
+| `hierarchies[][].name` | [`StrippedString`](../system/stripped_string.md) | Primary name of the division |
+| `parent_division_id` | [`Id`](../system/ref/id.md) (optional) | Division ID of this division's parent division.<br/><br/>Not allowed for top-level divisions (countries) and required for all other divisions.<br/><br/>The default parent division is the parent division as seen from the default political perspective, if there is one, and is otherwise chosen somewhat arbitrarily. The hierarchies property can be used to inspect the exhaustive list of parent divisions.<br/><br/>*References `Division` (hierarchy, child of)*<br/><br/>*`parent_division_id` is required when `subtype` ≠ `country`*<br/>*`parent_division_id` is forbidden when `subtype` = `country`* |
+| `admin_level` | [`AdminLevel`](types/admin_level.md) (optional) | Integer representing the division's position in its country's administrative hierarchy, where lower numbers correspond to higher level administrative units.<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`* |
+| `class` | [`DivisionClass`](types/division_class.md) (optional) | A more specific classification of the division than is provided by `subtype`. |
+| `local_type` | [`CommonNames`](../common/common_names.md) (map, optional) | Local name for the subtype property, optionally localized.<br/><br/>For example, the Canadian province of Quebec has the subtype `"region"`, but in the local administrative hierarchy it is referred to as a province. Similarly, the Canadian Yukon territory also has subtype `"region"`, but is locally called a territory.<br/><br/>This property is localized using a standard Overture names structure. So for example, in Switzerland the top-level administrative subdivision corresponding to subtype 'region' is the canton, which may be translated in each of Switzerland's official languages as, 'canton' in French, 'kanton' in German, 'cantone' in Italian, and 'chantun' in Romansh. |
+| `region` | [`RegionCode`](../system/region_code.md) (optional) | ISO 3166-2 principal subdivision code of the subdivision-like entity this division represents or belongs to.<br/><br/>If the entity this division represents has a principal subdivision code, the region property contains it. If it does not, the region property contains the principal subdivision code of the first division encountered by traversing the `parent_division_id` chain to the root.<br/><br/>For example: - The region value for the United States is omitted. - The region value for the U.S. state of New York is 'US-NY'. - The region value for New York City is 'US-NY', which it inherits from the state   of New York. - The region value for Puerto Rico is 'US-PR'. |
+| `perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which this division is considered to be an accurate representation.<br/><br/>If this property is absent, then this division is not known to be disputed from any political perspective. Consequently, there is only one division feature representing the entire real world entity.<br/><br/>If this property is present, it means the division represents one of several alternative perspectives on the same real-world entity.<br/><br/>There are two modes of perspective:<br/><br/>1. `accepted_by` means the representation of the division is accepted by the    listed entities and would be included on a map drawn from their perspective.<br/><br/>2. `disputed_by` means the representation of the division is disputed by the    listed entities and would be excluded from a map drawn from their perspective.<br/><br/>When drawing a map from the perspective of a given country, one would start by gathering all the undisputed divisions (with no `perspectives` property), and then adding to that first all divisions explicitly accepted by the country, and second all divisions not explicitly disputed by the country. |
+| `perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `norms` | [`Norms`](types/norms.md) (optional) | Collects information about local norms and rules within the division that are generally useful for mapping and map-related use cases.<br/><br/>If the norms property or a desired sub-property of the norms property is missing on a division, but at least one of its ancestor divisions has the norms property and the desired sub-property, then the value from the nearest ancestor division may be assumed. |
+| `norms.driving_side` | [`Side`](../common/scoping/side.md) (optional) | Side of the road on which vehicles drive in the division. |
+| `population` | [`int32`](../system/numeric.md) (optional) | Population of the division<br/><br/>*`≥ 0`* |
+| `capital_division_ids` | `list<`[`Id`](../system/ref/id.md)`>` (optional) | Division IDs of this division's capital divisions. If present, this property will refer to the division IDs of the capital cities, county seats, etc. of a division.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/>*References `Division` (hierarchy, has as capital)* |
+| `capital_of_divisions[]` | `list<`[`CapitalOfDivisionItem`](types/capital_of_division_item.md)`>` (optional) | Division IDs and subtypes of divisions this division is a capital of.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `capital_of_divisions[].division_id` | [`Id`](../system/ref/id.md) | ID of the division whose capital is the current division. |
+| `capital_of_divisions[].subtype` | [`DivisionSubtype`](types/division_subtype.md) | |
+| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+
+## Constraints
+
+- `admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`
+- `parent_division_id` is required when `subtype` ≠ `country`
+- `parent_division_id` is forbidden when `subtype` = `country`
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `cartography` | `null` |
+| `names.primary` | `Kauaʻi County` |
+| `names.common` | `{"haw": "kalana Kaua\u02bbi"}` |
+| `id` | `c9b8adc9-4639-4392-8efe-8401eeb19929` |
+| `bbox.xmin` | `-159.49453735351562` |
+| `bbox.ymin` | `22.05571746826172` |
+| `bbox.xmax` | `-159.4945068359375` |
+| `bbox.ymax` | `22.055721282958984` |
+| `geometry` | `POINT (-159.4945109 22.0557204)` |
+| `theme` | `divisions` |
+| `type` | `division` |
+| `version` | `5` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `ODbL-1.0` |
+| `sources[0].record_id` | `r166560@15` |
+| `sources[0].update_time` | `2025-08-16T14:25:55+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `subtype` | `county` |
+| `country` | `US` |
+| `hierarchies[0][0].division_id` | `f39eb4af-5206-481b-b19e-bd784ded3f05` |
+| `hierarchies[0][0].subtype` | `country` |
+| `hierarchies[0][0].name` | `United States` |
+| `hierarchies[0][1].division_id` | `a2a08395-e968-4be5-bdd7-7f63db8c2165` |
+| `hierarchies[0][1].subtype` | `region` |
+| `hierarchies[0][1].name` | `Hawaii` |
+| `hierarchies[0][2].division_id` | `c9b8adc9-4639-4392-8efe-8401eeb19929` |
+| `hierarchies[0][2].subtype` | `county` |
+| `hierarchies[0][2].name` | `Kauaʻi County` |
+| `parent_division_id` | `a2a08395-e968-4be5-bdd7-7f63db8c2165` |
+| `admin_level` | `2` |
+| `class` | `null` |
+| `local_type` | `{"en": "county"}` |
+| `region` | `US-HI` |
+| `perspectives` | `null` |
+| `norms` | `null` |
+| `population` | `71735` |
+| `capital_division_ids` | `["958c67d3-868a-482d-9dd8-1c65b0c1a9e8"]` |
+| `capital_of_divisions` | `null` |
+| `wikidata` | `Q111517` |
+| `names.rules[0].value` | `Kauai County` |
+| `names.rules[0].variant` | `alternate` |
+| `names.rules[0].language` | `null` |
+| `names.rules[0].perspectives` | `null` |
+| `names.rules[0].between` | `null` |
+| `names.rules[0].side` | `null` |
diff --git a/schema_versioned_docs/version-v2.0.0/reference/divisions/division_area.md b/schema_versioned_docs/version-v2.0.0/reference/divisions/division_area.md
new file mode 100644
index 000000000..daa5fec2c
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/divisions/division_area.md
@@ -0,0 +1,99 @@
+---
+sidebar_position: 1
+---
+
+# DivisionArea
+
+Division areas are polygon features that represent the land or maritime area covered by a
+division.
+
+Each division area belongs to a division which it references by ID, and for which the division
+area provides an area polygon. For ease of use, every division area repeats the subtype, names,
+country, and region properties of the division it belongs to.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `names` | [`Names`](../common/names.md) | All known names by which the owning division is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/geometric.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/geometric.md) | The area covered by the division with which this area feature is associated.<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
+| `theme` | `"divisions"` | |
+| `type` | `"division_area"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` (optional) | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `subtype` | [`DivisionSubtype`](types/division_subtype.md) | A broad classification of the division this area belongs to (e.g., country, region, locality, etc.).<br/><br/>This value is the same as the owning division's `subtype`.<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`* |
+| `class` | [`AreaClass`](types/area_class.md) | A more specific classification of the division area than is provided by `subtype`. |
+| `is_land` | `boolean` (optional) | Flag indicating whether or not the feature geometry represents the land-clipped, non-maritime boundary. The geometry can be used for map rendering, cartographic display, and similar purposes.<br/><br/>*`strict=True`*<br/><br/>*At least one of `is_land`, `is_territorial` must be `true`* |
+| `is_territorial` | `boolean` (optional) | Flag indicating whether or not the feature geometry represents Overture's best approximation of the division's territorial boundary. For coastal places, this will tend to include the water area. The geometry can be used for data processing, reverse-geocoding, and similar purposes.<br/><br/>*`strict=True`*<br/><br/>*At least one of `is_land`, `is_territorial` must be `true`* |
+| `division_id` | [`Id`](../system/ref/id.md) | Division ID of the parent division of this area.<br/><br/>*References [`Division`](division.md) (hierarchy, child of)* |
+| `country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) | ISO 3166-1 alpha-2 country code of the division this area belongs to. |
+| `region` | [`RegionCode`](../system/region_code.md) (optional) | ISO 3166-2 principal subdivision code of the division this area belongs to. |
+| `admin_level` | [`AdminLevel`](types/admin_level.md) (optional) | Integer representing the division's position in its country's administrative hierarchy, where lower numbers correspond to higher level administrative units.<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`* |
+
+## Constraints
+
+- At least one of `is_land`, `is_territorial` must be `true`
+- `admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `names.primary` | `Kauaʻi County` |
+| `names.common` | `{"haw": "kalana Kaua\u02bbi"}` |
+| `id` | `109cfa53-bb13-4e37-aeb0-14f9a08c737d` |
+| `bbox.xmin` | `-160.54449462890625` |
+| `bbox.ymin` | `21.649578094482422` |
+| `bbox.xmax` | `-159.29266357421875` |
+| `bbox.ymax` | `22.23270606994629` |
+| `geometry` | `MULTIPOLYGON (((-160.5408313 21.6535414, -160.544491 21.6514764, -160.5369253 21.6495783, -160.54...` |
+| `theme` | `divisions` |
+| `type` | `division_area` |
+| `version` | `7` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `ODbL-1.0` |
+| `sources[0].record_id` | `r166560@15` |
+| `sources[0].update_time` | `2025-08-16T14:25:55+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `subtype` | `county` |
+| `class` | `land` |
+| `is_land` | `true` |
+| `is_territorial` | `false` |
+| `division_id` | `c9b8adc9-4639-4392-8efe-8401eeb19929` |
+| `country` | `US` |
+| `region` | `US-HI` |
+| `admin_level` | `2` |
+| `names.rules[0].value` | `Kauai County` |
+| `names.rules[0].variant` | `alternate` |
+| `names.rules[0].language` | `null` |
+| `names.rules[0].perspectives` | `null` |
+| `names.rules[0].between` | `null` |
+| `names.rules[0].side` | `null` |
diff --git a/schema_versioned_docs/version-v2.0.0/reference/divisions/division_boundary.md b/schema_versioned_docs/version-v2.0.0/reference/divisions/division_boundary.md
new file mode 100644
index 000000000..d56fc25c0
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/divisions/division_boundary.md
@@ -0,0 +1,94 @@
+---
+sidebar_position: 1
+---
+
+# DivisionBoundary
+
+Boundaries represent borders between divisions of the same subtype.
+
+Some boundaries may be disputed by the divisions on one or both sides.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/geometric.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/geometric.md) | Boundary line or lines<br/><br/>*Allowed geometry types: LineString, MultiLineString* |
+| `theme` | `"divisions"` | |
+| `type` | `"division_boundary"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` (optional) | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `subtype` | [`DivisionSubtype`](types/division_subtype.md) | A broad classification of the divisions this boundary separates (e.g., country, region, locality, etc.).<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`*<br/>*`country` is required when `subtype` ≠ `country`*<br/>*`country` is forbidden when `subtype` = `country`* |
+| `class` | [`BoundaryClass`](types/boundary_class.md) | The kind of boundary: land or maritime. |
+| `is_land` | `boolean` (optional) | Flag indicating whether or not the feature geometry represents the land-clipped, non-maritime boundary. The geometry can be used for map rendering, cartographic display, and similar purposes.<br/><br/>*`strict=True`*<br/><br/>*At least one of `is_land`, `is_territorial` must be `true`* |
+| `is_territorial` | `boolean` (optional) | Flag indicating whether or not the feature geometry represents Overture's best approximation of the division's territorial boundary. For coastal places, this will tend to include the water area. The geometry can be used for data processing, reverse-geocoding, and similar purposes.<br/><br/>*`strict=True`*<br/><br/>*At least one of `is_land`, `is_territorial` must be `true`* |
+| `division_ids` | `list<`[`Id`](../system/ref/id.md)`>` | Identifies the two divisions to the left and right, respectively, of the boundary line. The left- and right-hand sides of the boundary are considered from the perspective of a person standing on the line facing in the direction in which the geometry is oriented, i.e. facing toward the end of the line.<br/><br/>The first array element is the Overture ID of the left division. The second element is the Overture ID of the right division.<br/><br/>*Minimum length: 2*<br/>*Maximum length: 2*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/>*References [`Division`](division.md) (composition, boundary of)* |
+| `country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) (optional) | ISO 3166-1 alpha-2 country code of the country or country-like entity that both sides of the boundary share.<br/><br/>This property will be present on boundaries between two regions, counties, or similar entities within the same country, but will not be present on boundaries between two countries or country-like entities.<br/><br/>*`country` is required when `subtype` ≠ `country`*<br/>*`country` is forbidden when `subtype` = `country`* |
+| `region` | [`RegionCode`](../system/region_code.md) (optional) | ISO 3166-2 principal subdivision code of the subdivision-like entity that both sides of the boundary share.<br/><br/>This property will be present on boundaries between two counties, localadmins or similar entities within the same principal subdivision, but will not be present on boundaries between different principal subdivisions or countries. |
+| `admin_level` | [`AdminLevel`](types/admin_level.md) (optional) | Integer representing the division's position in its country's administrative hierarchy, where lower numbers correspond to higher level administrative units.<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`* |
+| `is_disputed` | `boolean` (optional) | Flag indicating whether this boundary is either disputed outright or is a "best guess" in a case where the boundary between two divisions is unclear.<br/><br/>If the boundary is disputed outright, this flag is true and the entities disputing it are listed in the `perspectives` property. If the boundary is simply a "best guess", this flag is true but no disputing entities are listed in `perspectives`.<br/><br/>*`strict=True`* |
+| `perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which this division boundary is considered to be an accurate representation.<br/><br/>If this property is absent, then this boundary is not known to be disputed from any political perspective. Consequently, there is only one boundary feature representing the entire real world entity.<br/><br/>If this property is present, it means the boundary represents one of several alternative perspectives on the same real-world entity.<br/><br/>There are two modes of perspective:<br/><br/>1. `accepted_by` means the representation of the boundary is accepted by the    listed entities and would be included on a map drawn from their perspective.<br/><br/>2. `disputed_by` means the representation of the boundary is disputed by the    listed entities and would be excluded from a map drawn from their    perspective.<br/><br/>When drawing a map from the perspective of a given country, one would start by gathering all the undisputed boundaries (those with no `perspectives` value); and then adding to that: first, all boundaries explicitly accepted by the country, and second, all boundaries not explicitly disputed by the country. |
+| `perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+
+## Constraints
+
+- At least one of `is_land`, `is_territorial` must be `true`
+- `admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`
+- `country` is required when `subtype` ≠ `country`
+- `country` is forbidden when `subtype` = `country`
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `321ed3ec-23c2-376e-a4fd-0df484cb99ca` |
+| `bbox.xmin` | `-157.02012634277344` |
+| `bbox.ymin` | `21.12626075744629` |
+| `bbox.xmax` | `-156.89283752441406` |
+| `bbox.ymax` | `21.18390655517578` |
+| `geometry` | `LINESTRING (-157.0195397035514 21.183903480793326, -157.0201257 21.180663, -157.0084983 21.178697...` |
+| `theme` | `divisions` |
+| `type` | `division_boundary` |
+| `version` | `2` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `ODbL-1.0` |
+| `sources[0].record_id` | `r166564@15` |
+| `sources[0].update_time` | `2025-02-21T16:35:23+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `sources[1].property` |  |
+| `sources[1].dataset` | `OpenStreetMap` |
+| `sources[1].license` | `ODbL-1.0` |
+| `sources[1].record_id` | `r166561@26` |
+| `sources[1].update_time` | `2025-08-16T14:01:24+00:00` |
+| `sources[1].confidence` | `null` |
+| `sources[1].provider` | `null` |
+| `sources[1].resource` | `null` |
+| `sources[1].version` | `null` |
+| `sources[1].between` | `null` |
+| `subtype` | `county` |
+| `class` | `land` |
+| `is_land` | `true` |
+| `is_territorial` | `false` |
+| `division_ids` | `["a546a5ef-ba43-44ce-a7c3-1999b005b20f", "0554d43c-de68-433c-9a6c-db58161c8b4a"]` |
+| `country` | `US` |
+| `region` | `US-HI` |
+| `admin_level` | `2` |
+| `is_disputed` | `false` |
+| `perspectives` | `null` |
diff --git a/schema_versioned_docs/version-v2.0.0/reference/divisions/types/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/_category_.json
new file mode 100644
index 000000000..a3ec08974
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Types"
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/divisions/types/admin_level.md b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/admin_level.md
new file mode 100644
index 000000000..10cbc3cdf
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/admin_level.md
@@ -0,0 +1,19 @@
+# AdminLevel
+
+Integer representing the division's position in its country's administrative
+hierarchy, where lower numbers correspond to higher level administrative units.
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 0`
+- `≤ 16`
+- `≥ -2147483648` (from [`int32`](../../system/numeric.md))
+- `≤ 2147483647` (from [`int32`](../../system/numeric.md))
+
+## Used By
+
+- [`Division`](../division.md)
+- [`DivisionArea`](../division_area.md)
+- [`DivisionBoundary`](../division_boundary.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/divisions/types/area_class.md b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/area_class.md
new file mode 100644
index 000000000..b0367b2ca
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/area_class.md
@@ -0,0 +1,15 @@
+# AreaClass
+
+Further classification of a division area that is more specific than its `subtype`.
+
+A division area's `class` adds detail to the broad classification found in `DivisionSubtype`.
+
+## Values
+
+- `land` - The area does not extend beyond the coastline.
+- `maritime` - The area extends beyond the coastline, in most cases to the extent of the division's
+territorial sea, if it has one.
+
+## Used By
+
+- [`DivisionArea`](../division_area.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/divisions/types/boundary_class.md b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/boundary_class.md
new file mode 100644
index 000000000..9b2d103da
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/boundary_class.md
@@ -0,0 +1,13 @@
+# BoundaryClass
+
+The kind of boundary: land or maritime.
+
+## Values
+
+- `land` - None of the boundary geometry extends beyond the coastline of either associated
+division.
+- `maritime` - All the boundary geometry extends beyond the coastline of both associated divisions.
+
+## Used By
+
+- [`DivisionBoundary`](../division_boundary.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/divisions/types/capital_of_division_item.md b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/capital_of_division_item.md
new file mode 100644
index 000000000..f7c5f1c78
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/capital_of_division_item.md
@@ -0,0 +1,14 @@
+# CapitalOfDivisionItem
+
+A division of which the owning division is the capital, together with its subtype.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `division_id` | [`Id`](../../system/ref/id.md) | ID of the division whose capital is the current division.<br/><br/>*References [`Division`](../division.md) (hierarchy, capital of)* |
+| `subtype` | [`DivisionSubtype`](division_subtype.md) | |
+
+## Used By
+
+- [`Division`](../division.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/divisions/types/division_class.md b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/division_class.md
new file mode 100644
index 000000000..f7cac4560
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/division_class.md
@@ -0,0 +1,20 @@
+# DivisionClass
+
+Further classification of a division that is more specific than its `subtype`.
+
+A division's `class` adds detail to the broad classification found in `DivisionSubtype`.
+
+## Values
+
+- `megacity` - A very large city or metropolitan area, typically having a population of 10 million or
+more. Example: Tokyo, Japan.
+- `city` - A large, permanent human settlement. Example: Guadalajara, Mexico.
+- `town` - A medium-sized permanent human settlement that is smaller than a city, but larger than a
+village. Example: Walldürn, Germany.
+- `village` - A smallish permanent human settlement that is smaller than a town, but larger than a
+hamlet. Example: Wadi El Karm, Lebanon.
+- `hamlet` - A very small, isolated human settlement in a rural area. Example: Tjarnabyggð, Iceland.
+
+## Used By
+
+- [`Division`](../division.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/divisions/types/division_subtype.md b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/division_subtype.md
new file mode 100644
index 000000000..ad061cd7e
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/division_subtype.md
@@ -0,0 +1,35 @@
+# DivisionSubtype
+
+Category of the division from a finite, hierarchical, ordered list of categories (e.g., country,
+region, locality, etc.) similar to a Who's on First placetype.
+
+## Values
+
+- `country` - Largest unit of independent sovereignty, e.g., the United States, France.
+- `dependency` - A place that is not exactly a sub-region of a country but is dependent on a parent
+country for defence, passport control, etc., e.g., Puerto Rico.
+- `macroregion` - A bundle of regions, e.g., England, Scotland, Île-de-France. These exist mainly in
+Europe.
+- `region` - A state, province, region, etc. Largest sub-country administrative unit in most
+countries, except those that have dependencies or macro-regions.
+- `macrocounty` - A bundle of counties, e.g. Inverness. These exist mainly in Europe.
+- `county` - Largest sub-region administrative unit in most countries, unless they have
+macrocounties.
+- `localadmin` - An administrative unit existing in some parts of the world that contains localities
+or populated places, e.g. département de Paris. Often the contained places do not
+have independent authority. Often, but not exclusively, found in Europe.
+- `locality` - A populated place that may or may not have its own administrative authority.
+- `borough` - A local government unit subordinate to a locality.
+- `macrohood` - A super-neighborhood that contains smaller divisions of type neighborhood, e.g.
+BoCaCa (Boerum Hill, Cobble Hill, and Carroll Gardens).
+- `neighborhood` - A neighborhood. Most neighborhoods will be just this, unless there's enough granular
+detail to justify introducing macrohood or microhood divisions.
+- `microhood` - A mini-neighborhood that is contained within a division of type neighborhood.
+
+## Used By
+
+- [`CapitalOfDivisionItem`](capital_of_division_item.md)
+- [`Division`](../division.md)
+- [`DivisionArea`](../division_area.md)
+- [`DivisionBoundary`](../division_boundary.md)
+- [`HierarchyItem`](hierarchy_item.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/divisions/types/hierarchy.md b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/hierarchy.md
new file mode 100644
index 000000000..22098138b
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/hierarchy.md
@@ -0,0 +1,21 @@
+# Hierarchy
+
+A hierarchy of divisions, with the first entry being a country; each subsequent
+entry, if any, being a division that is a direct child of the previous entry; and
+the last entry representing the division that contains the hierarchy.
+
+For example, a hierarchy for the United States is simply [United States]. A
+hierarchy for the U.S. state of New Hampshire would be
+[United States, New Hampshire], and a hierarchy for the city of Concord, NH would be
+[United States, New Hampshire, Merrimack County, Concord].
+
+Underlying type: `list<`[`HierarchyItem`](hierarchy_item.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Division`](../division.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/divisions/types/hierarchy_item.md b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/hierarchy_item.md
new file mode 100644
index 000000000..ffcf3aa94
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/hierarchy_item.md
@@ -0,0 +1,16 @@
+# HierarchyItem
+
+One division in a hierarchy.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `division_id` | [`Id`](../../system/ref/id.md) | ID of a division that is an ancestor of the current division.<br/><br/>In the context of division hierarchies, the ancestor divisions of a division include the division itself, and any other division that is an ancestor of the division's parent.<br/><br/>*References [`Division`](../division.md) (hierarchy, descendant of)* |
+| `subtype` | [`DivisionSubtype`](division_subtype.md) | |
+| `name` | [`StrippedString`](../../system/stripped_string.md) | Primary name of the division<br/><br/>*Minimum length: 1* |
+
+## Used By
+
+- [`Division`](../division.md)
+- [`Hierarchy`](hierarchy.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/divisions/types/norms.md b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/norms.md
new file mode 100644
index 000000000..be619f59c
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/divisions/types/norms.md
@@ -0,0 +1,13 @@
+# Norms
+
+Local norms and standards.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `driving_side` | [`Side`](../../common/scoping/side.md) (optional) | Side of the road on which vehicles drive in the division. |
+
+## Used By
+
+- [`Division`](../division.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/places/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/places/_category_.json
new file mode 100644
index 000000000..69d3715d6
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/places/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Places",
+  "position": 5
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/places/place.md b/schema_versioned_docs/version-v2.0.0/reference/places/place.md
new file mode 100644
index 000000000..cf459b98c
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/places/place.md
@@ -0,0 +1,118 @@
+---
+sidebar_position: 1
+---
+
+# Place
+
+Places are point representations of real-world facilities, businesses, services, or amenities.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/geometric.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/geometric.md) | Position of the place. Places are point geometries.<br/><br/>*Allowed geometry types: Point* |
+| `theme` | `"places"` | |
+| `type` | `"place"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` (optional) | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `operating_status` | [`OperatingStatus`](types/operating_status.md) (optional) | An indication of whether a place is: in continued operation, in a temporary operating hiatus, or closed permanently.<br/><br/>This is not an indication of opening hours or that the place is open/closed at the current time-of-day or day-of-week.<br/><br/>When `operating_status` is `"permanently_closed"`, the `confidence` field will be set to 0. |
+| `basic_category` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The basic level category of a place.<br/><br/>This field classifies places into categories at a level that most people find intuitive.<br/><br/>The basic level category, or simply basic category, is based on a cognitive science model use in taxonomy and ontology development. The idea is to provide the category name at the level of generality that is preferred by humans in learning and memory tasks. This category to be roughly in the middle of the general-to-specific category hierarchy.<br/><br/>The full list of basic level categories is available at https://docs.overturemaps.org/guides/places/ |
+| `taxonomy` | [`Taxonomy`](types/taxonomy.md) (optional) | A structured representation of the place's category within the Overture taxonomy.<br/><br/>Provides the primary classification, full hierarchy path, and alternate categories. |
+| `taxonomy.primary` | [`SnakeCaseString`](../system/snake_case_string.md) | The primary, or most specific, category known about this place.<br/><br/>The `primary` category value must always equal the last or rightmost entry in the `hierarchy` field. |
+| `taxonomy.hierarchy` | `list<`[`SnakeCaseString`](../system/snake_case_string.md)`>` | The full primary hierarchy of categories known for this place, ordered from most general to most specific. An example hierarchy might be: `["food_and_drink", "restaurant", "casual_eatery", "gas_station_sushi"]`.<br/><br/>The rightmost, or most specific, value in the `hierarchy` must always be equal to the `primary` field. The basic level category of the place will typically be found in the middle of the primary hierarchy. The primary hierarchy does not include any of the alternate categories found in the `alternates` field. |
+| `taxonomy.alternates` | `list<`[`SnakeCaseString`](../system/snake_case_string.md)`>` (optional) | Unordered list of additional categories that are known for this place but that are not part of the primary category hierarchy.<br/><br/>Alternate categories allow a more complete picture of the place to be surfaced when it fits multiple unconnected branches in the taxonomy. For example a gas station that also sells groceries might have primary category of "gas_station" with an alternate of "grocery_store".<br/><br/>Alternate categories are not part of the primary hierarchy or another alternate category's hierarchy. In other words, if a category is a parent in the hierarchy of another category, that category can't be a primary or alternate category itself.<br/><br/>Note as well that this field is an unordered list of extra categories and does not represent a hierarchy. |
+| `confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | A score between 0 and 1 indicating how confident we are that the place exists.<br/><br/>A confidence score of 0 indicates that we are certain the place doesn't exist anymore and will always be paired with an `operating_status` of `"permanently_closed"`.<br/><br/>A confidence score of 1 indicates that we are certain the place does exist.<br/><br/>If there is no value for confidence, it means we don't have enough information on which to estimate our confidence level. |
+| `websites` | `list<`[`HttpUrl`](../pydantic/networks/http_url.md)`>` (optional) | The websites of the place.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `socials` | `list<`[`HttpUrl`](../pydantic/networks/http_url.md)`>` (optional) | The social media URLs of the place.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `emails` | `list<`[`EmailStr`](../pydantic/networks/email_str.md)`>` (optional) | The email addresses of the place.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `phones` | `list<`[`PhoneNumber`](../system/phone_number.md)`>` (optional) | The phone numbers of the place.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `brand` | [`Brand`](types/brand.md) (optional) | The brand associated with the place. |
+| `brand.names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `brand.names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `brand.names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `brand.names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `brand.names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `brand.names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `brand.names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `brand.names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `brand.names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `brand.names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `brand.names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `brand.names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `brand.wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+| `addresses[]` | `list<`[`Address`](types/address.md)`>` (optional) | The address or addresses of the place<br/><br/>*Minimum length: 1* |
+| `addresses[].freeform` | `string` (optional) | Free-form address that contains street name, house number and other address info |
+| `addresses[].locality` | `string` (optional) | City, town, or neighborhood component of the place address |
+| `addresses[].postcode` | `string` (optional) | Postal code component of the place address |
+| `addresses[].region` | [`RegionCode`](../system/region_code.md) (optional) | An ISO 3166-2 principal subdivision code |
+| `addresses[].country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) (optional) | An ISO 3166-1 alpha-2 country code |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `99003ee6-e75b-4dd6-8a8a-53a5a716c50d` |
+| `bbox.xmin` | `-150.46875` |
+| `bbox.ymin` | `-79.17134094238281` |
+| `bbox.xmax` | `-150.46875` |
+| `bbox.ymax` | `-79.17133331298828` |
+| `geometry` | `POINT (-150.46875 -79.1713346)` |
+| `theme` | `places` |
+| `type` | `place` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `meta` |
+| `sources[0].license` | `null` |
+| `sources[0].record_id` | `107663894904826` |
+| `sources[0].update_time` | `2025-06-30T07:00:00+00:00` |
+| `sources[0].confidence` | `0.7337175792507205` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `operating_status` | `open` |
+| `basic_category` | `hotel` |
+| `taxonomy.primary` | `hotel` |
+| `taxonomy.hierarchy` | `["lodging", "hotel"]` |
+| `taxonomy.alternates` | `null` |
+| `confidence` | `0.7337175792507205` |
+| `websites` | `["https://www.superhotel.co.jp/s_hotels/beppu/"]` |
+| `socials` | `["https://www.facebook.com/107663894904826"]` |
+| `emails` | `null` |
+| `phones` | `["+81977009000"]` |
+| `brand.names.primary` | `SUPER HOTEL` |
+| `brand.names.common` | `null` |
+| `brand.names.rules` | `null` |
+| `brand.wikidata` | `null` |
+| `addresses[0].freeform` | `秋田県横手市駅前町１３−８` |
+| `addresses[0].locality` | `横手市` |
+| `addresses[0].postcode` | `013-0036` |
+| `addresses[0].region` | `null` |
+| `addresses[0].country` | `JP` |
+| `names.primary` | `スーパーホテル別府駅前` |
+| `names.common` | `null` |
+| `names.rules` | `null` |
diff --git a/schema_versioned_docs/version-v2.0.0/reference/places/types/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/places/types/_category_.json
new file mode 100644
index 000000000..a3ec08974
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/places/types/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Types"
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/places/types/address.md b/schema_versioned_docs/version-v2.0.0/reference/places/types/address.md
new file mode 100644
index 000000000..b64d5be16
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/places/types/address.md
@@ -0,0 +1,17 @@
+# Address
+
+An address associated with a place.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `freeform` | `string` (optional) | Free-form address that contains street name, house number and other address info |
+| `locality` | `string` (optional) | City, town, or neighborhood component of the place address |
+| `postcode` | `string` (optional) | Postal code component of the place address |
+| `region` | [`RegionCode`](../../system/region_code.md) (optional) | An ISO 3166-2 principal subdivision code |
+| `country` | [`CountryCodeAlpha2`](../../system/country_code_alpha2.md) (optional) | An ISO 3166-1 alpha-2 country code |
+
+## Used By
+
+- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/places/types/brand.md b/schema_versioned_docs/version-v2.0.0/reference/places/types/brand.md
new file mode 100644
index 000000000..65ebf269d
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/places/types/brand.md
@@ -0,0 +1,27 @@
+# Brand
+
+A brand associated with a place.
+
+A location with multiple brands is modeled as multiple separate places, each with its own brand.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `names` | [`Names`](../../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `wikidata` | [`WikidataId`](../../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+
+## Used By
+
+- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/places/types/operating_status.md b/schema_versioned_docs/version-v2.0.0/reference/places/types/operating_status.md
new file mode 100644
index 000000000..61b17c7fe
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/places/types/operating_status.md
@@ -0,0 +1,19 @@
+# OperatingStatus
+
+General indication of whether a place is: in continued operation, in a temporary operating
+hiatus, or closed permanently.
+
+Operating status should not be confused with opening hours or operating hours. In particular,
+the status `"open"` does not mean the place is open *right now*, it means that in general the
+place is continuing to operate normally, as opposed to being in an operating hiatus
+(`"temporarily_closed"`) or shuttered (`"permanently_closed"`).
+
+## Values
+
+- `open`
+- `permanently_closed`
+- `temporarily_closed`
+
+## Used By
+
+- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/places/types/taxonomy.md b/schema_versioned_docs/version-v2.0.0/reference/places/types/taxonomy.md
new file mode 100644
index 000000000..33f5b4da9
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/places/types/taxonomy.md
@@ -0,0 +1,17 @@
+# Taxonomy
+
+A structured representation of the place's category within the Overture taxonomy.
+
+Provides the primary classification, full hierarchy path, and alternate categories.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `primary` | [`SnakeCaseString`](../../system/snake_case_string.md) | The primary, or most specific, category known about this place.<br/><br/>The `primary` category value must always equal the last or rightmost entry in the `hierarchy` field. |
+| `hierarchy` | `list<`[`SnakeCaseString`](../../system/snake_case_string.md)`>` | The full primary hierarchy of categories known for this place, ordered from most general to most specific. An example hierarchy might be: `["food_and_drink", "restaurant", "casual_eatery", "gas_station_sushi"]`.<br/><br/>The rightmost, or most specific, value in the `hierarchy` must always be equal to the `primary` field. The basic level category of the place will typically be found in the middle of the primary hierarchy. The primary hierarchy does not include any of the alternate categories found in the `alternates` field.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `alternates` | `list<`[`SnakeCaseString`](../../system/snake_case_string.md)`>` (optional) | Unordered list of additional categories that are known for this place but that are not part of the primary category hierarchy.<br/><br/>Alternate categories allow a more complete picture of the place to be surfaced when it fits multiple unconnected branches in the taxonomy. For example a gas station that also sells groceries might have primary category of "gas_station" with an alternate of "grocery_store".<br/><br/>Alternate categories are not part of the primary hierarchy or another alternate category's hierarchy. In other words, if a category is a parent in the hierarchy of another category, that category can't be a primary or alternate category itself.<br/><br/>Note as well that this field is an unordered list of extra categories and does not represent a hierarchy.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+
+## Used By
+
+- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/pydantic/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/pydantic/_category_.json
new file mode 100644
index 000000000..6bc65c372
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/pydantic/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Pydantic",
+  "position": 8
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/pydantic/networks/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/pydantic/networks/_category_.json
new file mode 100644
index 000000000..8dc67bc4c
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/pydantic/networks/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Networks"
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/pydantic/networks/email_str.md b/schema_versioned_docs/version-v2.0.0/reference/pydantic/networks/email_str.md
new file mode 100644
index 000000000..3bf99260b
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/pydantic/networks/email_str.md
@@ -0,0 +1,7 @@
+# EmailStr
+
+See: [Pydantic docs](https://docs.pydantic.dev/latest/api/networks/#pydantic.networks.EmailStr)
+
+## Used By
+
+- [`Place`](../../places/place.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/pydantic/networks/http_url.md b/schema_versioned_docs/version-v2.0.0/reference/pydantic/networks/http_url.md
new file mode 100644
index 000000000..b4b25f0ef
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/pydantic/networks/http_url.md
@@ -0,0 +1,9 @@
+# HttpUrl
+
+A type that will accept any http or https URL.
+
+See: [Pydantic docs](https://docs.pydantic.dev/latest/api/networks/#pydantic.networks.HttpUrl)
+
+## Used By
+
+- [`Place`](../../places/place.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/system/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/system/_category_.json
new file mode 100644
index 000000000..22378997a
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/system/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "System",
+  "position": 9
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/system/country_code_alpha2.md b/schema_versioned_docs/version-v2.0.0/reference/system/country_code_alpha2.md
new file mode 100644
index 000000000..815aaacfa
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/system/country_code_alpha2.md
@@ -0,0 +1,18 @@
+# CountryCodeAlpha2
+
+An ISO-3166-1 alpha-2 country code.
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only ISO 3166-1 alpha-2 country codes. (`CountryCodeAlpha2Constraint`, pattern: `^[A-Z]{2}$`)
+
+## Used By
+
+- [`Address`](../addresses/address.md)
+- [`Address`](../places/types/address.md)
+- [`Division`](../divisions/division.md)
+- [`DivisionArea`](../divisions/division_area.md)
+- [`DivisionBoundary`](../divisions/division_boundary.md)
+- [`Perspectives`](../common/perspectives.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/system/geometric.md b/schema_versioned_docs/version-v2.0.0/reference/system/geometric.md
new file mode 100644
index 000000000..25d26fde7
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/system/geometric.md
@@ -0,0 +1,11 @@
+# Geometry Types
+
+Spatial types for representing geographic features.
+
+## Types
+
+| Type | Description |
+| -----: | ------------- |
+| `Geometry` | GeoJSON geometry value (Point, LineString, Polygon, etc.) |
+| `BBox` | Bounding box as 4 or 6 coordinate values: [west, south, east, north] or [west, south, min-altitude, east, north, max-altitude] |
+| `GeometryType` | Enumeration of geometry types: `geometry_collection`, `line_string`, `multi_line_string`, `multi_point`, `multi_polygon`, `point`, `polygon` |
\ No newline at end of file
diff --git a/schema_versioned_docs/version-v2.0.0/reference/system/hex_color.md b/schema_versioned_docs/version-v2.0.0/reference/system/hex_color.md
new file mode 100644
index 000000000..a22c9c1fb
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/system/hex_color.md
@@ -0,0 +1,20 @@
+# HexColor
+
+A color represented as an #RRGGBB or #RGB hexadecimal string.
+
+For example:
+
+- `"#ff0000"` or `#f00` for pure red 🟥
+- `"#ffa500"` for bright orange 🟧
+- `"#000000"` or `"#000"` for black ⬛
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only hexadecimal color codes (e.g., #FF0000 or #FFF). (`HexColorConstraint`, pattern: `^#[0-9A-Fa-f]{3}([0-9A-Fa-f]{3})?$`)
+
+## Used By
+
+- [`Building`](../buildings/building.md)
+- [`BuildingPart`](../buildings/building_part.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/system/json_pointer.md b/schema_versioned_docs/version-v2.0.0/reference/system/json_pointer.md
new file mode 100644
index 000000000..6363abdc1
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/system/json_pointer.md
@@ -0,0 +1,23 @@
+# JsonPointer
+
+A JSON Pointer
+
+As described in `the JSON Pointer specification, RFC-6901`_.
+
+.. _the JSON Pointer specification, RFC-6901: [https://rfc-editor.org/rfc/rfc6901.html](https://rfc-editor.org/rfc/rfc6901.html)
+
+For example:
+
+- `""` (root value)
+- `"/connectors/"`
+- `"/connectors/0/at"`
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only valid JSON Pointer values (RFC 6901). (`JsonPointerConstraint`)
+
+## Used By
+
+- [`SourceItem`](../common/source_item.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/system/language_tag.md b/schema_versioned_docs/version-v2.0.0/reference/system/language_tag.md
new file mode 100644
index 000000000..c3145671a
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/system/language_tag.md
@@ -0,0 +1,27 @@
+# LanguageTag
+
+A BCP-47 language tag.
+
+As described in `Tags for Identifying Languages, BCP-47`_.
+
+.. _Tags for Identifying Languages, BCP-47: [https://www.rfc-editor.org/rfc/bcp/bcp47.txt](https://www.rfc-editor.org/rfc/bcp/bcp47.txt)
+
+For example:
+
+- `"en"`
+- `"en-US"`
+- `"fr-CA"`
+- `"zh-Hant-TW"`
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only `BCP-47`_ language tags. (`LanguageTagConstraint`, pattern: `^(?:(?:[A-Za-z]{2,3}(?:-[A-Za-z]{3}){0,3}?)|(?:[A-Za-z]{4,8}))(?:-[A-Za-z]{4})?(?:-[A-Za-z]{2}|[0-9]{3})?(?:-(?:[A-Za-z0-9]{5,8}|[0-9][A-Za-z0-9]{3}))*(?:-[A-WY-Za-wy-z0-9](?:-[A-Za-z0-9]{2,8})+)*$`)
+
+## Used By
+
+- [`Division`](../divisions/division.md)
+- [`NameRule`](../common/name_rule.md)
+- [`Names`](../common/names.md)
+- [`CommonNames`](../common/common_names.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/system/no_whitespace_string.md b/schema_versioned_docs/version-v2.0.0/reference/system/no_whitespace_string.md
new file mode 100644
index 000000000..09c2186f1
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/system/no_whitespace_string.md
@@ -0,0 +1,14 @@
+# NoWhitespaceString
+
+A string that contains no whitespace characters.
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only strings that contain no whitespace characters. (`NoWhitespaceConstraint`, pattern: `^\S+$`)
+
+## Used By
+
+- [`SourceItem`](../common/source_item.md)
+- [`Id`](ref/id.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/system/numeric.md b/schema_versioned_docs/version-v2.0.0/reference/system/numeric.md
new file mode 100644
index 000000000..96b9be2fa
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/system/numeric.md
@@ -0,0 +1,27 @@
+# Numeric Types
+
+Numeric types used for schema field definitions.
+
+## Integer Types
+
+| Type | Range | Description |
+| -----: | :-----: | ------------- |
+| `int8` | -128 to 127 | Portable 8-bit signed integer. |
+| `int16` | -32,768 to 32,767 | Portable 16-bit signed integer. |
+| `int32` | -2,147,483,648 to 2,147,483,647 | Portable 32-bit signed integer. |
+| `int64` | -2^63 to 2^63-1 | Portable 64-bit signed integer. |
+
+## Unsigned Integer Types
+
+| Type | Range | Description |
+| -----: | :-----: | ------------- |
+| `uint8` | 0 to 255 | Portable 8-bit unsigned integer. |
+| `uint16` | 0 to 65,535 | Portable 16-bit unsigned integer. |
+| `uint32` | 0 to 4,294,967,295 | Portable 32-bit unsigned integer. |
+
+## Floating Point Types
+
+| Type | Precision | Description |
+| -----: | :---------: | ------------- |
+| `float32` | ~7 decimal digits | Portable IEEE 32-bit floating point number. |
+| `float64` | ~15 decimal digits | Portable IEEE 64-bit floating point number. |
diff --git a/schema_versioned_docs/version-v2.0.0/reference/system/phone_number.md b/schema_versioned_docs/version-v2.0.0/reference/system/phone_number.md
new file mode 100644
index 000000000..8bfed0469
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/system/phone_number.md
@@ -0,0 +1,13 @@
+# PhoneNumber
+
+An international phone number.
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only international phone numbers. (`PhoneNumberConstraint`, pattern: `^\+\d{1,3}[\s\-\(\)0-9]+$`)
+
+## Used By
+
+- [`Place`](../places/place.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/system/ref/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/system/ref/_category_.json
new file mode 100644
index 000000000..a3d90fc8f
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/system/ref/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Ref"
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/system/ref/id.md b/schema_versioned_docs/version-v2.0.0/reference/system/ref/id.md
new file mode 100644
index 000000000..a0c33d064
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/system/ref/id.md
@@ -0,0 +1,33 @@
+# Id
+
+A unique identifier.
+
+Underlying type: `string`
+
+## Constraints
+
+- Minimum length: 1
+- Allows only strings that contain no whitespace characters. (`NoWhitespaceConstraint`, pattern: `^\S+$`) (from [`NoWhitespaceString`](../no_whitespace_string.md))
+
+## Used By
+
+- [`Address`](../../addresses/address.md)
+- [`Bathymetry`](../../base/bathymetry.md)
+- [`Building`](../../buildings/building.md)
+- [`BuildingPart`](../../buildings/building_part.md)
+- [`CapitalOfDivisionItem`](../../divisions/types/capital_of_division_item.md)
+- [`Connector`](../../transportation/connector.md)
+- [`ConnectorReference`](../../transportation/types/segment/connector_reference.md)
+- [`DestinationRule`](../../transportation/types/segment/destination_rule.md)
+- [`Division`](../../divisions/division.md)
+- [`DivisionArea`](../../divisions/division_area.md)
+- [`DivisionBoundary`](../../divisions/division_boundary.md)
+- [`HierarchyItem`](../../divisions/types/hierarchy_item.md)
+- [`Infrastructure`](../../base/infrastructure.md)
+- [`Land`](../../base/land.md)
+- [`LandCover`](../../base/land_cover.md)
+- [`LandUse`](../../base/land_use.md)
+- [`Place`](../../places/place.md)
+- [`ProhibitedTransitionSequenceEntry`](../../transportation/types/segment/prohibited_transition_sequence_entry.md)
+- [`Segment`](../../transportation/segment.md)
+- [`Water`](../../base/water.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/system/region_code.md b/schema_versioned_docs/version-v2.0.0/reference/system/region_code.md
new file mode 100644
index 000000000..bf2f016ee
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/system/region_code.md
@@ -0,0 +1,16 @@
+# RegionCode
+
+An ISO 3166-2 principal subdivision code.
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only ISO 3166-2 principal subdivision codes. (`RegionCodeConstraint`, pattern: `^[A-Z]{2}-[A-Z0-9]{1,3}$`)
+
+## Used By
+
+- [`Address`](../places/types/address.md)
+- [`Division`](../divisions/division.md)
+- [`DivisionArea`](../divisions/division_area.md)
+- [`DivisionBoundary`](../divisions/division_boundary.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/system/snake_case_string.md b/schema_versioned_docs/version-v2.0.0/reference/system/snake_case_string.md
new file mode 100644
index 000000000..df2d73f21
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/system/snake_case_string.md
@@ -0,0 +1,15 @@
+# SnakeCaseString
+
+A string that looks like a snake case identifier, like a Python variable name (*e.g.*, `foo_bar`).
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only strings that look like snake case identifiers, *e.g.* `"foo_bar"`. (`SnakeCaseConstraint`, pattern: `^[a-z0-9]+(_[a-z0-9]+)*$`)
+
+## Used By
+
+- [`Place`](../places/place.md)
+- [`SourceItem`](../common/source_item.md)
+- [`Taxonomy`](../places/types/taxonomy.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/system/stripped_string.md b/schema_versioned_docs/version-v2.0.0/reference/system/stripped_string.md
new file mode 100644
index 000000000..bf92043d4
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/system/stripped_string.md
@@ -0,0 +1,22 @@
+# StrippedString
+
+A string without leading or trailing whitespace.
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only strings that have no leading/trailing whitespace. (`StrippedConstraint`, pattern: `^(\S(.*\S)?)?\Z`)
+
+## Used By
+
+- [`Address`](../addresses/address.md)
+- [`AddressLevel`](../addresses/types/address_level.md)
+- [`DestinationLabels`](../transportation/types/segment/destination_labels.md)
+- [`Division`](../divisions/division.md)
+- [`HierarchyItem`](../divisions/types/hierarchy_item.md)
+- [`NameRule`](../common/name_rule.md)
+- [`Names`](../common/names.md)
+- [`RouteReference`](../transportation/types/segment/route_reference.md)
+- [`SourceItem`](../common/source_item.md)
+- [`CommonNames`](../common/common_names.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/system/wikidata_id.md b/schema_versioned_docs/version-v2.0.0/reference/system/wikidata_id.md
new file mode 100644
index 000000000..37121da17
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/system/wikidata_id.md
@@ -0,0 +1,23 @@
+# WikidataId
+
+A wikidata ID, as found on [https://www.wikidata.org/](https://www.wikidata.org/).
+
+- `"Q42"`
+- `"Q11643"`
+- `"Q116257497"`
+
+Underlying type: `string`
+
+## Constraints
+
+- Allows only Wikidata identifiers (Q followed by digits). (`WikidataIdConstraint`, pattern: `^Q\d+$`)
+
+## Used By
+
+- [`Brand`](../places/types/brand.md)
+- [`Division`](../divisions/division.md)
+- [`Infrastructure`](../base/infrastructure.md)
+- [`Land`](../base/land.md)
+- [`LandUse`](../base/land_use.md)
+- [`RouteReference`](../transportation/types/segment/route_reference.md)
+- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/transportation/_category_.json
new file mode 100644
index 000000000..597025adb
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Transportation",
+  "position": 6
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/connector.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/connector.md
new file mode 100644
index 000000000..ee0ce6cc9
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/connector.md
@@ -0,0 +1,55 @@
+---
+sidebar_position: 1
+---
+
+# Connector
+
+Connectors create physical connections between segments.
+
+Connectors are compatible with GeoJSON Point features.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/geometric.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/geometric.md) | Position of the connector<br/><br/>*Allowed geometry types: Point* |
+| `theme` | `"transportation"` | |
+| `type` | `"connector"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` (optional) | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+
+## Examples
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `73a46c48-dc5a-4162-b9c8-1643298784c3` |
+| `bbox.xmin` | `30.048397064208984` |
+| `bbox.ymin` | `-25.70870018005371` |
+| `bbox.xmax` | `30.04840087890625` |
+| `bbox.ymax` | `-25.708696365356445` |
+| `geometry` | `POINT (30.048398 -25.708697)` |
+| `theme` | `transportation` |
+| `type` | `connector` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `ODbL-1.0` |
+| `sources[0].record_id` | `n252436807@6` |
+| `sources[0].update_time` | `2025-01-06T20:44:06+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/segment.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/segment.md
new file mode 100644
index 000000000..a78065bbf
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/segment.md
@@ -0,0 +1,277 @@
+---
+sidebar_position: 1
+---
+
+# Segment
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
+| `bbox` | [`bbox`](../system/geometric.md) (optional) | An optional bounding box for the feature |
+| `geometry` | [`geometry`](../system/geometric.md) | Segment centerline<br/><br/>*Allowed geometry types: LineString* |
+| `theme` | `"transportation"` | |
+| `type` | `"segment"` | |
+| `version` | [`FeatureVersion`](../common/feature_version.md) | |
+| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
+| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
+| `sources[].dataset` | `string` (optional) | Name of the dataset where the source data can be found. |
+| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
+| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
+| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
+| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
+| `sources[].provider` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The provider label for the entity that contributed this data (e.g., osm, meta, esri). |
+| `sources[].resource` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The subject or type of data contributed by the provider (e.g., planet, buildings, division_names). |
+| `sources[].version` | [`NoWhitespaceString`](../system/no_whitespace_string.md) (optional) | A sortable identifier for the specific snapshot of the resource (e.g., 2026-02-13, 5.3, A5692). |
+| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
+| `subtype` | [`SegmentSubtype`](types/segment/segment_subtype.md) | Broad category of transportation segment. |
+| `connectors[]` | `list<`[`ConnectorReference`](types/segment/connector_reference.md)`>` | List of connectors which this segment is physically connected to and their relative location. Each connector is a possible routing decision point, meaning it defines a place along the segment in which there is possibility to transition to other segments which share the same connector.<br/><br/>*Minimum length: 2*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `connectors[].connector_id` | [`Id`](../system/ref/id.md) | A unique identifier |
+| `connectors[].at` | [`LinearlyReferencedPosition`](../common/scoping/linearly_referenced_position.md) (optional) | The linearly-referenced position on the geometry, specified as a percentage displacement from the start of the geometry, that the containing ConnectorReference applies to. |
+| `access_restrictions[]` | [`AccessRules`](types/segment/access_rules.md) (list, optional) | Rules governing access to this road segment |
+| `access_restrictions[].access_type` | [`AccessType`](types/segment/access_type.md) | |
+| `access_restrictions[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing AccessRule applies to. |
+| `access_restrictions[].when` | [`AccessRule.When`](types/segment/access_rule.when.md) (optional) | Scopes for AccessRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
+| `access_restrictions[].when.heading` | [`Heading`](../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing AccessRule applies to. |
+| `access_restrictions[].when.during` | [`OpeningHours`](../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing AccessRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
+| `access_restrictions[].when.mode` | `list<`[`TravelMode`](../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing AccessRule applies to. |
+| `access_restrictions[].when.using` | `list<`[`PurposeOfUse`](../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing AccessRule applies to. |
+| `access_restrictions[].when.recognized` | `list<`[`RecognizedStatus`](../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing AccessRule applies to. |
+| `access_restrictions[].when.vehicle` | [`VehicleAxleCountSelector`](../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing AccessRule applies to. |
+| `level_rules[]` | [`LevelRules`](types/segment/level_rules.md) (list, optional) | Defines the Z-order, i.e. stacking order, of the road segment. |
+| `level_rules[].value` | [`Level`](../common/level.md) | Z-order of the feature where 0 is visual level |
+| `level_rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing LevelRule applies to. |
+| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
+| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
+| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
+| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
+| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
+| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
+| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
+| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
+| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
+| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
+| `class` *(Road)* | [`RoadClass`](types/segment/road_class.md) | |
+| `destinations[]` *(Road)* | [`Destinations`](types/segment/destinations.md) (list, optional) | Describes objects that can be reached by following a transportation segment in the same way those objects are described on signposts or ground writing that a traveller following the segment would observe in the real world. This allows navigation systems to refer to signs and observable writing that a traveller actually sees. |
+| `destinations[].from_connector_id` | [`Id`](../system/ref/id.md) | Identifies the point of physical connection on this segment before which the destination sign or marking is visible. |
+| `destinations[].to_connector_id` | [`Id`](../system/ref/id.md) | Identifies the point of physical connection on the segment identified by 'to_segment_id' to transition to for reaching the destination(s). |
+| `destinations[].to_segment_id` | [`Id`](../system/ref/id.md) | Identifies the segment to transition to reach the destination(s) labeled on the sign or marking. |
+| `destinations[].final_heading` | [`Heading`](../common/scoping/heading.md) | Direction of travel on the segment identified by 'to_segment_id' that leads to the destination. |
+| `destinations[].labels[]` | `list<`[`DestinationLabels`](types/segment/destination_labels.md)`>` (optional) | Labeled destinations that can be reached by following the segment. |
+| `destinations[].labels[].value` | [`StrippedString`](../system/stripped_string.md) | Names the object that is reached |
+| `destinations[].labels[].type` | [`DestinationLabelType`](types/segment/destination_label_type.md) | |
+| `destinations[].symbols` | `list<`[`DestinationSignSymbol`](types/segment/destination_sign_symbol.md)`>` (optional) | A collection of symbols or icons present on the sign next to current destination label. |
+| `destinations[].when` | [`DestinationRule.When`](types/segment/destination_rule.when.md) (optional) | Scope for DestinationRule: |
+| `destinations[].when.heading` | [`Heading`](../common/scoping/heading.md) | The heading, either forward or backward, that the containing DestinationRule applies to. |
+| `prohibited_transitions[]` *(Road)* | [`ProhibitedTransitions`](types/segment/prohibited_transitions.md) (list, optional) | Rules for when transition to a connected segment is not allowed (commonly known as turn restrictions). |
+| `prohibited_transitions[].sequence[]` | `list<`[`ProhibitedTransitionSequenceEntry`](types/segment/prohibited_transition_sequence_entry.md)`>` | Ordered sequence of connector/segment pairs that it is prohibited to follow from this segment. |
+| `prohibited_transitions[].sequence[].connector_id` | [`Id`](../system/ref/id.md) | Identifies the point of physical connection between the previous segment in the sequence and the segment in this sequence entry. |
+| `prohibited_transitions[].sequence[].segment_id` | [`Id`](../system/ref/id.md) | Identifies the segment that the previous segment in the sequence is physically connected to via the sequence entry's connector. |
+| `prohibited_transitions[].final_heading` | [`Heading`](../common/scoping/heading.md) | Direction of travel that is prohibited on the destination segment of the sequence. |
+| `prohibited_transitions[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing ProhibitedTransitionRule applies to. |
+| `prohibited_transitions[].when` | [`ProhibitedTransitionRule.When`](types/segment/prohibited_transition_rule.when.md) (optional) | Scopes for ProhibitedTransitionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
+| `prohibited_transitions[].when.heading` | [`Heading`](../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing ProhibitedTransitionRule applies to. |
+| `prohibited_transitions[].when.during` | [`OpeningHours`](../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing ProhibitedTransitionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
+| `prohibited_transitions[].when.mode` | `list<`[`TravelMode`](../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing ProhibitedTransitionRule applies to. |
+| `prohibited_transitions[].when.using` | `list<`[`PurposeOfUse`](../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing ProhibitedTransitionRule applies to. |
+| `prohibited_transitions[].when.recognized` | `list<`[`RecognizedStatus`](../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing ProhibitedTransitionRule applies to. |
+| `prohibited_transitions[].when.vehicle` | [`VehicleAxleCountSelector`](../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing ProhibitedTransitionRule applies to. |
+| `road_flags[]` *(Road)* | [`RoadFlags`](types/segment/road_flags.md) (list, optional) | Set of boolean attributes applicable to roads. May be specified either as a single flag array of flag values, or as an array of flag rules. |
+| `road_flags[].values` | `list<`[`RoadFlag`](types/segment/road_flag.md)`>` | |
+| `road_flags[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RoadFlagRule applies to. |
+| `road_surface[]` *(Road)* | [`RoadSurfaces`](types/segment/road_surfaces.md) (list, optional) | Rules describing the physical surface of the road. |
+| `road_surface[].value` | [`RoadSurface`](types/segment/road_surface.md) | |
+| `road_surface[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RoadSurfaceRule applies to. |
+| `routes[]` *(Road)* | [`Routes`](types/segment/routes.md) (list, optional) | Routes this segment belongs to |
+| `routes[].name` | [`StrippedString`](../system/stripped_string.md) (optional) | Full name of the route |
+| `routes[].network` | [`StrippedString`](../system/stripped_string.md) (optional) | Name of the highway system this route belongs to |
+| `routes[].ref` | [`StrippedString`](../system/stripped_string.md) (optional) | Code or number used to reference the route |
+| `routes[].symbol` | [`StrippedString`](../system/stripped_string.md) (optional) | URL or description of route signage |
+| `routes[].wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+| `routes[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RouteReference applies to. |
+| `speed_limits[]` *(Road)* | [`SpeedLimits`](types/segment/speed_limits.md) (list, optional) | Rules governing speed on this road segment |
+| `speed_limits[].max_speed` | [`Speed`](types/segment/speed.md) (optional) | |
+| `speed_limits[].max_speed.value` | [`SpeedValue`](types/segment/speed_value.md) | Speed value |
+| `speed_limits[].max_speed.unit` | [`SpeedUnit`](../common/speed_unit.md) | |
+| `speed_limits[].min_speed` | [`Speed`](types/segment/speed.md) (optional) | |
+| `speed_limits[].min_speed.value` | [`SpeedValue`](types/segment/speed_value.md) | Speed value |
+| `speed_limits[].min_speed.unit` | [`SpeedUnit`](../common/speed_unit.md) | |
+| `speed_limits[].is_max_speed_variable` | `boolean` (optional) | Indicates a variable speed corridor |
+| `speed_limits[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SpeedLimitRule applies to. |
+| `speed_limits[].when` | [`SpeedLimitRule.When`](types/segment/speed_limit_rule.when.md) (optional) | Scopes for SpeedLimitRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
+| `speed_limits[].when.heading` | [`Heading`](../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing SpeedLimitRule applies to. |
+| `speed_limits[].when.during` | [`OpeningHours`](../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing SpeedLimitRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
+| `speed_limits[].when.mode` | `list<`[`TravelMode`](../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing SpeedLimitRule applies to. |
+| `speed_limits[].when.using` | `list<`[`PurposeOfUse`](../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing SpeedLimitRule applies to. |
+| `speed_limits[].when.recognized` | `list<`[`RecognizedStatus`](../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing SpeedLimitRule applies to. |
+| `speed_limits[].when.vehicle` | [`VehicleAxleCountSelector`](../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing SpeedLimitRule applies to. |
+| `subclass` *(Road)* | [`RoadSubclass`](types/segment/road_subclass.md) (optional) | |
+| `subclass_rules[]` *(Road)* | [`RoadSubclassRules`](types/segment/road_subclass_rules.md) (list, optional) | Set of subclasses scoped along segment |
+| `subclass_rules[].value` | [`RoadSubclass`](types/segment/road_subclass.md) | |
+| `subclass_rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RoadSubclassRule applies to. |
+| `width_rules[]` *(Road)* | [`WidthRules`](types/segment/width_rules.md) (list, optional) | Edge-to-edge width of the feature modeled by this segment, in meters.<br/><br/>Examples: (1) If this segment models a carriageway without sidewalk, this value represents the edge-to-edge width of the carriageway, inclusive of any shoulder. (2) If this segment models a sidewalk by itself, this value represents the edge-to-edge width of the sidewalk. (3) If this segment models a combined sidewalk and carriageway, this value represents the edge-to-edge width inclusive of sidewalk. |
+| `width_rules[].value` | [`Width`](types/segment/width.md) | Edge-to-edge width of the feature modeled by this segment, in meters. |
+| `width_rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing WidthRule applies to. |
+| `class` *(Rail)* | [`RailClass`](types/segment/rail_class.md) | |
+| `rail_flags[]` *(Rail)* | [`RailFlags`](types/segment/rail_flags.md) (list, optional) | Set of boolean attributes applicable to railways. May be specified either as a single flag array of flag values, or as an array of flag rules. |
+| `rail_flags[].values` | `list<`[`RailFlag`](types/segment/rail_flag.md)`>` | |
+| `rail_flags[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RailFlagRule applies to. |
+
+## Examples
+
+### Example 1
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `621e0a00-9466-4c3f-bb4a-64a83cd7a934` |
+| `bbox.xmin` | `30.048397` |
+| `bbox.ymin` | `-25.713358` |
+| `bbox.xmax` | `30.05359` |
+| `bbox.ymax` | `-25.708696` |
+| `geometry` | `LINESTRING (30.048398 -25.708697, 30.0485458 -25.708892, 30.0487074 -25.7090728, 30.0488875 -25.7...` |
+| `theme` | `transportation` |
+| `type` | `segment` |
+| `version` | `4` |
+| `sources[0].property` | `/routes` |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `ODbL-1.0` |
+| `sources[0].record_id` | `r1808544@180` |
+| `sources[0].update_time` | `null` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `sources[1].property` | `/routes` |
+| `sources[1].dataset` | `OpenStreetMap` |
+| `sources[1].license` | `ODbL-1.0` |
+| `sources[1].record_id` | `r1808545@177` |
+| `sources[1].update_time` | `null` |
+| `sources[1].confidence` | `null` |
+| `sources[1].provider` | `null` |
+| `sources[1].resource` | `null` |
+| `sources[1].version` | `null` |
+| `sources[1].between` | `null` |
+| `sources[2].property` |  |
+| `sources[2].dataset` | `OpenStreetMap` |
+| `sources[2].license` | `ODbL-1.0` |
+| `sources[2].record_id` | `w338134264@15` |
+| `sources[2].update_time` | `2025-04-21T09:53:35+00:00` |
+| `sources[2].confidence` | `null` |
+| `sources[2].provider` | `null` |
+| `sources[2].resource` | `null` |
+| `sources[2].version` | `null` |
+| `sources[2].between` | `null` |
+| `subtype` | `road` |
+| `connectors[0].connector_id` | `73a46c48-dc5a-4162-b9c8-1643298784c3` |
+| `connectors[0].at` | `0.0` |
+| `connectors[1].connector_id` | `e81188ed-9b2f-48b4-99f2-d894044d88f5` |
+| `connectors[1].at` | `0.154695182` |
+| `connectors[2].connector_id` | `11124794-8830-4aff-bd09-f578d3a196b1` |
+| `connectors[2].at` | `0.483463065` |
+| `connectors[3].connector_id` | `cfda5f80-ffe6-4b5c-b219-4f208e0a3832` |
+| `connectors[3].at` | `0.753014135` |
+| `connectors[4].connector_id` | `a5871213-947e-4342-b486-f560f0ac22f3` |
+| `connectors[4].at` | `1.0` |
+| `access_restrictions[0].access_type` | `denied` |
+| `access_restrictions[0].between` | `null` |
+| `access_restrictions[0].when.heading` | `null` |
+| `access_restrictions[0].when.during` | `null` |
+| `access_restrictions[0].when.mode` | `null` |
+| `access_restrictions[0].when.using` | `null` |
+| `access_restrictions[0].when.recognized` | `null` |
+| `access_restrictions[0].when.vehicle[0].dimension` | `height` |
+| `access_restrictions[0].when.vehicle[0].comparison` | `greater_than` |
+| `access_restrictions[0].when.vehicle[0].value` | `5.2` |
+| `access_restrictions[0].when.vehicle[0].unit` | `m` |
+| `level_rules` | `null` |
+| `names.primary` | `Vermooten Street` |
+| `names.common` | `null` |
+| `destinations` | `null` |
+| `prohibited_transitions` | `null` |
+| `road_flags` | `null` |
+| `road_surface[0].value` | `paved` |
+| `road_surface[0].between` | `null` |
+| `routes[0].name` | `R33 (northbound)` |
+| `routes[0].network` | `za:regional` |
+| `routes[0].ref` | `R33` |
+| `routes[0].symbol` | `null` |
+| `routes[0].wikidata` | `null` |
+| `routes[0].between` | `null` |
+| `routes[1].name` | `R33 (southbound)` |
+| `routes[1].network` | `za:regional` |
+| `routes[1].ref` | `R33` |
+| `routes[1].symbol` | `null` |
+| `routes[1].wikidata` | `null` |
+| `routes[1].between` | `null` |
+| `speed_limits[0].max_speed.value` | `60` |
+| `speed_limits[0].max_speed.unit` | `km/h` |
+| `speed_limits[0].min_speed` | `null` |
+| `speed_limits[0].is_max_speed_variable` | `null` |
+| `speed_limits[0].between` | `null` |
+| `speed_limits[0].when.heading` | `forward` |
+| `speed_limits[0].when.during` | `null` |
+| `speed_limits[0].when.mode` | `null` |
+| `speed_limits[0].when.using` | `null` |
+| `speed_limits[0].when.recognized` | `null` |
+| `speed_limits[0].when.vehicle` | `null` |
+| `subclass` | `null` |
+| `subclass_rules` | `null` |
+| `width_rules` | `null` |
+| `class` | `primary` |
+| `rail_flags` | `null` |
+| `names.rules[0].value` | `Vermooten Street` |
+| `names.rules[0].variant` | `common` |
+| `names.rules[0].language` | `null` |
+| `names.rules[0].perspectives` | `null` |
+| `names.rules[0].between` | `null` |
+| `names.rules[0].side` | `null` |
+
+### Example 2
+
+| Column | Value |
+| -------: | ------- |
+| `id` | `2a9415ed-fa07-4734-9d8e-1d8ff69451c2` |
+| `bbox.xmin` | `30.98159` |
+| `bbox.ymin` | `-12.721077` |
+| `bbox.xmax` | `30.98444` |
+| `bbox.ymax` | `-12.718572` |
+| `geometry` | `LINESTRING (30.9844394 -12.7185733, 30.9818611 -12.7207838, 30.9815908 -12.7210751)` |
+| `theme` | `transportation` |
+| `type` | `segment` |
+| `version` | `1` |
+| `sources[0].property` |  |
+| `sources[0].dataset` | `OpenStreetMap` |
+| `sources[0].license` | `ODbL-1.0` |
+| `sources[0].record_id` | `w414442537@2` |
+| `sources[0].update_time` | `2026-02-05T14:25:06+00:00` |
+| `sources[0].confidence` | `null` |
+| `sources[0].provider` | `null` |
+| `sources[0].resource` | `null` |
+| `sources[0].version` | `null` |
+| `sources[0].between` | `null` |
+| `subtype` | `rail` |
+| `connectors[0].connector_id` | `2da12352-29c5-479e-932f-68fbe90c8229` |
+| `connectors[0].at` | `0.0` |
+| `connectors[1].connector_id` | `feed87bb-7abf-4254-9e14-efd6bdb3e428` |
+| `connectors[1].at` | `0.895049489` |
+| `connectors[2].connector_id` | `e37ca4ff-ab09-4c84-8d3c-450c703d7308` |
+| `connectors[2].at` | `1.0` |
+| `access_restrictions` | `null` |
+| `level_rules` | `null` |
+| `names` | `null` |
+| `destinations` | `null` |
+| `prohibited_transitions` | `null` |
+| `road_flags` | `null` |
+| `road_surface` | `null` |
+| `routes` | `null` |
+| `speed_limits` | `null` |
+| `subclass` | `null` |
+| `subclass_rules` | `null` |
+| `width_rules` | `null` |
+| `class` | `unknown` |
+| `rail_flags[0].values` | `["is_disused"]` |
+| `rail_flags[0].between` | `null` |
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/_category_.json
new file mode 100644
index 000000000..a3ec08974
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Types"
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/_category_.json b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/_category_.json
new file mode 100644
index 000000000..ecd5459ed
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/_category_.json
@@ -0,0 +1,3 @@
+{
+  "label": "Segment"
+}
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/access_rule.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/access_rule.md
new file mode 100644
index 000000000..fe925aa38
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/access_rule.md
@@ -0,0 +1,26 @@
+# AccessRule
+
+A single scoped rule about who or what can use a segment (or a sub-segment of a segment).
+
+This rule can be scoped to apply only to linearly-referenced subsegment, a travel mode such as
+motor vehicle, a heading such as forward or backward, and to various other scopes as well. See
+the fields for the full list of available scopes.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `access_type` | [`AccessType`](access_type.md) | |
+| `between` | [`LinearlyReferencedRange`](../../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing AccessRule applies to. |
+| `when` | [`AccessRule.When`](access_rule.when.md) (optional) | Scopes for AccessRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
+| `when.heading` | [`Heading`](../../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing AccessRule applies to. |
+| `when.during` | [`OpeningHours`](../../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing AccessRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
+| `when.mode` | `list<`[`TravelMode`](../../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing AccessRule applies to. |
+| `when.using` | `list<`[`PurposeOfUse`](../../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing AccessRule applies to. |
+| `when.recognized` | `list<`[`RecognizedStatus`](../../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing AccessRule applies to. |
+| `when.vehicle` | [`VehicleAxleCountSelector`](../../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing AccessRule applies to. |
+
+## Used By
+
+- [`Segment`](../../segment.md)
+- [`AccessRules`](access_rules.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/access_rule.when.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/access_rule.when.md
new file mode 100644
index 000000000..f03e779fc
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/access_rule.when.md
@@ -0,0 +1,22 @@
+# AccessRule.When
+
+Scopes for AccessRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `heading` | [`Heading`](../../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing AccessRule applies to.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `during` | [`OpeningHours`](../../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing AccessRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `mode` | `list<`[`TravelMode`](../../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing AccessRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `using` | `list<`[`PurposeOfUse`](../../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing AccessRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `recognized` | `list<`[`RecognizedStatus`](../../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing AccessRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `vehicle` | [`VehicleAxleCountSelector`](../../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing AccessRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+
+## Constraints
+
+- At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set
+
+## Used By
+
+- [`AccessRule`](access_rule.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/access_rules.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/access_rules.md
new file mode 100644
index 000000000..8f5b8e005
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/access_rules.md
@@ -0,0 +1,14 @@
+# AccessRules
+
+Rules governing access to this road segment
+
+Underlying type: `list<`[`AccessRule`](access_rule.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Segment`](../../segment.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/access_type.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/access_type.md
new file mode 100644
index 000000000..9b122d179
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/access_type.md
@@ -0,0 +1,13 @@
+# AccessType
+
+Whether access is allowed, denied, or allowed as designated.
+
+## Values
+
+- `allowed` - Access is permitted.
+- `denied` - Access is prohibited.
+- `designated` - Access is positively designated, typically by signage or regulation, for the relevant travel mode(s).
+
+## Used By
+
+- [`AccessRule`](access_rule.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/connector_reference.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/connector_reference.md
new file mode 100644
index 000000000..29957abc6
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/connector_reference.md
@@ -0,0 +1,15 @@
+# ConnectorReference
+
+Contains the GERS ID and relative position between 0 and 1 of a connector feature along the
+segment.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `connector_id` | [`Id`](../../../system/ref/id.md) | A unique identifier<br/><br/>*References [`Connector`](../../connector.md) (association, connects to)* |
+| `at` | [`LinearlyReferencedPosition`](../../../common/scoping/linearly_referenced_position.md) (optional) | The linearly-referenced position on the geometry, specified as a percentage displacement from the start of the geometry, that the containing ConnectorReference applies to. |
+
+## Used By
+
+- [`Segment`](../../segment.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_label_type.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_label_type.md
new file mode 100644
index 000000000..cf2ccb11f
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_label_type.md
@@ -0,0 +1,16 @@
+# DestinationLabelType
+
+Indicates what special symbol/icon is present on a signpost, visible as road marking or
+similar.
+
+## Values
+
+- `street`
+- `country`
+- `route_ref`
+- `toward_route_ref`
+- `unknown`
+
+## Used By
+
+- [`DestinationLabels`](destination_labels.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_labels.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_labels.md
new file mode 100644
index 000000000..67a087663
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_labels.md
@@ -0,0 +1,14 @@
+# DestinationLabels
+
+The type of object of the destination label.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`StrippedString`](../../../system/stripped_string.md) | Names the object that is reached<br/><br/>*Minimum length: 1* |
+| `type` | [`DestinationLabelType`](destination_label_type.md) | |
+
+## Used By
+
+- [`DestinationRule`](destination_rule.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_rule.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_rule.md
new file mode 100644
index 000000000..30ee56df8
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_rule.md
@@ -0,0 +1,32 @@
+# DestinationRule
+
+A single scoped rule describing the destinations reachable by following a transition from the
+current segment onto the segment `to_segment_id` via the connector `to_connector_id` in
+the `final_heading` direction.
+
+The destination is described as it appears in real-world signage through text `labels` and/or
+pictographic `symbols`. Heading-scoped to the approach direction on the current segment.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `from_connector_id` | [`Id`](../../../system/ref/id.md) | Identifies the point of physical connection on this segment before which the destination sign or marking is visible.<br/><br/>*References [`Connector`](../../connector.md) (association, signposted from)* |
+| `to_connector_id` | [`Id`](../../../system/ref/id.md) | Identifies the point of physical connection on the segment identified by 'to_segment_id' to transition to for reaching the destination(s).<br/><br/>*References [`Connector`](../../connector.md) (association, transitions through)* |
+| `to_segment_id` | [`Id`](../../../system/ref/id.md) | Identifies the segment to transition to reach the destination(s) labeled on the sign or marking.<br/><br/>*References `TransportationSegment` (association, transitions to)* |
+| `final_heading` | [`Heading`](../../../common/scoping/heading.md) | Direction of travel on the segment identified by 'to_segment_id' that leads to the destination. |
+| `labels[]` | `list<`[`DestinationLabels`](destination_labels.md)`>` (optional) | Labeled destinations that can be reached by following the segment.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `labels`, `symbols` must be set* |
+| `labels[].value` | [`StrippedString`](../../../system/stripped_string.md) | Names the object that is reached |
+| `labels[].type` | [`DestinationLabelType`](destination_label_type.md) | |
+| `symbols` | `list<`[`DestinationSignSymbol`](destination_sign_symbol.md)`>` (optional) | A collection of symbols or icons present on the sign next to current destination label.<br/><br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `labels`, `symbols` must be set* |
+| `when` | [`DestinationRule.When`](destination_rule.when.md) (optional) | Scope for DestinationRule: |
+| `when.heading` | [`Heading`](../../../common/scoping/heading.md) | The heading, either forward or backward, that the containing DestinationRule applies to. |
+
+## Constraints
+
+- At least one of `labels`, `symbols` must be set
+
+## Used By
+
+- [`Segment`](../../segment.md)
+- [`Destinations`](destinations.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_rule.when.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_rule.when.md
new file mode 100644
index 000000000..21b1a412d
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_rule.when.md
@@ -0,0 +1,13 @@
+# DestinationRule.When
+
+Scope for DestinationRule: 
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `heading` | [`Heading`](../../../common/scoping/heading.md) | The heading, either forward or backward, that the containing DestinationRule applies to. |
+
+## Used By
+
+- [`DestinationRule`](destination_rule.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_sign_symbol.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_sign_symbol.md
new file mode 100644
index 000000000..636ec2a7d
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destination_sign_symbol.md
@@ -0,0 +1,31 @@
+# DestinationSignSymbol
+
+Indicates what special symbol/icon is present on a signpost, visible as road marking or
+similar.
+
+## Values
+
+- `motorway`
+- `airport`
+- `hospital`
+- `center` - Center of a locality, city center or downtown, from centre in raw OSM value
+- `industrial`
+- `parking`
+- `bus`
+- `train_station`
+- `rest_area`
+- `ferry`
+- `motorroad`
+- `fuel`
+- `viewpoint`
+- `fuel_diesel`
+- `food` - 'food', 'restaurant' in OSM
+- `lodging`
+- `info`
+- `camp_site`
+- `interchange`
+- `restrooms` - 'toilets' in OSM
+
+## Used By
+
+- [`DestinationRule`](destination_rule.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destinations.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destinations.md
new file mode 100644
index 000000000..413a981a6
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/destinations.md
@@ -0,0 +1,13 @@
+# Destinations
+
+Describes objects that can be reached by following a transportation segment in the
+same way those objects are described on signposts or ground writing that a
+traveller following the segment would observe in the real world. This allows
+navigation systems to refer to signs and observable writing that a traveller
+actually sees.
+
+Underlying type: `list<`[`DestinationRule`](destination_rule.md)`>`
+
+## Used By
+
+- [`Segment`](../../segment.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/level_rule.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/level_rule.md
new file mode 100644
index 000000000..fcca6ef06
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/level_rule.md
@@ -0,0 +1,16 @@
+# LevelRule
+
+A single level rule defining the Z-order, i.e. stacking order, applicable within a given scope
+on the road segment.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`Level`](../../../common/level.md) | Z-order of the feature where 0 is visual level |
+| `between` | [`LinearlyReferencedRange`](../../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing LevelRule applies to. |
+
+## Used By
+
+- [`Segment`](../../segment.md)
+- [`LevelRules`](level_rules.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/level_rules.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/level_rules.md
new file mode 100644
index 000000000..b65b561f7
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/level_rules.md
@@ -0,0 +1,9 @@
+# LevelRules
+
+Defines the Z-order, i.e. stacking order, of the road segment.
+
+Underlying type: `list<`[`LevelRule`](level_rule.md)`>`
+
+## Used By
+
+- [`Segment`](../../segment.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/prohibited_transition_rule.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/prohibited_transition_rule.md
new file mode 100644
index 000000000..333c25dbb
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/prohibited_transition_rule.md
@@ -0,0 +1,36 @@
+# ProhibitedTransitionRule
+
+A single scoped rule identifying a transition from the current segment (or a sub-segment of it)
+to a connected segment that is not allowed.
+
+This rule can be scoped to apply only to linearly-referenced subsegment, a travel mode such as
+motor vehicle, a heading such as forward or backward, and to various other scopes as well. See
+the fields for the full list of available scopes.
+
+Terminology note: Prohibited transitions are more commonly referred to as turn restrictions.
+While the term turn restriction is simpler and more relatable, it is less precise because
+transitions between segments don't always require maneuvers that a human would describe as being
+a turn. For this reason, the Overture schema has opted for the more general and precise term
+prohibited transitions.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `sequence[]` | `list<`[`ProhibitedTransitionSequenceEntry`](prohibited_transition_sequence_entry.md)`>` | Ordered sequence of connector/segment pairs that it is prohibited to follow from this segment.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `sequence[].connector_id` | [`Id`](../../../system/ref/id.md) | Identifies the point of physical connection between the previous segment in the sequence and the segment in this sequence entry. |
+| `sequence[].segment_id` | [`Id`](../../../system/ref/id.md) | Identifies the segment that the previous segment in the sequence is physically connected to via the sequence entry's connector. |
+| `final_heading` | [`Heading`](../../../common/scoping/heading.md) | Direction of travel that is prohibited on the destination segment of the sequence. |
+| `between` | [`LinearlyReferencedRange`](../../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing ProhibitedTransitionRule applies to. |
+| `when` | [`ProhibitedTransitionRule.When`](prohibited_transition_rule.when.md) (optional) | Scopes for ProhibitedTransitionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
+| `when.heading` | [`Heading`](../../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing ProhibitedTransitionRule applies to. |
+| `when.during` | [`OpeningHours`](../../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing ProhibitedTransitionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
+| `when.mode` | `list<`[`TravelMode`](../../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing ProhibitedTransitionRule applies to. |
+| `when.using` | `list<`[`PurposeOfUse`](../../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing ProhibitedTransitionRule applies to. |
+| `when.recognized` | `list<`[`RecognizedStatus`](../../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing ProhibitedTransitionRule applies to. |
+| `when.vehicle` | [`VehicleAxleCountSelector`](../../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing ProhibitedTransitionRule applies to. |
+
+## Used By
+
+- [`Segment`](../../segment.md)
+- [`ProhibitedTransitions`](prohibited_transitions.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/prohibited_transition_rule.when.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/prohibited_transition_rule.when.md
new file mode 100644
index 000000000..c8c4e4f5e
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/prohibited_transition_rule.when.md
@@ -0,0 +1,22 @@
+# ProhibitedTransitionRule.When
+
+Scopes for ProhibitedTransitionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `heading` | [`Heading`](../../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing ProhibitedTransitionRule applies to.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `during` | [`OpeningHours`](../../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing ProhibitedTransitionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `mode` | `list<`[`TravelMode`](../../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing ProhibitedTransitionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `using` | `list<`[`PurposeOfUse`](../../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing ProhibitedTransitionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `recognized` | `list<`[`RecognizedStatus`](../../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing ProhibitedTransitionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `vehicle` | [`VehicleAxleCountSelector`](../../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing ProhibitedTransitionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+
+## Constraints
+
+- At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set
+
+## Used By
+
+- [`ProhibitedTransitionRule`](prohibited_transition_rule.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/prohibited_transition_sequence_entry.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/prohibited_transition_sequence_entry.md
new file mode 100644
index 000000000..7e49c542c
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/prohibited_transition_sequence_entry.md
@@ -0,0 +1,14 @@
+# ProhibitedTransitionSequenceEntry
+
+A segment/connector pair in a prohibited transition sequence.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `connector_id` | [`Id`](../../../system/ref/id.md) | Identifies the point of physical connection between the previous segment in the sequence and the segment in this sequence entry.<br/><br/>*References [`Connector`](../../connector.md) (association, transitions through)* |
+| `segment_id` | [`Id`](../../../system/ref/id.md) | Identifies the segment that the previous segment in the sequence is physically connected to via the sequence entry's connector.<br/><br/>*References `TransportationSegment` (association, transitions to)* |
+
+## Used By
+
+- [`ProhibitedTransitionRule`](prohibited_transition_rule.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/prohibited_transitions.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/prohibited_transitions.md
new file mode 100644
index 000000000..104fa9f83
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/prohibited_transitions.md
@@ -0,0 +1,9 @@
+# ProhibitedTransitions
+
+Rules preventing transitions from this segment to another segment.
+
+Underlying type: `list<`[`ProhibitedTransitionRule`](prohibited_transition_rule.md)`>`
+
+## Used By
+
+- [`Segment`](../../segment.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/rail_class.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/rail_class.md
new file mode 100644
index 000000000..8873d280f
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/rail_class.md
@@ -0,0 +1,18 @@
+# RailClass
+
+Captures the kind of rail segment.
+
+## Values
+
+- `funicular` - Inclined plane / cliff railway
+- `light_rail` - Higher-standard tram system, falls between 'tram' and 'rail'
+- `monorail`
+- `narrow_gauge`
+- `standard_gauge` - Standard-gauge rail, equivalent to OSM's railway=rail tag
+- `subway` - City passenger rail, often underground
+- `tram` - 1-2 carriage rail vehicle tracks, often sharing road with vehicles
+- `unknown`
+
+## Used By
+
+- [`Segment`](../../segment.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/rail_flag.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/rail_flag.md
new file mode 100644
index 000000000..dfddfdc52
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/rail_flag.md
@@ -0,0 +1,20 @@
+# RailFlag
+
+Simple flags that can be on or off for a railway segment.
+
+Specifies physical characteristics and can overlap.
+
+## Values
+
+- `is_bridge`
+- `is_tunnel` - Note: You may also be looking for the 'subway' class (though subways are occasionally above-ground)
+- `is_under_construction`
+- `is_abandoned`
+- `is_covered`
+- `is_passenger`
+- `is_freight`
+- `is_disused`
+
+## Used By
+
+- [`RailFlagRule`](rail_flag_rule.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/rail_flag_rule.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/rail_flag_rule.md
new file mode 100644
index 000000000..410c79df2
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/rail_flag_rule.md
@@ -0,0 +1,15 @@
+# RailFlagRule
+
+Rail-specific flag rule with geometric scoping only.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `values` | `list<`[`RailFlag`](rail_flag.md)`>` | *Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `between` | [`LinearlyReferencedRange`](../../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RailFlagRule applies to. |
+
+## Used By
+
+- [`Segment`](../../segment.md)
+- [`RailFlags`](rail_flags.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/rail_flags.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/rail_flags.md
new file mode 100644
index 000000000..1cfc33678
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/rail_flags.md
@@ -0,0 +1,15 @@
+# RailFlags
+
+Set of boolean attributes applicable to railways. May be specified either as a
+single flag array of flag values, or as an array of flag rules.
+
+Underlying type: `list<`[`RailFlagRule`](rail_flag_rule.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Segment`](../../segment.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_class.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_class.md
new file mode 100644
index 000000000..4144c4a9e
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_class.md
@@ -0,0 +1,27 @@
+# RoadClass
+
+Captures the kind of road and its position in the road network hierarchy.
+
+## Values
+
+- `motorway`
+- `primary`
+- `secondary`
+- `tertiary`
+- `residential`
+- `living_street` - Similar to residential but has implied legal restriction for motor vehicles (which can vary country by country)
+- `trunk`
+- `unclassified` - Known roads, paved, but subordinate to all of: motorway, trunk, primary, secondary, tertiary
+- `service` - Provides vehicle access to a feature (such as a building), typically not part of the public street network
+- `pedestrian`
+- `footway` - Minor segments mainly used by pedestrians
+- `steps`
+- `path`
+- `track`
+- `cycleway`
+- `bridleway` - Similar to track but has implied access only for horses
+- `unknown`
+
+## Used By
+
+- [`Segment`](../../segment.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_flag.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_flag.md
new file mode 100644
index 000000000..ac45f06a8
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_flag.md
@@ -0,0 +1,19 @@
+# RoadFlag
+
+Simple flags that can be on or off for a road segment.
+
+Specifies physical characteristics and can overlap.
+
+## Values
+
+- `is_bridge`
+- `is_link` - Deprecated: will be removed in a future release in favor of the `link` subclass
+- `is_tunnel`
+- `is_under_construction`
+- `is_abandoned`
+- `is_covered`
+- `is_indoor`
+
+## Used By
+
+- [`RoadFlagRule`](road_flag_rule.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_flag_rule.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_flag_rule.md
new file mode 100644
index 000000000..202a8431c
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_flag_rule.md
@@ -0,0 +1,15 @@
+# RoadFlagRule
+
+Road-specific flag rule with geometric scoping only.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `values` | `list<`[`RoadFlag`](road_flag.md)`>` | *Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
+| `between` | [`LinearlyReferencedRange`](../../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RoadFlagRule applies to. |
+
+## Used By
+
+- [`Segment`](../../segment.md)
+- [`RoadFlags`](road_flags.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_flags.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_flags.md
new file mode 100644
index 000000000..6bd6c28fe
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_flags.md
@@ -0,0 +1,15 @@
+# RoadFlags
+
+Set of boolean attributes applicable to roads. May be specified either as a
+single flag array of flag values, or as an array of flag rules.
+
+Underlying type: `list<`[`RoadFlagRule`](road_flag_rule.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Segment`](../../segment.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_subclass.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_subclass.md
new file mode 100644
index 000000000..1141642b6
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_subclass.md
@@ -0,0 +1,18 @@
+# RoadSubclass
+
+Refines expected usage of the segment, must not overlap.
+
+## Values
+
+- `link` - Connecting stretch (sliproad or ramp) between two road types
+- `sidewalk` - Footway that lies along a road
+- `crosswalk` - Footway that intersects other roads
+- `parking_aisle` - Service road intended for parking
+- `driveway` - Service road intended for deliveries
+- `alley` - Service road intended for rear entrances, fire exits
+- `cycle_crossing` - Cycleway that intersects with other roads
+
+## Used By
+
+- [`RoadSubclassRule`](road_subclass_rule.md)
+- [`Segment`](../../segment.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_subclass_rule.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_subclass_rule.md
new file mode 100644
index 000000000..adb0251db
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_subclass_rule.md
@@ -0,0 +1,15 @@
+# RoadSubclassRule
+
+Set of subclasses scoped along segment.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`RoadSubclass`](road_subclass.md) | |
+| `between` | [`LinearlyReferencedRange`](../../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RoadSubclassRule applies to. |
+
+## Used By
+
+- [`Segment`](../../segment.md)
+- [`RoadSubclassRules`](road_subclass_rules.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_subclass_rules.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_subclass_rules.md
new file mode 100644
index 000000000..d74b68973
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_subclass_rules.md
@@ -0,0 +1,9 @@
+# RoadSubclassRules
+
+Set of subclasses scoped along segment
+
+Underlying type: `list<`[`RoadSubclassRule`](road_subclass_rule.md)`>`
+
+## Used By
+
+- [`Segment`](../../segment.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_surface.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_surface.md
new file mode 100644
index 000000000..d1fd48221
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_surface.md
@@ -0,0 +1,17 @@
+# RoadSurface
+
+Physical surface of the road.
+
+## Values
+
+- `unknown`
+- `paved`
+- `unpaved`
+- `gravel`
+- `dirt`
+- `paving_stones`
+- `metal`
+
+## Used By
+
+- [`RoadSurfaceRule`](road_surface_rule.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_surface_rule.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_surface_rule.md
new file mode 100644
index 000000000..e595748da
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_surface_rule.md
@@ -0,0 +1,16 @@
+# RoadSurfaceRule
+
+Specifies the physical surface of a road segment or a linearly-referenced subsegment of the road
+segment.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`RoadSurface`](road_surface.md) | |
+| `between` | [`LinearlyReferencedRange`](../../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RoadSurfaceRule applies to. |
+
+## Used By
+
+- [`Segment`](../../segment.md)
+- [`RoadSurfaces`](road_surfaces.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_surfaces.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_surfaces.md
new file mode 100644
index 000000000..6cf660615
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/road_surfaces.md
@@ -0,0 +1,15 @@
+# RoadSurfaces
+
+Physical surface of the road. May either be specified as a single global value
+for the segment, or as an array of surface rules.
+
+Underlying type: `list<`[`RoadSurfaceRule`](road_surface_rule.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Segment`](../../segment.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/route_reference.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/route_reference.md
new file mode 100644
index 000000000..cf283bd36
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/route_reference.md
@@ -0,0 +1,19 @@
+# RouteReference
+
+Route reference with linear referencing support.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `name` | [`StrippedString`](../../../system/stripped_string.md) (optional) | Full name of the route<br/><br/>*Minimum length: 1* |
+| `network` | [`StrippedString`](../../../system/stripped_string.md) (optional) | Name of the highway system this route belongs to<br/><br/>*Minimum length: 1* |
+| `ref` | [`StrippedString`](../../../system/stripped_string.md) (optional) | Code or number used to reference the route<br/><br/>*Minimum length: 1* |
+| `symbol` | [`StrippedString`](../../../system/stripped_string.md) (optional) | URL or description of route signage<br/><br/>*Minimum length: 1* |
+| `wikidata` | [`WikidataId`](../../../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
+| `between` | [`LinearlyReferencedRange`](../../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RouteReference applies to. |
+
+## Used By
+
+- [`Segment`](../../segment.md)
+- [`Routes`](routes.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/routes.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/routes.md
new file mode 100644
index 000000000..817317b08
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/routes.md
@@ -0,0 +1,9 @@
+# Routes
+
+Routes this segment belongs to
+
+Underlying type: `list<`[`RouteReference`](route_reference.md)`>`
+
+## Used By
+
+- [`Segment`](../../segment.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/segment_subtype.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/segment_subtype.md
new file mode 100644
index 000000000..f74e6b21b
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/segment_subtype.md
@@ -0,0 +1,13 @@
+# SegmentSubtype
+
+Transportation segment subtype classification.
+
+## Values
+
+- `road` - A segment of the road network, travelled by motor vehicles, cyclists, pedestrians, etc.
+- `rail` - A segment of the railway network, travelled by trains, trams, and other rail vehicles.
+- `water` - A segment of the navigable water network, travelled by vessels such as ferries and boats.
+
+## Used By
+
+- [`Segment`](../../segment.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed.md
new file mode 100644
index 000000000..b633a7476
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed.md
@@ -0,0 +1,14 @@
+# Speed
+
+A speed value, i.e. a certain number of distance units travelled per unit time.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`SpeedValue`](speed_value.md) | Speed value |
+| `unit` | [`SpeedUnit`](../../../common/speed_unit.md) | |
+
+## Used By
+
+- [`SpeedLimitRule`](speed_limit_rule.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed_limit_rule.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed_limit_rule.md
new file mode 100644
index 000000000..a8d7974f6
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed_limit_rule.md
@@ -0,0 +1,32 @@
+# SpeedLimitRule
+
+An individual speed limit rule.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `max_speed` | [`Speed`](speed.md) (optional) | *At least one of `max_speed`, `min_speed` must be set* |
+| `max_speed.value` | [`SpeedValue`](speed_value.md) | Speed value |
+| `max_speed.unit` | [`SpeedUnit`](../../../common/speed_unit.md) | |
+| `min_speed` | [`Speed`](speed.md) (optional) | *At least one of `max_speed`, `min_speed` must be set* |
+| `min_speed.value` | [`SpeedValue`](speed_value.md) | Speed value |
+| `min_speed.unit` | [`SpeedUnit`](../../../common/speed_unit.md) | |
+| `is_max_speed_variable` | `boolean` (optional) | Indicates a variable speed corridor<br/><br/>*`strict=True`* |
+| `between` | [`LinearlyReferencedRange`](../../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SpeedLimitRule applies to. |
+| `when` | [`SpeedLimitRule.When`](speed_limit_rule.when.md) (optional) | Scopes for SpeedLimitRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
+| `when.heading` | [`Heading`](../../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing SpeedLimitRule applies to. |
+| `when.during` | [`OpeningHours`](../../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing SpeedLimitRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
+| `when.mode` | `list<`[`TravelMode`](../../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing SpeedLimitRule applies to. |
+| `when.using` | `list<`[`PurposeOfUse`](../../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing SpeedLimitRule applies to. |
+| `when.recognized` | `list<`[`RecognizedStatus`](../../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing SpeedLimitRule applies to. |
+| `when.vehicle` | [`VehicleAxleCountSelector`](../../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing SpeedLimitRule applies to. |
+
+## Constraints
+
+- At least one of `max_speed`, `min_speed` must be set
+
+## Used By
+
+- [`Segment`](../../segment.md)
+- [`SpeedLimits`](speed_limits.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed_limit_rule.when.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed_limit_rule.when.md
new file mode 100644
index 000000000..7152581bc
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed_limit_rule.when.md
@@ -0,0 +1,22 @@
+# SpeedLimitRule.When
+
+Scopes for SpeedLimitRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `heading` | [`Heading`](../../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing SpeedLimitRule applies to.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `during` | [`OpeningHours`](../../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing SpeedLimitRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `mode` | `list<`[`TravelMode`](../../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing SpeedLimitRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `using` | `list<`[`PurposeOfUse`](../../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing SpeedLimitRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `recognized` | `list<`[`RecognizedStatus`](../../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing SpeedLimitRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+| `vehicle` | [`VehicleAxleCountSelector`](../../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing SpeedLimitRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
+
+## Constraints
+
+- At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set
+
+## Used By
+
+- [`SpeedLimitRule`](speed_limit_rule.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed_limits.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed_limits.md
new file mode 100644
index 000000000..a2abce1a3
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed_limits.md
@@ -0,0 +1,14 @@
+# SpeedLimits
+
+Rules governing speed on this road segment
+
+Underlying type: `list<`[`SpeedLimitRule`](speed_limit_rule.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Segment`](../../segment.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed_value.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed_value.md
new file mode 100644
index 000000000..858eda95c
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/speed_value.md
@@ -0,0 +1,16 @@
+# SpeedValue
+
+Speed value
+
+Underlying type: `int32`
+
+## Constraints
+
+- `≥ 1`
+- `≤ 350`
+- `≥ -2147483648` (from [`int32`](../../../system/numeric.md))
+- `≤ 2147483647` (from [`int32`](../../../system/numeric.md))
+
+## Used By
+
+- [`Speed`](speed.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/width.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/width.md
new file mode 100644
index 000000000..c7e6d5ec4
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/width.md
@@ -0,0 +1,11 @@
+# Width
+
+Underlying type: `float64`
+
+## Constraints
+
+- `> 0`
+
+## Used By
+
+- [`WidthRule`](width_rule.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/width_rule.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/width_rule.md
new file mode 100644
index 000000000..afa4bdd9f
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/width_rule.md
@@ -0,0 +1,15 @@
+# WidthRule
+
+Specifies the width of a segment or a linearly-referenced subsegment of a segment.
+
+## Fields
+
+| Name | Type | Description |
+| -----: | :----: | ------------- |
+| `value` | [`Width`](width.md) | Edge-to-edge width of the feature modeled by this segment, in meters. |
+| `between` | [`LinearlyReferencedRange`](../../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing WidthRule applies to. |
+
+## Used By
+
+- [`Segment`](../../segment.md)
+- [`WidthRules`](width_rules.md)
diff --git a/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/width_rules.md b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/width_rules.md
new file mode 100644
index 000000000..4b4d4f7ea
--- /dev/null
+++ b/schema_versioned_docs/version-v2.0.0/reference/transportation/types/segment/width_rules.md
@@ -0,0 +1,20 @@
+# WidthRules
+
+Edge-to-edge width of the feature modeled by this segment, in meters.
+
+Examples: (1) If this segment models a carriageway without sidewalk, this value
+represents the edge-to-edge width of the carriageway, inclusive of any shoulder.
+(2) If this segment models a sidewalk by itself, this value represents the
+edge-to-edge width of the sidewalk. (3) If this segment models a combined sidewalk
+and carriageway, this value represents the edge-to-edge width inclusive of sidewalk.
+
+Underlying type: `list<`[`WidthRule`](width_rule.md)`>`
+
+## Constraints
+
+- Minimum length: 1
+- All items must be unique. (`UniqueItemsConstraint`)
+
+## Used By
+
+- [`Segment`](../../segment.md)
diff --git a/schema_versioned_sidebars/version-v1.17.0-sidebars.json b/schema_versioned_sidebars/version-v1.17.0-sidebars.json
new file mode 100644
index 000000000..4c080aea5
--- /dev/null
+++ b/schema_versioned_sidebars/version-v1.17.0-sidebars.json
@@ -0,0 +1,14 @@
+{
+  "schema": [
+    {
+      "type": "link",
+      "label": "← All docs",
+      "href": "/"
+    },
+    "index",
+    {
+      "type": "autogenerated",
+      "dirName": "reference"
+    }
+  ]
+}
diff --git a/schema_versioned_sidebars/version-v1.18.0-sidebars.json b/schema_versioned_sidebars/version-v1.18.0-sidebars.json
new file mode 100644
index 000000000..4c080aea5
--- /dev/null
+++ b/schema_versioned_sidebars/version-v1.18.0-sidebars.json
@@ -0,0 +1,14 @@
+{
+  "schema": [
+    {
+      "type": "link",
+      "label": "← All docs",
+      "href": "/"
+    },
+    "index",
+    {
+      "type": "autogenerated",
+      "dirName": "reference"
+    }
+  ]
+}
diff --git a/schema_versioned_sidebars/version-v2.0.0-sidebars.json b/schema_versioned_sidebars/version-v2.0.0-sidebars.json
new file mode 100644
index 000000000..4c080aea5
--- /dev/null
+++ b/schema_versioned_sidebars/version-v2.0.0-sidebars.json
@@ -0,0 +1,14 @@
+{
+  "schema": [
+    {
+      "type": "link",
+      "label": "← All docs",
+      "href": "/"
+    },
+    "index",
+    {
+      "type": "autogenerated",
+      "dirName": "reference"
+    }
+  ]
+}
diff --git a/schema_versions.json b/schema_versions.json
new file mode 100644
index 000000000..aacd3e59a
--- /dev/null
+++ b/schema_versions.json
@@ -0,0 +1,5 @@
+[
+  "v2.0.0",
+  "v1.18.0",
+  "v1.17.0"
+]
diff --git a/scripts/add-schema-version.mjs b/scripts/add-schema-version.mjs
new file mode 100644
index 000000000..1eeae4084
--- /dev/null
+++ b/scripts/add-schema-version.mjs
@@ -0,0 +1,91 @@
+// Snapshot the schema reference docs for a released OvertureMaps/schema tag
+// into a Docusaurus version of the `schema` docs instance.
+//
+//   npm run add-schema-version -- v2.0.0
+//
+// Steps: clone the schema repo at the tag, run its own overture-codegen (same
+// as the generate-schema-docs CI action) into schema/reference, then run
+// `docusaurus docs:version:schema <tag>`, which copies schema/ into
+// schema_versioned_docs/version-<tag>/, snapshots sidebars-schema.js, and
+// prepends the tag to schema_versions.json. Those three outputs are committed.
+// schema/reference is left clean afterwards (it is gitignored and
+// regenerated from `main` on every build). See README "Schema Reference".
+import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const SCHEMA_REPO = 'https://github.com/OvertureMaps/schema.git';
+const TAG_PATTERN = /^v\d+\.\d+\.\d+$/;
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..');
+const referenceDir = join(root, 'schema', 'reference');
+const versionsFile = join(root, 'schema_versions.json');
+const docusaurusBin = join(root, 'node_modules', '@docusaurus', 'core', 'bin', 'docusaurus.mjs');
+
+const semverParts = (v) => v.slice(1).split('.').map(Number);
+const compareSemverDesc = (a, b) => {
+  const [pa, pb] = [semverParts(a), semverParts(b)];
+  return pb[0] - pa[0] || pb[1] - pa[1] || pb[2] - pa[2];
+};
+
+const tag = process.argv[2];
+if (!tag || !TAG_PATTERN.test(tag)) {
+  console.error(`Usage: npm run add-schema-version -- vX.Y.Z\n\nGot: ${tag ?? '<missing>'}`);
+  process.exit(2);
+}
+
+const existing = JSON.parse(readFileSync(versionsFile, 'utf8'));
+if (existing.includes(tag)) {
+  console.error(`${tag} is already in schema_versions.json; nothing to do.`);
+  process.exit(1);
+}
+
+// Codegen needs UTF-8 stdio on Windows; mirrors the CI action's env.
+const env = { ...process.env, PYTHONUTF8: '1', PYTHONIOENCODING: 'utf-8' };
+const run = (cmd, args, cwd) => execFileSync(cmd, args, { cwd, env, stdio: 'inherit' });
+
+const workDir = mkdtempSync(join(tmpdir(), 'overture-schema-'));
+const schemaDir = join(workDir, 'schema');
+
+try {
+  console.log(`\n▶ Cloning OvertureMaps/schema@${tag}`);
+  run('git', ['clone', '--quiet', '--depth', '1', '--branch', tag, SCHEMA_REPO, schemaDir]);
+
+  console.log('\n▶ Installing schema packages (uv sync)');
+  run(
+    'uv',
+    ['sync', '--package', 'overture-schema', '--package', 'overture-schema-codegen', '--no-dev'],
+    schemaDir,
+  );
+
+  console.log(`\n▶ Generating markdown into ${referenceDir}`);
+  rmSync(referenceDir, { recursive: true, force: true });
+  run(
+    'uv',
+    ['run', 'overture-codegen', 'generate', '--format', 'markdown', '--output-dir', referenceDir],
+    schemaDir,
+  );
+  if (!existsSync(referenceDir)) {
+    throw new Error('codegen produced no output');
+  }
+
+  console.log(`\n▶ Snapshotting Docusaurus version ${tag}`);
+  run(process.execPath, [docusaurusBin, 'docs:version:schema', tag], root);
+
+  // docs:version prepends; keep the dropdown ordered newest-first regardless
+  // of the order tags are added in.
+  const versions = JSON.parse(readFileSync(versionsFile, 'utf8')).sort(compareSemverDesc);
+  writeFileSync(versionsFile, `${JSON.stringify(versions, null, 2)}\n`);
+
+  console.log(`
+✔ Added schema docs version ${tag}. Review and commit:
+    schema_versions.json
+    schema_versioned_docs/version-${tag}/
+    schema_versioned_sidebars/version-${tag}-sidebars.json
+`);
+} finally {
+  rmSync(referenceDir, { recursive: true, force: true });
+  rmSync(workDir, { recursive: true, force: true });
+}
diff --git a/sidebars-schema.js b/sidebars-schema.js
new file mode 100644
index 000000000..fa5d199fc
--- /dev/null
+++ b/sidebars-schema.js
@@ -0,0 +1,14 @@
+/**
+ * Sidebar for the versioned `schema` docs instance (docs/schema and
+ * schema_versioned_docs/). Snapshotted per version by docs:version:schema.
+ *
+ * @type {import('@docusaurus/plugin-content-docs').SidebarsConfig}
+ */
+const sidebars = {
+  schema: [
+    { type: 'link', label: '← All docs', href: '/' },
+    'index', // Ensure the overview is first
+    { type: 'autogenerated', dirName: 'reference' },
+  ],
+};
+module.exports = sidebars;
diff --git a/sidebars.js b/sidebars.js
index 2029d22d4..c0b2c0338 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -22,13 +22,10 @@ const sidebars = {
       ],
     },
     {
-      type: 'category',
+      // Schema reference is a separate, versioned docs instance; see sidebars-schema.js
+      type: 'link',
       label: 'Schema Reference',
-      collapsed: true,
-      items: [
-        'schema/index', // Ensure index is first
-        { type: 'autogenerated', dirName: 'schema/reference' },
-      ],
+      href: '/schema/',
     },
     {
       type: 'category',
diff --git a/src/css/custom.css b/src/css/custom.css
index 57f06bc0c..3c8270d42 100644
--- a/src/css/custom.css
+++ b/src/css/custom.css
@@ -348,6 +348,14 @@ article li a {
     0 0 / contain;
 }
 
+/* ── Schema version dropdown ──
+ * The navbar is global; only show the schema version switcher while browsing
+ * the `schema` docs instance (Docusaurus sets plugin-id-<id> on <html>). */
+
+html:not(.plugin-id-schema) .schema-version-dropdown {
+  display: none;
+}
+
 /* ── Schema smart tables ── */
 
 /* Smart table container */

From 2d3a66469e7f6a39f78cd36cdb627b553b8f1628 Mon Sep 17 00:00:00 2001
From: John McCall <john@overturemaps.org>
Date: Tue, 15 Sep 2026 15:45:44 -0400
Subject: [PATCH 2/3] Pin schema repo links in versioned snapshots to their tag

Docstrings link into OvertureMaps/schema at main; those paths drift after
release. add-schema-version now rewrites blob/main and tree/main links to
the snapshotted tag, applied to the existing v1.17.0 and v1.18.0 snapshots.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Signed-off-by: John McCall <john@overturemaps.org>
---
 .../reference/places/types/categories.md      |  2 +-
 .../reference/places/types/categories.md      |  2 +-
 scripts/add-schema-version.mjs                | 24 ++++++++++++++++++-
 3 files changed, 25 insertions(+), 3 deletions(-)

diff --git a/schema_versioned_docs/version-v1.17.0/reference/places/types/categories.md b/schema_versioned_docs/version-v1.17.0/reference/places/types/categories.md
index fbb5a64d2..1dcce4d93 100644
--- a/schema_versioned_docs/version-v1.17.0/reference/places/types/categories.md
+++ b/schema_versioned_docs/version-v1.17.0/reference/places/types/categories.md
@@ -2,7 +2,7 @@
 
 Categories a place belongs to.
 
-Complete list is available on GitHub: [https://github.com/OvertureMaps/schema/blob/main/docs/schema/concepts/by-theme/places/overture_categories.csv](https://github.com/OvertureMaps/schema/blob/main/docs/schema/concepts/by-theme/places/overture_categories.csv)
+Complete list is available on GitHub: [https://github.com/OvertureMaps/schema/blob/v1.17.0/docs/schema/concepts/by-theme/places/overture_categories.csv](https://github.com/OvertureMaps/schema/blob/v1.17.0/docs/schema/concepts/by-theme/places/overture_categories.csv)
 
 ## Fields
 
diff --git a/schema_versioned_docs/version-v1.18.0/reference/places/types/categories.md b/schema_versioned_docs/version-v1.18.0/reference/places/types/categories.md
index fbb5a64d2..1812c20aa 100644
--- a/schema_versioned_docs/version-v1.18.0/reference/places/types/categories.md
+++ b/schema_versioned_docs/version-v1.18.0/reference/places/types/categories.md
@@ -2,7 +2,7 @@
 
 Categories a place belongs to.
 
-Complete list is available on GitHub: [https://github.com/OvertureMaps/schema/blob/main/docs/schema/concepts/by-theme/places/overture_categories.csv](https://github.com/OvertureMaps/schema/blob/main/docs/schema/concepts/by-theme/places/overture_categories.csv)
+Complete list is available on GitHub: [https://github.com/OvertureMaps/schema/blob/v1.18.0/docs/schema/concepts/by-theme/places/overture_categories.csv](https://github.com/OvertureMaps/schema/blob/v1.18.0/docs/schema/concepts/by-theme/places/overture_categories.csv)
 
 ## Fields
 
diff --git a/scripts/add-schema-version.mjs b/scripts/add-schema-version.mjs
index 1eeae4084..35613eb5b 100644
--- a/scripts/add-schema-version.mjs
+++ b/scripts/add-schema-version.mjs
@@ -10,7 +10,7 @@
 // prepends the tag to schema_versions.json. Those three outputs are committed.
 // schema/reference is left clean afterwards (it is gitignored and
 // regenerated from `main` on every build). See README "Schema Reference".
-import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { dirname, join } from 'node:path';
 import { execFileSync } from 'node:child_process';
@@ -18,6 +18,9 @@ import { fileURLToPath } from 'node:url';
 
 const SCHEMA_REPO = 'https://github.com/OvertureMaps/schema.git';
 const TAG_PATTERN = /^v\d+\.\d+\.\d+$/;
+// Docstrings link into the schema repo at `main`; those paths drift after
+// release, so a snapshot pins them to its own tag.
+const SCHEMA_MAIN_LINK = /(github\.com\/OvertureMaps\/schema\/(?:blob|tree)\/)main\//g;
 
 const root = join(dirname(fileURLToPath(import.meta.url)), '..');
 const referenceDir = join(root, 'schema', 'reference');
@@ -30,6 +33,21 @@ const compareSemverDesc = (a, b) => {
   return pb[0] - pa[0] || pb[1] - pa[1] || pb[2] - pa[2];
 };
 
+function pinSchemaLinks(dir, ref) {
+  let count = 0;
+  for (const entry of readdirSync(dir, { withFileTypes: true, recursive: true })) {
+    if (!entry.isFile() || !entry.name.endsWith('.md')) continue;
+    const file = join(entry.parentPath, entry.name);
+    const src = readFileSync(file, 'utf8');
+    const out = src.replace(SCHEMA_MAIN_LINK, `$1${ref}/`);
+    if (out !== src) {
+      writeFileSync(file, out);
+      count++;
+    }
+  }
+  return count;
+}
+
 const tag = process.argv[2];
 if (!tag || !TAG_PATTERN.test(tag)) {
   console.error(`Usage: npm run add-schema-version -- vX.Y.Z\n\nGot: ${tag ?? '<missing>'}`);
@@ -74,6 +92,10 @@ try {
   console.log(`\n▶ Snapshotting Docusaurus version ${tag}`);
   run(process.execPath, [docusaurusBin, 'docs:version:schema', tag], root);
 
+  const versionDir = join(root, 'schema_versioned_docs', `version-${tag}`);
+  const pinned = pinSchemaLinks(versionDir, tag);
+  if (pinned) console.log(`  pinned schema repo links to ${tag} in ${pinned} file(s)`);
+
   // docs:version prepends; keep the dropdown ordered newest-first regardless
   // of the order tags are added in.
   const versions = JSON.parse(readFileSync(versionsFile, 'utf8')).sort(compareSemverDesc);

From f2f6f67fff74b29ae64f99d707d2680f59a4dac2 Mon Sep 17 00:00:00 2001
From: John McCall <john@overturemaps.org>
Date: Thu, 17 Sep 2026 12:33:49 -0400
Subject: [PATCH 3/3] Publish released schema tags only; drop rolling latest

/schema/ now serves the newest snapshot (v2.0.0) and the dropdown lists
released tags only. Builds no longer call the schema generator; the
current version is built solely for schema PR previews (SCHEMA_PREVIEW).
Initial set trimmed to v2.0.0 and v1.18.0.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Signed-off-by: John McCall <john@overturemaps.org>
---
 .github/workflows/ci.yml                      |   6 -
 .../production_deploy_documentation.yml       |  14 +-
 .github/workflows/staging_deploy.yaml         |  17 --
 .gitignore                                    |   4 +-
 README.md                                     |  23 +--
 docusaurus.config.js                          |  58 +++---
 .../version-v1.17.0/index.md                  |  58 ------
 .../reference/addresses/_category_.json       |   4 -
 .../reference/addresses/address.md            |  76 --------
 .../reference/addresses/types/_category_.json |   3 -
 .../addresses/types/address_level.md          |  26 ---
 .../reference/base/_category_.json            |   4 -
 .../reference/base/bathymetry.md              |  59 ------
 .../reference/base/infrastructure.md          |  77 --------
 .../version-v1.17.0/reference/base/land.md    |  87 ---------
 .../reference/base/land_cover.md              |  66 -------
 .../reference/base/land_use.md                |  82 --------
 .../reference/base/types/_category_.json      |   3 -
 .../reference/base/types/depth.md             |  15 --
 .../reference/base/types/elevation.md         |  16 --
 .../reference/base/types/height.md            |  13 --
 .../base/types/infrastructure_class.md        | 176 ------------------
 .../base/types/infrastructure_subtype.md      |  30 ---
 .../reference/base/types/land_class.md        |  54 ------
 .../base/types/land_cover_subtype.md          |  20 --
 .../reference/base/types/land_subtype.md      |  25 ---
 .../reference/base/types/land_use_class.md    | 121 ------------
 .../reference/base/types/land_use_subtype.md  |  36 ----
 .../reference/base/types/source_tags.md       |  15 --
 .../reference/base/types/surface_material.md  |  36 ----
 .../reference/base/types/water_class.md       |  47 -----
 .../reference/base/types/water_subtype.md     |  24 ---
 .../version-v1.17.0/reference/base/water.md   |  98 ----------
 .../reference/buildings/_category_.json       |   4 -
 .../reference/buildings/building.md           | 102 ----------
 .../reference/buildings/building_part.md      | 101 ----------
 .../reference/buildings/types/_category_.json |   3 -
 .../buildings/types/building_class.md         |  99 ----------
 .../buildings/types/building_subtype.md       |  25 ---
 .../buildings/types/facade_material.md        |  22 ---
 .../buildings/types/roof_material.md          |  25 ---
 .../buildings/types/roof_orientation.md       |  16 --
 .../reference/buildings/types/roof_shape.md   |  25 ---
 .../reference/common/_category_.json          |   4 -
 .../reference/common/cartographic_hints.md    |  18 --
 .../reference/common/common_names.md          |  10 -
 .../reference/common/confidence_score.md      |  15 --
 .../reference/common/feature_version.md       |  27 ---
 .../reference/common/length_unit.md           |  19 --
 .../version-v1.17.0/reference/common/level.md |  20 --
 .../reference/common/max_zoom.md              |  23 ---
 .../reference/common/min_zoom.md              |  23 ---
 .../reference/common/name_rule.md             |  32 ----
 .../reference/common/name_variant.md          |  22 ---
 .../version-v1.17.0/reference/common/names.md |  33 ----
 .../reference/common/perspective_mode.md      |  12 --
 .../reference/common/perspectives.md          |  16 --
 .../reference/common/prominence.md            |  23 ---
 .../reference/common/scoping/_category_.json  |   3 -
 .../reference/common/scoping/heading.md       |  17 --
 .../scoping/linearly_referenced_position.md   |  15 --
 .../scoping/linearly_referenced_range.md      |  26 ---
 .../reference/common/scoping/opening_hours.md |  12 --
 .../common/scoping/purpose_of_use.md          |  18 --
 .../common/scoping/recognized_status.md       |  18 --
 .../reference/common/scoping/side.md          |  15 --
 .../reference/common/scoping/travel_mode.md   |  25 ---
 .../scoping/vehicle_axle_count_selector.md    |  17 --
 .../common/scoping/vehicle_height_selector.md |  18 --
 .../common/scoping/vehicle_length_selector.md |  18 --
 .../common/scoping/vehicle_relation.md        |  19 --
 .../common/scoping/vehicle_weight_selector.md |  18 --
 .../common/scoping/vehicle_width_selector.md  |  18 --
 .../reference/common/sort_key.md              |  17 --
 .../reference/common/source_item.md           |  34 ----
 .../reference/common/sources.md               |  28 ---
 .../reference/common/speed_unit.md            |  12 --
 .../reference/common/weight_unit.md           |  17 --
 .../reference/divisions/_category_.json       |   4 -
 .../reference/divisions/division.md           | 132 -------------
 .../reference/divisions/division_area.md      |  88 ---------
 .../reference/divisions/division_boundary.md  |  85 ---------
 .../reference/divisions/types/_category_.json |   3 -
 .../reference/divisions/types/admin_level.md  |  19 --
 .../reference/divisions/types/area_class.md   |  15 --
 .../divisions/types/boundary_class.md         |  13 --
 .../types/capital_of_division_item.md         |  14 --
 .../divisions/types/division_class.md         |  20 --
 .../divisions/types/division_subtype.md       |  35 ----
 .../reference/divisions/types/hierarchy.md    |  21 ---
 .../divisions/types/hierarchy_item.md         |  16 --
 .../reference/divisions/types/norms.md        |  13 --
 .../reference/places/_category_.json          |   4 -
 .../version-v1.17.0/reference/places/place.md | 115 ------------
 .../reference/places/types/_category_.json    |   3 -
 .../reference/places/types/address.md         |  17 --
 .../reference/places/types/brand.md           |  27 ---
 .../reference/places/types/categories.md      |  16 --
 .../places/types/operating_status.md          |  19 --
 .../reference/places/types/taxonomy.md        |  17 --
 .../reference/pydantic/_category_.json        |   4 -
 .../pydantic/networks/_category_.json         |   3 -
 .../reference/pydantic/networks/email_str.md  |   7 -
 .../reference/pydantic/networks/http_url.md   |   9 -
 .../reference/system/_category_.json          |   4 -
 .../reference/system/country_code_alpha2.md   |  18 --
 .../reference/system/hex_color.md             |  20 --
 .../reference/system/json_pointer.md          |  23 ---
 .../reference/system/language_tag.md          |  27 ---
 .../reference/system/no_whitespace_string.md  |  13 --
 .../reference/system/phone_number.md          |  13 --
 .../system/primitive/_category_.json          |   3 -
 .../reference/system/primitive/geometry.md    |  11 --
 .../reference/system/primitive/primitives.md  |  27 ---
 .../reference/system/ref/_category_.json      |   3 -
 .../reference/system/ref/id.md                |  33 ----
 .../reference/system/region_code.md           |  16 --
 .../reference/system/snake_case_string.md     |  15 --
 .../reference/system/stripped_string.md       |  22 ---
 .../reference/system/wikidata_id.md           |  23 ---
 .../reference/transportation/_category_.json  |   4 -
 .../reference/transportation/connector.md     |  49 -----
 .../reference/transportation/segment.md       | 168 -----------------
 .../transportation/types/_category_.json      |   3 -
 .../types/access_restriction_rule.md          |  20 --
 .../types/access_restriction_rule.when.md     |  22 ---
 .../transportation/types/access_rules.md      |  14 --
 .../transportation/types/access_type.md       |  11 --
 .../types/connector_reference.md              |  15 --
 .../types/destination_label_type.md           |  16 --
 .../types/destination_labels.md               |  14 --
 .../transportation/types/destination_rule.md  |  25 ---
 .../types/destination_rule.when.md            |  13 --
 .../types/destination_sign_symbol.md          |  31 ---
 .../transportation/types/destinations.md      |   9 -
 .../transportation/types/level_rule.md        |  16 --
 .../transportation/types/level_rules.md       |   9 -
 .../types/prohibited_transition_rule.md       |  23 ---
 .../types/prohibited_transition_rule.when.md  |  22 ---
 .../types/prohibited_transitions.md           |   9 -
 .../transportation/types/rail_class.md        |  18 --
 .../transportation/types/rail_flag.md         |  20 --
 .../transportation/types/rail_flag_rule.md    |  15 --
 .../transportation/types/rail_flags.md        |  14 --
 .../transportation/types/road_class.md        |  27 ---
 .../transportation/types/road_flag.md         |  19 --
 .../transportation/types/road_flag_rule.md    |  15 --
 .../transportation/types/road_flags.md        |  14 --
 .../transportation/types/road_surface.md      |  17 --
 .../transportation/types/route_reference.md   |  19 --
 .../reference/transportation/types/routes.md  |   9 -
 .../transportation/types/sequence_entry.md    |  14 --
 .../reference/transportation/types/speed.md   |  14 --
 .../transportation/types/speed_limit_rule.md  |  32 ----
 .../types/speed_limit_rule.when.md            |  22 ---
 .../transportation/types/speed_limits.md      |  14 --
 .../transportation/types/speed_value.md       |  16 --
 .../transportation/types/subclass.md          |  18 --
 .../transportation/types/subclass_rule.md     |  15 --
 .../transportation/types/subclass_rules.md    |   9 -
 .../reference/transportation/types/subtype.md |  13 --
 .../transportation/types/surface_rule.md      |  13 --
 .../transportation/types/surfaces.md          |  14 --
 .../reference/transportation/types/width.md   |  11 --
 .../transportation/types/width_rule.md        |  13 --
 .../transportation/types/width_rules.md       |  16 --
 .../version-v1.17.0-sidebars.json             |  14 --
 schema_versions.json                          |   3 +-
 scripts/add-schema-version.mjs                |   6 +-
 169 files changed, 54 insertions(+), 4350 deletions(-)
 delete mode 100644 schema_versioned_docs/version-v1.17.0/index.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/addresses/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/addresses/address.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/addresses/types/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/addresses/types/address_level.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/bathymetry.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/infrastructure.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/land.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/land_cover.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/land_use.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/depth.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/elevation.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/height.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/infrastructure_class.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/infrastructure_subtype.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/land_class.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/land_cover_subtype.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/land_subtype.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/land_use_class.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/land_use_subtype.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/source_tags.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/surface_material.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/water_class.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/types/water_subtype.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/base/water.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/building.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/building_part.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/types/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/types/building_class.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/types/building_subtype.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/types/facade_material.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_material.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_orientation.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_shape.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/cartographic_hints.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/common_names.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/confidence_score.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/feature_version.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/length_unit.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/level.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/max_zoom.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/min_zoom.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/name_rule.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/name_variant.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/names.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/perspective_mode.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/perspectives.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/prominence.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/heading.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/linearly_referenced_position.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/linearly_referenced_range.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/opening_hours.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/purpose_of_use.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/recognized_status.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/side.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/travel_mode.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_axle_count_selector.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_height_selector.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_length_selector.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_relation.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_weight_selector.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_width_selector.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/sort_key.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/source_item.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/sources.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/speed_unit.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/common/weight_unit.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/division.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/division_area.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/division_boundary.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/admin_level.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/area_class.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/boundary_class.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/capital_of_division_item.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/division_class.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/division_subtype.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/hierarchy.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/hierarchy_item.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/divisions/types/norms.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/places/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/places/place.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/places/types/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/places/types/address.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/places/types/brand.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/places/types/categories.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/places/types/operating_status.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/places/types/taxonomy.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/pydantic/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/email_str.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/http_url.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/country_code_alpha2.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/hex_color.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/json_pointer.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/language_tag.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/no_whitespace_string.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/phone_number.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/primitive/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/primitive/geometry.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/primitive/primitives.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/ref/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/ref/id.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/region_code.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/snake_case_string.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/stripped_string.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/system/wikidata_id.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/connector.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/segment.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/_category_.json
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_restriction_rule.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_restriction_rule.when.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_rules.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_type.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/connector_reference.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_label_type.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_labels.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_rule.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_rule.when.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_sign_symbol.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/destinations.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/level_rule.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/level_rules.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transition_rule.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transition_rule.when.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transitions.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_class.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flag.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flag_rule.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flags.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_class.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flag.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flag_rule.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flags.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_surface.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/route_reference.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/routes.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/sequence_entry.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limit_rule.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limit_rule.when.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limits.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_value.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass_rule.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass_rules.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/subtype.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/surface_rule.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/surfaces.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/width.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/width_rule.md
 delete mode 100644 schema_versioned_docs/version-v1.17.0/reference/transportation/types/width_rules.md
 delete mode 100644 schema_versioned_sidebars/version-v1.17.0-sidebars.json

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index e6945f1e4..d3124fd45 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -56,12 +56,6 @@ jobs:
       - name: Install NPM dependencies
         run: npm ci
 
-      - name: Generate schema markdown docs
-        uses: OvertureMaps/workflows/.github/actions/generate-schema-docs@faa3fa4bbe01d85dc2e2139ff1f74ce70feb7df9 # zizmor: ignore[stale-action-refs] - main
-        with:
-          output-dir: ${{ github.workspace }}/schema/reference
-          schema-ref: 'main'
-
       - name: Build
         run: npm run build
 
diff --git a/.github/workflows/production_deploy_documentation.yml b/.github/workflows/production_deploy_documentation.yml
index 47156096b..e3eb06005 100644
--- a/.github/workflows/production_deploy_documentation.yml
+++ b/.github/workflows/production_deploy_documentation.yml
@@ -6,14 +6,8 @@ on:
   push:
     branches: [main]
 
-  # Allow running from the actions tab, and lets the schema repo trigger a
-  # rebuild against a specific released schema version/tag.
+  # Allow running from the actions tab.
   workflow_dispatch:
-    inputs:
-      schema-ref:
-        description: 'Schema repo ref (branch, tag, or SHA) to generate reference docs from.'
-        type: string
-        required: true
 
 concurrency:
   group: pages
@@ -45,12 +39,6 @@ jobs:
       - name: Install NPM dependencies
         run: npm ci --prefer-dedupe
 
-      - name: Generate schema markdown docs
-        uses: OvertureMaps/workflows/.github/actions/generate-schema-docs@faa3fa4bbe01d85dc2e2139ff1f74ce70feb7df9 # zizmor: ignore[stale-action-refs] - main
-        with:
-          output-dir: ${{ github.workspace }}/schema/reference
-          schema-ref: ${{ inputs['schema-ref'] || 'main' }}
-
       - name: Build Docusaurus Pages 🔧
         run: npm run build
 
diff --git a/.github/workflows/staging_deploy.yaml b/.github/workflows/staging_deploy.yaml
index b6598c276..09ba9f605 100644
--- a/.github/workflows/staging_deploy.yaml
+++ b/.github/workflows/staging_deploy.yaml
@@ -37,9 +37,6 @@ jobs:
     if: github.event.pull_request.head.repo.full_name == github.repository
     runs-on: ubuntu-latest
     needs: check-fork
-    outputs:
-      schema-sha: ${{ steps.schema-docs.outputs.schema-sha }}
-      schema-ref: ${{ steps.schema-docs.outputs.schema-ref }}
     steps:
       - name: Check out the main docs repo repository and build.
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
@@ -55,13 +52,6 @@ jobs:
 
       - run: npm ci --omit=dev
 
-      - name: Generate schema markdown docs
-        id: schema-docs
-        uses: OvertureMaps/workflows/.github/actions/generate-schema-docs@faa3fa4bbe01d85dc2e2139ff1f74ce70feb7df9 # zizmor: ignore[stale-action-refs] - main
-        with:
-          output-dir: ${{ github.workspace }}/schema/reference
-          schema-ref: 'main'
-
       - name: Build Docusaurus website
         run: npm run build
         env:
@@ -112,13 +102,7 @@ jobs:
         run: |
           echo "time=$(date -u +'%b %d, %Y %H:%M UTC')" >> $GITHUB_OUTPUT
           echo "short-sha=${PR_HEAD_SHA:0:7}" >> $GITHUB_OUTPUT
-          schema_ref="${NEEDS_BUILD_OUTPUTS_SCHEMA_REF#refs/heads/}"
-          schema_ref="${schema_ref#refs/tags/}"
-          echo "schema-ref-short=$schema_ref" >> $GITHUB_OUTPUT
-          echo "schema-short-sha=${NEEDS_BUILD_OUTPUTS_SCHEMA_SHA:0:7}" >> $GITHUB_OUTPUT
         env:
-          NEEDS_BUILD_OUTPUTS_SCHEMA_REF: ${{ needs.build.outputs.schema-ref }}
-          NEEDS_BUILD_OUTPUTS_SCHEMA_SHA: ${{ needs.build.outputs.schema-sha }}
           PR_HEAD_SHA: ${{ github.event.pull_request.head.sha }}
 
       - name: Comment on PR
@@ -130,7 +114,6 @@ jobs:
             |                         |                                                                      |
             |-------------------------|----------------------------------------------------------------------|
             | 🌍 **Preview site**     | ${{ env.STAGING_URL }}${{ env.PREVIEW_PATH }}/index.html            |
-            | 🗂️ **Schema ref**      | [${{ steps.deploy-metadata.outputs.schema-ref-short }}@${{ steps.deploy-metadata.outputs.schema-short-sha }}](https://github.com/OvertureMaps/schema/tree/${{ needs.build.outputs.schema-ref }}) |
             | 🕐 **Updated**          | ${{ steps.deploy-metadata.outputs.time }}                            |
             | 📝 **Commit**           | [${{ steps.deploy-metadata.outputs.short-sha }}](${{ github.server_url }}/${{ github.repository }}/commit/${{ github.event.pull_request.head.sha }}) |
 
diff --git a/.gitignore b/.gitignore
index a67feca7f..c6fcfab79 100644
--- a/.gitignore
+++ b/.gitignore
@@ -4,6 +4,6 @@ node_modules/
 build/
 static/maplibre/
 
-# Schema reference docs are generated at build time by the
-# generate-schema-docs action; see schema/index.md and README.
+# Scratch output of the schema doc generator: written by add-schema-version and
+# by the schema repo's PR preview workflow (SCHEMA_PREVIEW=true). See README.
 schema/reference/
diff --git a/README.md b/README.md
index 339f05c3c..dc7740cc8 100644
--- a/README.md
+++ b/README.md
@@ -17,23 +17,20 @@ This repository uses [Docusaurus](https://docusaurus.io/) to publish the documen
   - `community-projects.json` - source data for all community project cards
   - `og-image-cache.json` - cached `og:image` URLs for entries without an explicit `image` field (see [OG Image Cache](#og-image-cache) below)
 - `docs/`: The main documentation pages available at docs.overturemaps.org/. The sidebar for these pages is manually curated in the `sidebars.js` file.
-- `schema/`: The schema reference overview page and the build-time output of the schema doc generator. See below.
+- `schema/`: Source for the schema reference overview page (`index.md`) and scratch output of the schema doc generator. See below.
 - `schema_versioned_docs/`, `schema_versioned_sidebars/`, `schema_versions.json`: committed snapshots of the schema reference for each released schema tag. See below.
 
 ## Schema Reference (`docs.overturemaps.org/schema`)
 
-The Overture schema repository [OvertureMaps/schema](https://github.com/OvertureMaps/schema) maintains the official Overture schema as Pydantic models, and the reference pages under `docs.overturemaps.org/schema` are generated directly from those models. This keeps the schema and its documentation permanently in sync.
+The Overture schema repository [OvertureMaps/schema](https://github.com/OvertureMaps/schema) maintains the official Overture schema as Pydantic models, and the reference pages under `docs.overturemaps.org/schema` are generated directly from those models.
 
-The schema reference is its own [versioned Docusaurus docs instance](https://docusaurus.io/docs/versioning) (plugin id `schema`, config in `docusaurus.config.js`, sidebar in `sidebars-schema.js`), separate from the main `docs/` instance. A version dropdown appears in the navbar on schema pages only.
+The schema reference is its own [versioned Docusaurus docs instance](https://docusaurus.io/docs/versioning) (plugin id `schema`, config in `docusaurus.config.js`, sidebar in `sidebars-schema.js`), separate from the main `docs/` instance. Only released schema tags are published; there is no rolling "latest" built from `main`. The newest tag in `schema_versions.json` is served at `/schema/`, older tags at `/schema/vX.Y.Z/`, and a version dropdown appears in the navbar on schema pages only.
 
-| Version | Source | URL | Where it lives |
-|---------|--------|-----|----------------|
-| `latest` | schema repo `main`, generated on every build | `/schema/` | `schema/reference/` (gitignored, never committed) |
-| `vX.Y.Z` | schema release tag, generated once | `/schema/vX.Y.Z/` | `schema_versioned_docs/version-vX.Y.Z/` (committed) |
+Snapshots are generated once per tag and committed under `schema_versioned_docs/version-vX.Y.Z/`. Builds do not call the schema generator, so a production deploy only ever changes the schema pages when a new snapshot lands here.
 
-Every build (CI, PR preview, and production) runs the [`generate-schema-docs`](https://github.com/OvertureMaps/workflows/tree/main/.github/actions/generate-schema-docs) action, which generates Markdown into `schema/reference/` from the schema repository's `main` branch (or a specific `schema-ref` when triggered via `workflow_dispatch`, e.g. from an `overture-schema` release).
+**If you spot a typo or error under `docs.overturemaps.org/schema`, it is not fixable in this repository.** Open an issue or PR against the docstrings/models in [OvertureMaps/schema](https://github.com/OvertureMaps/schema) instead; the fix appears in the next release's snapshot. Re-snapshotting an existing tag is possible (delete its three artifacts and re-run the script below) but pointless unless the tag itself moved.
 
-**If you spot a typo or error under `docs.overturemaps.org/schema`, it is not fixable in this repository.** Open an issue or PR against the docstrings/models in [OvertureMaps/schema](https://github.com/OvertureMaps/schema) instead. `latest` picks up the fix on the next build; a released version only changes if its snapshot is regenerated (delete the three version artifacts and re-run the script below).
+The overview page (`schema/index.md`) is copied into each snapshot when it's created. Edits to it need to be applied to the `index.md` in each `schema_versioned_docs/version-*/` too.
 
 ### Adding a schema version
 
@@ -45,14 +42,18 @@ npm run add-schema-version -- v2.0.0
 
 The script (`scripts/add-schema-version.mjs`) clones the schema repo at that tag, runs its `overture-codegen` into `schema/reference/`, then runs `docusaurus docs:version:schema <tag>`, which writes:
 
-- `schema_versioned_docs/version-<tag>/`
+- `schema_versioned_docs/version-<tag>/` (with links into the schema repo pinned to the tag)
 - `schema_versioned_sidebars/version-<tag>-sidebars.json`
-- an entry in `schema_versions.json` (kept sorted newest-first)
+- an entry in `schema_versions.json` (kept sorted newest-first; the first entry is what `/schema/` serves)
 
 Commit those three and open a PR. `schema/reference/` is cleaned up afterwards.
 
 Only tags that ship the `overture-schema-codegen` package (v1.17.0 and later) can be added; earlier releases were JSON Schema and have no generator. The script refuses tags that don't match `vX.Y.Z` or are already in `schema_versions.json`.
 
+### Schema PR previews
+
+The schema repo's PR preview workflow checks out this repo, generates Markdown from the PR branch into `schema/reference/`, and builds with `SCHEMA_PREVIEW=true`. In that mode the `schema` instance builds only the `current` version from `schema/reference/` at `/schema/`; committed snapshots, the version dropdown, blog, and community pages are skipped.
+
 ## Developing
 
 Docusaurus requires node.
diff --git a/docusaurus.config.js b/docusaurus.config.js
index 3108909fd..9adebc268 100644
--- a/docusaurus.config.js
+++ b/docusaurus.config.js
@@ -42,15 +42,28 @@ function getLatestOvertureRelease() {
 const latestOvertureRelease = getLatestOvertureRelease();
 
 // Schema reference docs are a separate, versioned docs instance (see README
-// "Schema Reference"). `current` is generated at build time from the schema
-// repo's default branch into schema/reference and served at /schema/; released
-// tags live in schema_versioned_docs/ and are served at /schema/<tag>/. Released
-// versions are stable, so suppress the default "unmaintained" banner on them.
-// It can't live under docs/: nested docs instances get their MDX compiled twice.
-const schemaVersionConfig = {
-  current: { label: 'latest', path: '' },
-  ...Object.fromEntries(schemaVersions.map((v) => [v, { label: v, banner: 'none' }])),
-};
+// "Schema Reference"). Only released schema tags are published: snapshots live
+// in schema_versioned_docs/, the newest is served at /schema/ and older ones at
+// /schema/<tag>/. The `current` version (schema/reference, generated from a
+// schema branch by the schema repo's CI) is built only for schema PR previews.
+// Released versions are stable, so suppress the default "unmaintained" banner.
+// The instance can't live under docs/: nested docs instances get their MDX
+// compiled twice.
+const [latestSchemaVersion] = schemaVersions;
+const latestSchemaDocsDir = `schema_versioned_docs/version-${latestSchemaVersion}`;
+const schemaVersionOptions = isSchemaPreview
+  ? {
+      includeCurrentVersion: true,
+      onlyIncludeVersions: ['current'],
+      versions: { current: { label: 'preview', path: '' } },
+    }
+  : {
+      includeCurrentVersion: false,
+      lastVersion: latestSchemaVersion,
+      versions: Object.fromEntries(
+        schemaVersions.map((v) => [v, { label: v, banner: 'none', path: v === latestSchemaVersion ? '' : v }]),
+      ),
+    };
 
 /** @type {import('@docusaurus/types').Config} */
 const config = {
@@ -118,8 +131,7 @@ const config = {
         sidebarPath: require.resolve('./sidebars-schema.js'),
         showLastUpdateTime: true,
         breadcrumbs: false,
-        lastVersion: 'current',
-        versions: schemaVersionConfig,
+        ...schemaVersionOptions,
       }),
     ],
     ...(isSchemaPreview
@@ -150,10 +162,10 @@ const config = {
             {
               generateLLMsTxt: true,
               generateLLMsFullTxt: true,
-              // Latest schema reference only; versioned snapshots are excluded
+              // Newest schema version only; older snapshots are excluded
               docsDir: [
-                { path: 'docs', routeBasePath: '/' },
-                { path: 'schema', routeBasePath: 'schema' },
+                { path: 'docs', routeBasePath: '/', label: 'Docs' },
+                { path: latestSchemaDocsDir, routeBasePath: 'schema', label: 'Schema Reference' },
               ],
               excludeImports: true,
               removeDuplicateHeadings: true,
@@ -162,7 +174,7 @@ const config = {
               includeOrder: [
                 'getting-data/**',
                 'guides/**',
-                'schema/**',
+                `${latestSchemaDocsDir}/**`,
                 'examples/**',
                 'gers/**',
               ],
@@ -173,7 +185,7 @@ const config = {
               customLLMFiles: [
                 {
                   filename: 'llms-schema.txt',
-                  includePatterns: ['schema/**'],
+                  includePatterns: [`${latestSchemaDocsDir}/**`],
                   fullContent: true,
                   title: 'Overture Maps Schema Reference',
                   description:
@@ -252,15 +264,15 @@ const config = {
                   label: 'Community',
                   position: 'left',
                 },
+                {
+                  type: 'docsVersionDropdown',
+                  docsPluginId: 'schema',
+                  position: 'right',
+                  // Only shown on schema pages; see custom.css
+                  className: 'schema-version-dropdown',
+                },
               ]
             : []),
-          {
-            type: 'docsVersionDropdown',
-            docsPluginId: 'schema',
-            position: 'right',
-            // Only shown on schema pages; see custom.css
-            className: 'schema-version-dropdown',
-          },
           {
             to: 'https://github.com/OvertureMaps/docs',
             position: 'right',
diff --git a/schema_versioned_docs/version-v1.17.0/index.md b/schema_versioned_docs/version-v1.17.0/index.md
deleted file mode 100644
index 234c9dc12..000000000
--- a/schema_versioned_docs/version-v1.17.0/index.md
+++ /dev/null
@@ -1,58 +0,0 @@
----
-id: index
-slug: /
-title: Schema Reference
-sidebar_label: Overview
-description: Pydantic schemas for Overture Maps data
-pagination_label: Schema Reference Overview
----
-
-# Overture Maps Schema
-
-:::note
-This section has been recently updated to reflect changes in our schema modeling. We welcome your feedback in [GitHub Discussions](https://github.com/OvertureMaps/data/discussions).
-:::
-
-The Overture Maps schema defines the structure, properties, and constraints for all features across six themes: addresses, base, buildings, divisions, places, and transportation. The reference pages in this section document the theme-based and shared modules in the schema.
-
-The schema is authored as [Pydantic](https://docs.pydantic.dev/) models and the reference documentation is generated from those models. The source code lives in the [OvertureMaps/schema](https://github.com/OvertureMaps/schema) repository on GitHub.
-
-:::tip[Found an error on this page?]
-This page is generated from the Pydantic models in [OvertureMaps/schema](https://github.com/OvertureMaps/schema/issues). Please file an issue there for changes.
-:::
-
-## Why Use Pydantic to Define Data Schemas?
-
-This project addresses a fundamental challenge in data consumption: bridging the semantic gap between raw data and human understanding while enabling machine-actionable workflows.
-
-## Why Schema at All: Beyond Raw Data
-
-Take a column like `pop_2020`. Is it total population? Population density per square kilometer? Working-age population? Without a schema, you're left sampling values and guessing from column names.
-
-Compare this to OpenStreetMap's approach: features use well-known key-value pairs like `building=residential` or `addr:housenumber=42` that have semantic meaning and can be looked up on the OSM wiki. This creates a step toward a schema — shared vocabulary with documented semantics used across a vast dataset. However, OSM tags remain free-form: multiple valid ways to express the same concept, no built-in validation, and complex downstream validation because of undocumented keys that might have meaning to someone, somewhere. A schema provides the structured alternative: explicit types, clear validation rules, and semantic meaning that both humans and systems can rely on.
-
-Data files containing only column names and values aren't fully documented. External metadata files typically focus on how data was collected and encoded, not on semantic meaning or validation rules. Data consumers struggle to understand what datasets contain and which columns they need for their goals.
-
-## Why Pydantic Over JSON Schema: Solving Multiple Problems
-
-We initially chose JSON Schema because it aligned with our mental model and promised to solve our problems as we understood them. But JSON Schema surfaced several pain points:
-
-- **Authoring difficulty:** Hard to write correctly, difficult to verify, limited IDE support, no refactoring capabilities
-- **Tooling gaps:** Generic tools can't tailor output for specific applications like ours
-- **Development friction:** Schema changes required manual coordination across multiple artifacts
-
-Pydantic addresses these systematically: author in Python with full IDE support, generate tailored documentation, and automatically produce the specific artifacts each workflow needs. Pydantic can also produce JSON Schema, so any application that requires it can use it while we gain all the Python benefits during authoring.
-
-## The Result: Faster Understanding, Higher Quality
-
-Instead of spending time deciphering what columns mean and whether data matches expectations, users can focus on their actual goals: analysis, visualization, integration. Quality improves because validation happens automatically rather than through manual inspection.
-
-The fundamental approach — human-readable authoring that generates machine-actionable outputs — has broader applications beyond Overture and geospatial data. We hope others will adapt these patterns for linking with Overture data or modeling their own domains entirely.
-
-## Schema Modules
-
-Browse the schema reference in the sidebar. Modules are organized by theme and shared components:
-
-**Themes:** Addresses, Base, Buildings, Divisions, Places, Transportation
-
-**Shared:** Core (names, sources, cartographic hints), System (country codes, language tags, geometry primitives)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/addresses/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/addresses/_category_.json
deleted file mode 100644
index 29c13add5..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/addresses/_category_.json
+++ /dev/null
@@ -1,4 +0,0 @@
-{
-  "label": "Addresses",
-  "position": 1
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/addresses/address.md b/schema_versioned_docs/version-v1.17.0/reference/addresses/address.md
deleted file mode 100644
index 820a0d9aa..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/addresses/address.md
+++ /dev/null
@@ -1,76 +0,0 @@
----
-sidebar_position: 1
----
-
-# Address
-
-Addresses are structured labels for the geographic locations where businesses and individuals
-reside.
-
-While address formats around the world have some general points in common, the specifics vary
-extensively from place to place. The rules for dividing an address up into parts or fields vary,
-as do the names of those parts or fields.
-
-The address schema uses a simplified approach to capture the common structure of addresses
-worldwide while accommodating local variance. The schema is heavily based on the OpenAddresses
-([www.openaddresses.io](https://www.openaddresses.io)) project.
-
-For sub-country administrative levels (and non-administrative levels such as neighborhoods), the
-schema provides the `address_levels` field. This is where the names of cities and towns,
-provinces, state, and regions, and similar addressing units are found.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
-| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
-| `geometry` | [`geometry`](../system/primitive/geometry.md) | Position of the address. Addresses are point geometries.<br/><br/>*Allowed geometry types: Point* |
-| `theme` | `"addresses"` | |
-| `type` | `"address"` | |
-| `version` | [`FeatureVersion`](../common/feature_version.md) | |
-| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
-| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
-| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
-| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
-| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
-| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
-| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
-| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
-| `address_levels[]` | `list<`[`AddressLevel`](types/address_level.md)`>` (optional) | Names of the sub-country addressing areas the address belongs to, including the city or locality, in descending order of generality.<br/><br/>The list is sorted so that the highest, or most general, level comes first (*e.g.*, region) and the lowest, or most particular level, comes last (*e.g.*, city or town).<br/><br/>The number of items in this list and their meaning is country-dependent. For example, in the United States, we expect two items: the state, and the locality or municipality within the state. Other countries might have as few as one, or even three or more.<br/><br/>When a specific level that is required for a country is not known. most likely because the data provider has not supplied it and we have not derived it from another source, the list item corresponding to that level must be present, but its `value` field should be omitted.<br/><br/>*Minimum length: 1*<br/>*Maximum length: 5* |
-| `address_levels[].value` | [`StrippedString`](../system/stripped_string.md) (optional) | A string without leading or trailing whitespace |
-| `country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) | The country the address belongs to, as an ISO 3166-1 alpha-2 country code. |
-| `number` | [`StrippedString`](../system/stripped_string.md) (optional) | The house number.<br/><br/>This field does not necessarily contain an integer or even a number. Values such as "74B", "189 1/2", and "208.5", where the non-integer or non-number part is part of the house number, not a unit number, are in common use.<br/><br/>*Minimum length: 1* |
-| `postal_city` | [`StrippedString`](../system/stripped_string.md) (optional) | The postal authority designated city name, if applicable.<br/><br/>In some countries or regions, a mailing address may need to specify a different city name than the city that actually contains the address coordinates. This optional field can be used to specify the alternate city name to use.<br/><br/>For example:<br/><br/>- The postal city for the US address *716 East County Road, Winchester, Indiana*   is Ridgeville. - The postal city for the Slovenian address *Tomaj 71, 6221 Tomaj, Slovenia* is   Dutovlje.<br/><br/>*Minimum length: 1* |
-| `postcode` | [`StrippedString`](../system/stripped_string.md) (optional) | The postal code.<br/><br/>*Minimum length: 1* |
-| `street` | [`StrippedString`](../system/stripped_string.md) (optional) | The street name.<br/><br/>The street name can include a type (*e.g.*, "Street" or "St", "Boulevard" or "Blvd", *etc.*) and a directional (*e.g.*, "NW" or "Northwest", "S" or "Sud"). Both type and directional, if present, may be either a prefix or a suffix to the primary name. They may either be fully spelled-out or abbreviated.<br/><br/>*Minimum length: 1* |
-| `unit` | [`StrippedString`](../system/stripped_string.md) (optional) | The secondary address unit designator.<br/><br/>In the case where the primary street address is divided into secondary units, which may be apartments, floors, or even buildings if the primary street address is a campus, this field names the specific secondary unit being addressed.<br/><br/>*Minimum length: 1* |
-
-## Examples
-
-| Column | Value |
-| -------: | ------- |
-| `id` | `416ab01c-d836-4c4f-aedc-2f30941ce94d` |
-| `bbox.xmin` | `-176.56381225585938` |
-| `bbox.ymin` | `-43.94719696044922` |
-| `bbox.xmax` | `-176.56378173828125` |
-| `bbox.ymax` | `-43.94718933105469` |
-| `geometry` | `POINT (-176.5637854 -43.9471955)` |
-| `theme` | `addresses` |
-| `type` | `address` |
-| `version` | `1` |
-| `sources[0].property` |  |
-| `sources[0].dataset` | `OpenAddresses/LINZ` |
-| `sources[0].license` | `null` |
-| `sources[0].record_id` | `null` |
-| `sources[0].update_time` | `null` |
-| `sources[0].confidence` | `null` |
-| `sources[0].between` | `null` |
-| `address_levels[0].value` | `Chatham Islands` |
-| `address_levels[1].value` | `Chatham Island` |
-| `country` | `NZ` |
-| `number` | `54` |
-| `postal_city` | `null` |
-| `postcode` | `null` |
-| `street` | `Tikitiki Hill Road` |
-| `unit` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/addresses/types/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/addresses/types/_category_.json
deleted file mode 100644
index a3ec08974..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/addresses/types/_category_.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-  "label": "Types"
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/addresses/types/address_level.md b/schema_versioned_docs/version-v1.17.0/reference/addresses/types/address_level.md
deleted file mode 100644
index b0762021c..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/addresses/types/address_level.md
+++ /dev/null
@@ -1,26 +0,0 @@
-# AddressLevel
-
-A sub-country addressing unit, such as a region, city, or neighborhood, that is less specific
-than a street name and not a postal code.
-
-In the following address, the terms `Montréal` and `QC` are address levels:
-
-```
-3998 Rue De Bullion, Montréal, QC H2W 2E4
-```
-
-The number of address levels per address is country-dependent.
-
-Other addressing systems may use the terms "administrative level" or "admin level"  for the
-same concept. We have chosen the term "address level" to communicate the fact that in some
-countries and regions, address levels do not necessarily correspond to administrative units.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `value` | [`StrippedString`](../../system/stripped_string.md) (optional) | A string without leading or trailing whitespace<br/><br/>*Minimum length: 1* |
-
-## Used By
-
-- [`Address`](../address.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/base/_category_.json
deleted file mode 100644
index b6b444780..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/_category_.json
+++ /dev/null
@@ -1,4 +0,0 @@
-{
-  "label": "Base",
-  "position": 2
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/bathymetry.md b/schema_versioned_docs/version-v1.17.0/reference/base/bathymetry.md
deleted file mode 100644
index 19039a8eb..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/bathymetry.md
+++ /dev/null
@@ -1,59 +0,0 @@
----
-sidebar_position: 1
----
-
-# Bathymetry
-
-Bathymetry features provide topographic representations of underwater areas, such as parts of
-lake beds or ocean floors.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
-| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
-| `geometry` | [`geometry`](../system/primitive/geometry.md) | Shape of the underwater area, which may be a polygon or multi-polygon.<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
-| `theme` | `"base"` | |
-| `type` | `"bathymetry"` | |
-| `version` | [`FeatureVersion`](../common/feature_version.md) | |
-| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
-| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
-| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
-| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
-| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
-| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
-| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
-| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
-| `depth` | [`Depth`](types/depth.md) | Depth below surface level of the feature in meters. |
-| `cartography` | [`CartographicHints`](../common/cartographic_hints.md) (optional) | Cartographic hints useful when including the feature in maps |
-| `cartography.prominence` | [`Prominence`](../common/prominence.md) (optional) | Subjective scale of feature significance or importance, with 1 being the least, and 100 being the most, significant.<br/><br/>This value can be used to help drive decisions about how and when to display a feature, and how to treat it relative to neighboring features.<br/><br/>When populated by Overture, this value is derived from various factors including, but not limited to: feature and subtype, population, and capital status. |
-| `cartography.min_zoom` | [`MinZoom`](../common/min_zoom.md) (optional) | Recommended minimum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels below this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
-| `cartography.max_zoom` | [`MaxZoom`](../common/max_zoom.md) (optional) | Recommended maximum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels above this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
-| `cartography.sort_key` | [`SortKey`](../common/sort_key.md) (optional) | Integer indicating the recommended order in which to draw features.<br/><br/>Features with a lower number should be drawn "in front" of features with a higher number. |
-
-## Examples
-
-| Column | Value |
-| -------: | ------- |
-| `id` | `5d40bd6c-db14-5492-b29f-5e25a59032bc` |
-| `bbox.xmin` | `-175.12791442871094` |
-| `bbox.ymin` | `-77.9718246459961` |
-| `bbox.xmax` | `-170.05111694335938` |
-| `bbox.ymax` | `-75.64299774169922` |
-| `geometry` | `MULTIPOLYGON (((-170.71296928 -76.744313428, -170.719841483 -76.757076376, -170.731061124 -76.761...` |
-| `theme` | `base` |
-| `type` | `bathymetry` |
-| `version` | `0` |
-| `sources[0].property` |  |
-| `sources[0].dataset` | `ETOPO/GLOBathy` |
-| `sources[0].license` | `null` |
-| `sources[0].record_id` | `2024-12-09T00:00:00.000Z` |
-| `sources[0].update_time` | `null` |
-| `sources[0].confidence` | `null` |
-| `sources[0].between` | `null` |
-| `depth` | `500` |
-| `cartography.prominence` | `null` |
-| `cartography.min_zoom` | `null` |
-| `cartography.max_zoom` | `null` |
-| `cartography.sort_key` | `12` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/infrastructure.md b/schema_versioned_docs/version-v1.17.0/reference/base/infrastructure.md
deleted file mode 100644
index 7e97a4f38..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/infrastructure.md
+++ /dev/null
@@ -1,77 +0,0 @@
----
-sidebar_position: 1
----
-
-# Infrastructure
-
-Infrastructure features provide basic information about real-world infrastructure entitites
-such as bridges, airports, runways, aerialways, communication towers, and power lines.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
-| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
-| `geometry` | [`geometry`](../system/primitive/geometry.md) | Geometry of the infrastructure feature, which may be a point, line string, polygon, or multi-polygon.<br/><br/>*Allowed geometry types: LineString, MultiPolygon, Point, Polygon* |
-| `theme` | `"base"` | |
-| `type` | `"infrastructure"` | |
-| `version` | [`FeatureVersion`](../common/feature_version.md) | |
-| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
-| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
-| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
-| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
-| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
-| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
-| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
-| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
-| `class` | [`InfrastructureClass`](types/infrastructure_class.md) | |
-| `subtype` | [`InfrastructureSubtype`](types/infrastructure_subtype.md) | |
-| `height` | [`Height`](types/height.md) (optional) | Height of the feature in meters. |
-| `surface` | [`SurfaceMaterial`](types/surface_material.md) (optional) | |
-| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
-| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
-| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
-| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
-| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
-| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
-| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
-| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
-| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
-| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
-| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
-| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
-| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level |
-| `source_tags` | [`SourceTags`](types/source_tags.md) (map, optional) | Key/value pairs imported directly from the source data without change.<br/><br/>This field provides access to raw OSM entity tags for features sourced from OpenStreetMap. |
-| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
-
-## Examples
-
-| Column | Value |
-| -------: | ------- |
-| `id` | `e9e3d506-89c0-3473-8cee-5e5ac6596d6c` |
-| `bbox.xmin` | `-180.0` |
-| `bbox.ymin` | `-82.42408752441406` |
-| `bbox.xmax` | `-179.99998474121094` |
-| `bbox.ymax` | `-82.42407989501953` |
-| `geometry` | `POINT (-179.9999994 -82.42408)` |
-| `theme` | `base` |
-| `type` | `infrastructure` |
-| `version` | `0` |
-| `sources[0].property` |  |
-| `sources[0].dataset` | `OpenStreetMap` |
-| `sources[0].license` | `null` |
-| `sources[0].record_id` | `n7674174803@2` |
-| `sources[0].update_time` | `2023-04-07T17:37:48+00:00` |
-| `sources[0].confidence` | `null` |
-| `sources[0].between` | `null` |
-| `class` | `information` |
-| `subtype` | `pedestrian` |
-| `height` | `null` |
-| `surface` | `null` |
-| `names.primary` | `1306 km to South Pole` |
-| `names.common` | `null` |
-| `names.rules` | `null` |
-| `level` | `0` |
-| `source_tags` | `{"description": "1036 km to South Pole.", "information": "route_marker", "note": "The road contin...` |
-| `wikidata` | `Q800558` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/land.md b/schema_versioned_docs/version-v1.17.0/reference/base/land.md
deleted file mode 100644
index 82cc28a19..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/land.md
+++ /dev/null
@@ -1,87 +0,0 @@
----
-sidebar_position: 1
----
-
-# Land
-
-Land features are representations of physical land surfaces.
-
-In Overture data releases, land features are sourced from OpenStreetMap. TODO. Finish this when
-I get more info from Jennings.
-
-
-
-Physical representations of land surfaces.
-
-Global land derived from the inverse of OSM Coastlines. Translates `natural` tags from OpenStreetMap.
-
-TODO: Update this description when the relationship to `land_cover` is better understood.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
-| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
-| `geometry` | [`geometry`](../system/primitive/geometry.md) | Geometry of the land feature, which may be a point, line string, polygon, or multi-polygon.<br/><br/>*Allowed geometry types: LineString, MultiPolygon, Point, Polygon* |
-| `theme` | `"base"` | |
-| `type` | `"land"` | |
-| `version` | [`FeatureVersion`](../common/feature_version.md) | |
-| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
-| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
-| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
-| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
-| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
-| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
-| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
-| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
-| `class` | [`LandClass`](types/land_class.md) (optional) | |
-| `subtype` | [`LandSubtype`](types/land_subtype.md) (optional) | |
-| `elevation` | [`Elevation`](types/elevation.md) (optional) | Elevation above sea level of the feature in meters. |
-| `surface` | [`SurfaceMaterial`](types/surface_material.md) (optional) | |
-| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
-| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
-| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
-| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
-| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
-| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
-| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
-| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
-| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
-| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
-| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
-| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
-| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level |
-| `source_tags` | [`SourceTags`](types/source_tags.md) (map, optional) | Key/value pairs imported directly from the source data without change.<br/><br/>This field provides access to raw OSM entity tags for features sourced from OpenStreetMap. |
-| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
-
-## Examples
-
-| Column | Value |
-| -------: | ------- |
-| `id` | `70fc3596-a987-3fea-820c-c016c0a2f0da` |
-| `bbox.xmin` | `-178.7000274658203` |
-| `bbox.ymin` | `-85.45001220703125` |
-| `bbox.xmax` | `-178.6999969482422` |
-| `bbox.ymax` | `-85.44999694824219` |
-| `geometry` | `POINT (-178.7 -85.45)` |
-| `theme` | `base` |
-| `type` | `land` |
-| `version` | `0` |
-| `sources[0].property` |  |
-| `sources[0].dataset` | `OpenStreetMap` |
-| `sources[0].license` | `null` |
-| `sources[0].record_id` | `n11693475112@1` |
-| `sources[0].update_time` | `2024-03-05T09:23:39+00:00` |
-| `sources[0].confidence` | `null` |
-| `sources[0].between` | `null` |
-| `class` | `cliff` |
-| `subtype` | `physical` |
-| `elevation` | `null` |
-| `surface` | `null` |
-| `names.primary` | `Dismal Buttress` |
-| `names.common` | `null` |
-| `names.rules` | `null` |
-| `level` | `0` |
-| `source_tags` | `{"natural": "cliff", "ref:linz:place_id": "12318", "wikipedia": "en:Dismal Buttress"}` |
-| `wikidata` | `Q5282342` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/land_cover.md b/schema_versioned_docs/version-v1.17.0/reference/base/land_cover.md
deleted file mode 100644
index 3452c29cc..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/land_cover.md
+++ /dev/null
@@ -1,66 +0,0 @@
----
-sidebar_position: 1
----
-
-# LandCover
-
-Land cover features indicate the primary natural or artificial surface material covering a land
-area on the earth, including vegetation types like forests and crops, built environments like
-cities, and natural surfaces like wetlands or barren ground.
-
-Land cover features relate to `LandUse` features in the following way: land cover is the
-physical thing covering the land, while land use is the human use to which the land is being
-put.
-
-TODO: Explain relationship to `Land` features.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
-| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
-| `geometry` | [`geometry`](../system/primitive/geometry.md) | Shape of the covered land area, which may be a polygon or multi-polygon.<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
-| `theme` | `"base"` | |
-| `type` | `"land_cover"` | |
-| `version` | [`FeatureVersion`](../common/feature_version.md) | |
-| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
-| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
-| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
-| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
-| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
-| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
-| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
-| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
-| `subtype` | [`LandCoverSubtype`](types/land_cover_subtype.md) | |
-| `cartography` | [`CartographicHints`](../common/cartographic_hints.md) (optional) | Cartographic hints useful when including the feature in maps |
-| `cartography.prominence` | [`Prominence`](../common/prominence.md) (optional) | Subjective scale of feature significance or importance, with 1 being the least, and 100 being the most, significant.<br/><br/>This value can be used to help drive decisions about how and when to display a feature, and how to treat it relative to neighboring features.<br/><br/>When populated by Overture, this value is derived from various factors including, but not limited to: feature and subtype, population, and capital status. |
-| `cartography.min_zoom` | [`MinZoom`](../common/min_zoom.md) (optional) | Recommended minimum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels below this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
-| `cartography.max_zoom` | [`MaxZoom`](../common/max_zoom.md) (optional) | Recommended maximum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels above this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
-| `cartography.sort_key` | [`SortKey`](../common/sort_key.md) (optional) | Integer indicating the recommended order in which to draw features.<br/><br/>Features with a lower number should be drawn "in front" of features with a higher number. |
-
-## Examples
-
-| Column | Value |
-| -------: | ------- |
-| `id` | `c347312d-012b-5e73-8bd3-a10d04b2981d` |
-| `bbox.xmin` | `-180.0001983642578` |
-| `bbox.ymin` | `65.95172119140625` |
-| `bbox.xmax` | `-179.99313354492188` |
-| `bbox.ymax` | `65.96218872070312` |
-| `geometry` | `POLYGON ((-179.99877531181616 65.95172539425603, -179.99740705536922 65.95265577758867, -179.9975...` |
-| `theme` | `base` |
-| `type` | `land_cover` |
-| `version` | `0` |
-| `sources[0].property` |  |
-| `sources[0].dataset` | `ESA WorldCover` |
-| `sources[0].license` | `null` |
-| `sources[0].record_id` | `null` |
-| `sources[0].update_time` | `2024-11-07T00:00:00+00:00` |
-| `sources[0].confidence` | `null` |
-| `sources[0].between` | `null` |
-| `subtype` | `barren` |
-| `cartography.prominence` | `null` |
-| `cartography.min_zoom` | `8` |
-| `cartography.max_zoom` | `15` |
-| `cartography.sort_key` | `3` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/land_use.md b/schema_versioned_docs/version-v1.17.0/reference/base/land_use.md
deleted file mode 100644
index db5bccc6a..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/land_use.md
+++ /dev/null
@@ -1,82 +0,0 @@
----
-sidebar_position: 1
----
-
-# LandUse
-
-Land use features specify the predominant human use of an area of land, for example commercial
-activity, recreation, farming, housing, education, or military use.
-
-Land use features relate to `LandCover` features in the following way: land use is the human
-human activity being done with the land, while land cover is the physical thing that covers it.
-
-TODO: Explain relationship to `Land` features.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
-| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
-| `geometry` | [`geometry`](../system/primitive/geometry.md) | Geometry of the land use area, which may be a point, line string, polygon, or multi-polygon.<br/><br/>*Allowed geometry types: LineString, MultiPolygon, Point, Polygon* |
-| `theme` | `"base"` | |
-| `type` | `"land_use"` | |
-| `version` | [`FeatureVersion`](../common/feature_version.md) | |
-| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
-| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
-| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
-| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
-| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
-| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
-| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
-| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
-| `class` | [`LandUseClass`](types/land_use_class.md) | |
-| `subtype` | [`LandUseSubtype`](types/land_use_subtype.md) | |
-| `elevation` | [`Elevation`](types/elevation.md) (optional) | Elevation above sea level of the feature in meters. |
-| `surface` | [`SurfaceMaterial`](types/surface_material.md) (optional) | |
-| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
-| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
-| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
-| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
-| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
-| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
-| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
-| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
-| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
-| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
-| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
-| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
-| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level |
-| `source_tags` | [`SourceTags`](types/source_tags.md) (map, optional) | Key/value pairs imported directly from the source data without change.<br/><br/>This field provides access to raw OSM entity tags for features sourced from OpenStreetMap. |
-| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
-
-## Examples
-
-| Column | Value |
-| -------: | ------- |
-| `id` | `1e1f6095-5bd2-3fdb-a422-41351b848e9d` |
-| `bbox.xmin` | `-176.56825256347656` |
-| `bbox.ymin` | `-43.96001052856445` |
-| `bbox.xmax` | `-176.56231689453125` |
-| `bbox.ymax` | `-43.95420837402344` |
-| `geometry` | `POLYGON ((-176.5623454 -43.9567812, -176.5627644 -43.9561272, -176.5626898 -43.9557432, -176.5624...` |
-| `theme` | `base` |
-| `type` | `land_use` |
-| `version` | `0` |
-| `sources[0].property` |  |
-| `sources[0].dataset` | `OpenStreetMap` |
-| `sources[0].license` | `null` |
-| `sources[0].record_id` | `w56117029@3` |
-| `sources[0].update_time` | `2010-04-24T22:35:13+00:00` |
-| `sources[0].confidence` | `null` |
-| `sources[0].between` | `null` |
-| `class` | `golf_course` |
-| `subtype` | `golf` |
-| `elevation` | `null` |
-| `surface` | `null` |
-| `names.primary` | `Chatham Islands Golf Club` |
-| `names.common` | `null` |
-| `names.rules` | `null` |
-| `level` | `0` |
-| `source_tags` | `{"LINZ:source_version": "V16", "attribution": "http://wiki.osm.org/wiki/Attribution#LINZ", "leisu...` |
-| `wikidata` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/base/types/_category_.json
deleted file mode 100644
index a3ec08974..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/types/_category_.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-  "label": "Types"
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/depth.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/depth.md
deleted file mode 100644
index f6b96f3ed..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/types/depth.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# Depth
-
-Depth below surface level of the feature in meters.
-
-Underlying type: `int32`
-
-## Constraints
-
-- `≥ 0`
-- `≥ -2147483648` (from [`int32`](../../system/primitive/primitives.md))
-- `≤ 2147483647` (from [`int32`](../../system/primitive/primitives.md))
-
-## Used By
-
-- [`Bathymetry`](../bathymetry.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/elevation.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/elevation.md
deleted file mode 100644
index 2bfb7d128..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/types/elevation.md
+++ /dev/null
@@ -1,16 +0,0 @@
-# Elevation
-
-Elevation above sea level of the feature in meters.
-
-Underlying type: `int32`
-
-## Constraints
-
-- `≤ 9000`
-- `≥ -2147483648` (from [`int32`](../../system/primitive/primitives.md))
-- `≤ 2147483647` (from [`int32`](../../system/primitive/primitives.md))
-
-## Used By
-
-- [`Land`](../land.md)
-- [`LandUse`](../land_use.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/height.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/height.md
deleted file mode 100644
index 6a4b542fb..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/types/height.md
+++ /dev/null
@@ -1,13 +0,0 @@
-# Height
-
-Height of the feature in meters.
-
-Underlying type: `float64`
-
-## Constraints
-
-- `> 0`
-
-## Used By
-
-- [`Infrastructure`](../infrastructure.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/infrastructure_class.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/infrastructure_class.md
deleted file mode 100644
index b8cc4043a..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/types/infrastructure_class.md
+++ /dev/null
@@ -1,176 +0,0 @@
-# InfrastructureClass
-
-Further classification of the type of infrastructure.
-
-The infrastructure class adds detail to the broad classification of `InfrastructureSubtype`.
-
-## Values
-
-- `aerialway_station`
-- `airport`
-- `airport_gate`
-- `airstrip`
-- `apron`
-- `aqueduct`
-- `artwork`
-- `atm`
-- `barrier`
-- `bell_tower`
-- `bench`
-- `bicycle_parking`
-- `bicycle_rental`
-- `block`
-- `boardwalk`
-- `bollard`
-- `border_control`
-- `breakwater`
-- `bridge`
-- `bridge_support`
-- `bump_gate`
-- `bus_route`
-- `bus_station`
-- `bus_stop`
-- `bus_trap`
-- `cable`
-- `cable_barrier`
-- `cable_car`
-- `cable_distribution`
-- `camp_site`
-- `cantilever`
-- `catenary_mast`
-- `cattle_grid`
-- `chain`
-- `chair_lift`
-- `charging_station`
-- `city_wall`
-- `communication_line`
-- `communication_pole`
-- `communication_tower`
-- `connection`
-- `cooling`
-- `covered`
-- `crossing`
-- `cutline`
-- `cycle_barrier`
-- `dam`
-- `defensive`
-- `ditch`
-- `diving`
-- `drag_lift`
-- `drain`
-- `drinking_water`
-- `entrance`
-- `fence`
-- `ferry_terminal`
-- `fire_hydrant`
-- `fountain`
-- `full-height_turnstile`
-- `gasometer`
-- `gate`
-- `generator`
-- `give_way`
-- `gondola`
-- `goods`
-- `guard_rail`
-- `hampshire_gate`
-- `handrail`
-- `hedge`
-- `height_restrictor`
-- `heliostat`
-- `helipad`
-- `heliport`
-- `hose`
-- `information`
-- `insulator`
-- `international_airport`
-- `j-bar`
-- `jersey_barrier`
-- `kerb`
-- `kissing_gate`
-- `launchpad`
-- `lift_gate`
-- `lighting`
-- `lightning_protection`
-- `magic_carpet`
-- `manhole`
-- `milestone`
-- `military_airport`
-- `minaret`
-- `minor_line`
-- `mixed_lift`
-- `mobile_phone_tower`
-- `monitoring`
-- `motorcycle_parking`
-- `motorway_junction`
-- `movable`
-- `municipal_airport`
-- `observation`
-- `parking`
-- `parking_entrance`
-- `parking_space`
-- `pedestrian_crossing`
-- `picnic_table`
-- `pier`
-- `pipeline`
-- `plant`
-- `planter`
-- `platform`
-- `platter`
-- `portal`
-- `post_box`
-- `power_line`
-- `power_pole`
-- `power_tower`
-- `private_airport`
-- `pylon`
-- `quay`
-- `radar`
-- `railway_halt`
-- `railway_station`
-- `recycling`
-- `regional_airport`
-- `reservoir_covered`
-- `retaining_wall`
-- `roller_coaster`
-- `rope_tow`
-- `runway`
-- `sally_port`
-- `seaplane_airport`
-- `sewer`
-- `silo`
-- `siren`
-- `stile`
-- `stop`
-- `stop_position`
-- `stopway`
-- `storage_tank`
-- `street_cabinet`
-- `street_lamp`
-- `substation`
-- `subway_station`
-- `swing_gate`
-- `switch`
-- `t-bar`
-- `taxilane`
-- `taxiway`
-- `terminal`
-- `toilets`
-- `toll_booth`
-- `traffic_signals`
-- `transformer`
-- `trestle`
-- `utility_pole`
-- `vending_machine`
-- `viaduct`
-- `viewpoint`
-- `wall`
-- `waste_basket`
-- `waste_disposal`
-- `watchtower`
-- `water_tower`
-- `weir`
-- `zip_line`
-
-## Used By
-
-- [`Infrastructure`](../infrastructure.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/infrastructure_subtype.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/infrastructure_subtype.md
deleted file mode 100644
index c7432d702..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/types/infrastructure_subtype.md
+++ /dev/null
@@ -1,30 +0,0 @@
-# InfrastructureSubtype
-
-Broadest classification of the type of infrastructure.
-
-This broad classification can be refined by `InfrastructureClass`.
-
-## Values
-
-- `aerialway`
-- `airport`
-- `barrier`
-- `bridge`
-- `communication`
-- `emergency`
-- `manhole`
-- `pedestrian`
-- `pier`
-- `power`
-- `quay`
-- `recreation`
-- `tower`
-- `transit`
-- `transportation`
-- `utility`
-- `waste_management`
-- `water`
-
-## Used By
-
-- [`Infrastructure`](../infrastructure.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/land_class.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/land_class.md
deleted file mode 100644
index 8c63ddaf1..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/types/land_class.md
+++ /dev/null
@@ -1,54 +0,0 @@
-# LandClass
-
-Further classification of the land.
-
-The land class adds detail to the broad classification of `LandSubtype`.
-
-## Values
-
-- `archipelago`
-- `bare_rock`
-- `beach`
-- `cave_entrance`
-- `cliff`
-- `desert`
-- `dune`
-- `fell`
-- `forest`
-- `glacier`
-- `grass`
-- `grassland`
-- `heath`
-- `hill`
-- `island`
-- `islet`
-- `land`
-- `meadow`
-- `meteor_crater`
-- `mountain_range`
-- `peak`
-- `peninsula`
-- `plateau`
-- `reef`
-- `ridge`
-- `rock`
-- `saddle`
-- `sand`
-- `scree`
-- `scrub`
-- `shingle`
-- `shrub`
-- `shrubbery`
-- `stone`
-- `tree`
-- `tree_row`
-- `tundra`
-- `valley`
-- `volcanic_caldera_rim`
-- `volcano`
-- `wetland`
-- `wood`
-
-## Used By
-
-- [`Land`](../land.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/land_cover_subtype.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/land_cover_subtype.md
deleted file mode 100644
index 8a9676ae8..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/types/land_cover_subtype.md
+++ /dev/null
@@ -1,20 +0,0 @@
-# LandCoverSubtype
-
-Primary or dominant material covering the land.
-
-## Values
-
-- `barren`
-- `crop`
-- `forest`
-- `grass`
-- `mangrove`
-- `moss`
-- `shrub`
-- `snow`
-- `urban`
-- `wetland`
-
-## Used By
-
-- [`LandCover`](../land_cover.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/land_subtype.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/land_subtype.md
deleted file mode 100644
index 9e92c91af..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/types/land_subtype.md
+++ /dev/null
@@ -1,25 +0,0 @@
-# LandSubtype
-
-Broadest classification of the land.
-
-This broad classification can be refined by `LandClass`.
-
-## Values
-
-- `crater`
-- `desert`
-- `forest`
-- `glacier`
-- `grass`
-- `land`
-- `physical`
-- `reef`
-- `rock`
-- `sand`
-- `shrub`
-- `tree`
-- `wetland`
-
-## Used By
-
-- [`Land`](../land.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/land_use_class.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/land_use_class.md
deleted file mode 100644
index 5c9531d89..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/types/land_use_class.md
+++ /dev/null
@@ -1,121 +0,0 @@
-# LandUseClass
-
-Further classification of the land use.
-
-The land use class adds detail to the broad classification of `LandUseSubtype`.
-
-## Values
-
-- `aboriginal_land`
-- `airfield`
-- `allotments`
-- `animal_keeping`
-- `aquaculture`
-- `barracks`
-- `base`
-- `beach_resort`
-- `brownfield`
-- `bunker`
-- `camp_site`
-- `cemetery`
-- `clinic`
-- `college`
-- `commercial`
-- `connection`
-- `construction`
-- `danger_area`
-- `doctors`
-- `dog_park`
-- `downhill`
-- `driving_range`
-- `driving_school`
-- `education`
-- `environmental`
-- `fairway`
-- `farmland`
-- `farmyard`
-- `fatbike`
-- `flowerbed`
-- `forest`
-- `garages`
-- `garden`
-- `golf_course`
-- `grass`
-- `grave_yard`
-- `green`
-- `greenfield`
-- `greenhouse_horticulture`
-- `highway`
-- `hike`
-- `hospital`
-- `ice_skate`
-- `industrial`
-- `institutional`
-- `kindergarten`
-- `landfill`
-- `lateral_water_hazard`
-- `logging`
-- `marina`
-- `meadow`
-- `military`
-- `military_hospital`
-- `military_school`
-- `music_school`
-- `national_park`
-- `natural_monument`
-- `nature_reserve`
-- `naval_base`
-- `nordic`
-- `nuclear_explosion_site`
-- `obstacle_course`
-- `orchard`
-- `park`
-- `peat_cutting`
-- `pedestrian`
-- `pitch`
-- `plant_nursery`
-- `playground`
-- `plaza`
-- `protected`
-- `protected_landscape_seascape`
-- `quarry`
-- `railway`
-- `range`
-- `recreation_ground`
-- `religious`
-- `residential`
-- `resort`
-- `retail`
-- `rough`
-- `salt_pond`
-- `school`
-- `schoolyard`
-- `ski_jump`
-- `skitour`
-- `sled`
-- `sleigh`
-- `snow_park`
-- `species_management_area`
-- `stadium`
-- `state_park`
-- `static_caravan`
-- `strict_nature_reserve`
-- `tee`
-- `theme_park`
-- `track`
-- `traffic_island`
-- `training_area`
-- `trench`
-- `university`
-- `village_green`
-- `vineyard`
-- `water_hazard`
-- `water_park`
-- `wilderness_area`
-- `winter_sports`
-- `works`
-- `zoo`
-
-## Used By
-
-- [`LandUse`](../land_use.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/land_use_subtype.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/land_use_subtype.md
deleted file mode 100644
index 3acc75d21..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/types/land_use_subtype.md
+++ /dev/null
@@ -1,36 +0,0 @@
-# LandUseSubtype
-
-Broadest classification of the land use.
-
-This broad classification can be refined by `LandUseClass`.
-
-## Values
-
-- `agriculture`
-- `aquaculture`
-- `campground`
-- `cemetery`
-- `construction`
-- `developed`
-- `education`
-- `entertainment`
-- `golf`
-- `grass`
-- `horticulture`
-- `landfill`
-- `managed`
-- `medical`
-- `military`
-- `park`
-- `pedestrian`
-- `protected`
-- `recreation`
-- `religious`
-- `residential`
-- `resource_extraction`
-- `transportation`
-- `winter_sports`
-
-## Used By
-
-- [`LandUse`](../land_use.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/source_tags.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/source_tags.md
deleted file mode 100644
index 41f50ae8f..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/types/source_tags.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# SourceTags
-
-Key/value pairs imported directly from the source data without change.
-
-This field provides access to raw OSM entity tags for features sourced from
-OpenStreetMap.
-
-Underlying type: `map<string, Any>`
-
-## Used By
-
-- [`Infrastructure`](../infrastructure.md)
-- [`Land`](../land.md)
-- [`LandUse`](../land_use.md)
-- [`Water`](../water.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/surface_material.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/surface_material.md
deleted file mode 100644
index 707f5a6a2..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/types/surface_material.md
+++ /dev/null
@@ -1,36 +0,0 @@
-# SurfaceMaterial
-
-Material that makes up the surface of `Infrastructure` and `Land` features.
-
-## Values
-
-- `asphalt`
-- `cobblestone`
-- `compacted`
-- `concrete`
-- `concrete_plates`
-- `dirt`
-- `earth`
-- `fine_gravel`
-- `grass`
-- `gravel`
-- `ground`
-- `paved`
-- `paving_stones`
-- `pebblestone`
-- `recreation_grass`
-- `recreation_paved`
-- `recreation_sand`
-- `rubber`
-- `sand`
-- `sett`
-- `tartan`
-- `unpaved`
-- `wood`
-- `woodchips`
-
-## Used By
-
-- [`Infrastructure`](../infrastructure.md)
-- [`Land`](../land.md)
-- [`LandUse`](../land_use.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/water_class.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/water_class.md
deleted file mode 100644
index def472f93..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/types/water_class.md
+++ /dev/null
@@ -1,47 +0,0 @@
-# WaterClass
-
-Further description of the type of water body.
-
-The water class adds detail to the broad classification of `WaterSubtype`.
-
-## Values
-
-- `basin`
-- `bay`
-- `blowhole`
-- `canal`
-- `cape`
-- `ditch`
-- `dock`
-- `drain`
-- `fairway`
-- `fish_pass`
-- `fishpond`
-- `geyser`
-- `hot_spring`
-- `lagoon`
-- `lake`
-- `moat`
-- `ocean`
-- `oxbow`
-- `pond`
-- `reflecting_pool`
-- `reservoir`
-- `river`
-- `salt_pond`
-- `sea`
-- `sewage`
-- `shoal`
-- `spring`
-- `strait`
-- `stream`
-- `swimming_pool`
-- `tidal_channel`
-- `wastewater`
-- `water`
-- `water_storage`
-- `waterfall`
-
-## Used By
-
-- [`Water`](../water.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/types/water_subtype.md b/schema_versioned_docs/version-v1.17.0/reference/base/types/water_subtype.md
deleted file mode 100644
index 987dc1af3..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/types/water_subtype.md
+++ /dev/null
@@ -1,24 +0,0 @@
-# WaterSubtype
-
-The broad classification of water body such as river, ocean or lake.
-
-This broad classification can be refined using `WaterClass`.
-
-## Values
-
-- `canal`
-- `human_made`
-- `lake`
-- `ocean`
-- `physical`
-- `pond`
-- `reservoir`
-- `river`
-- `spring`
-- `stream`
-- `wastewater`
-- `water`
-
-## Used By
-
-- [`Water`](../water.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/base/water.md b/schema_versioned_docs/version-v1.17.0/reference/base/water.md
deleted file mode 100644
index 7d02c6007..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/base/water.md
+++ /dev/null
@@ -1,98 +0,0 @@
----
-sidebar_position: 1
----
-
-# Water
-
-Water features represent ocean and inland water bodies.
-
-In Overture data releases, water features are sourced from OpenStreetMap. There are two main
-categories of water feature: ocean and inland water bodies.
-
-Ocean
------
-The `subytpe` value `"ocean"` indicates an ocean area feature whose geometry represents the
-surface area of an ocean or part of an ocean. Ocean area may be tiled into many small polygons
-of consistent complexity to ensure manageable geometry. In Overture data releases, ocean area
-features are created from OpenStreetMap coastlines data (`natural=coastline`) using a QA'd
-version of the output from the OSMCoastline tool. In aggregate, all the ocean area features
-represent the inverse of the land features with subtype `"land"` and class `"land"`.
-
-The names and recommended label position for oceans and seas can be found in features with the
-subtype `"physical"` and the class `"ocean"` or `"sea"`.
-
-Inland Water
-------------
-Subtypes other than `"ocean"` (and `"physical"`) represent inland water bodies. In Overture data
-releases, these features are sourced from the OpenStreetMap tag `natural=*` where the tag value
-indicates a water body, as well as the tags `natural=water`,  `waterway=*`,
-and `water=*`.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
-| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
-| `geometry` | [`geometry`](../system/primitive/geometry.md) | Geometry of the water feature, which may be a point, line string, polygon, or multi-polygon.<br/><br/>*Allowed geometry types: LineString, MultiPolygon, Point, Polygon* |
-| `theme` | `"base"` | |
-| `type` | `"water"` | |
-| `version` | [`FeatureVersion`](../common/feature_version.md) | |
-| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
-| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
-| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
-| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
-| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
-| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
-| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
-| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
-| `class` | [`WaterClass`](types/water_class.md) (optional) | |
-| `subtype` | [`WaterSubtype`](types/water_subtype.md) (optional) | |
-| `is_intermittent` | `boolean` (optional) | Whether the water body exists intermittently, not permanently<br/><br/>*`strict=True`* |
-| `is_salt` | `boolean` (optional) | Whether the water body contains salt water<br/><br/>*`strict=True`* |
-| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level |
-| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
-| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
-| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
-| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
-| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
-| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
-| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
-| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
-| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
-| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
-| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
-| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
-| `source_tags` | [`SourceTags`](types/source_tags.md) (map, optional) | Key/value pairs imported directly from the source data without change.<br/><br/>This field provides access to raw OSM entity tags for features sourced from OpenStreetMap. |
-| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
-
-## Examples
-
-| Column | Value |
-| -------: | ------- |
-| `id` | `6bbb5fe5-bf26-3efa-b120-0a7079b60840` |
-| `bbox.xmin` | `-177.03179931640625` |
-| `bbox.ymin` | `-84.93480682373047` |
-| `bbox.xmax` | `-177.0317840576172` |
-| `bbox.ymax` | `-84.9347915649414` |
-| `geometry` | `POINT (-177.031799 -84.934793)` |
-| `theme` | `base` |
-| `type` | `water` |
-| `version` | `0` |
-| `sources[0].property` |  |
-| `sources[0].dataset` | `OpenStreetMap` |
-| `sources[0].license` | `null` |
-| `sources[0].record_id` | `n11109190647@2` |
-| `sources[0].update_time` | `2024-02-11T05:52:05+00:00` |
-| `sources[0].confidence` | `null` |
-| `sources[0].between` | `null` |
-| `class` | `cape` |
-| `subtype` | `physical` |
-| `is_intermittent` | `null` |
-| `is_salt` | `null` |
-| `level` | `0` |
-| `names.primary` | `Thanksgiving Point` |
-| `names.common` | `null` |
-| `names.rules` | `null` |
-| `source_tags` | `{"natural": "cape", "ref:linz:place_id": "13433"}` |
-| `wikidata` | `Q33140589` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/buildings/_category_.json
deleted file mode 100644
index 3e85a3e78..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/buildings/_category_.json
+++ /dev/null
@@ -1,4 +0,0 @@
-{
-  "label": "Buildings",
-  "position": 3
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/building.md b/schema_versioned_docs/version-v1.17.0/reference/buildings/building.md
deleted file mode 100644
index 2e0b63e35..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/buildings/building.md
+++ /dev/null
@@ -1,102 +0,0 @@
----
-sidebar_position: 1
----
-
-# Building
-
-Buildings are man-made structures with roofs that exist permanently in one place.
-
-A building's geometry represents the two-dimensional footprint of the building as viewed from
-directly above, looking down. Fields such as `height` and `num_floors` allow the
-three-dimensional shape to be approximated. Some buildings, identified by the `has_parts` field,
-have associated `BuildingPart` features which can be used to generate a more representative 3D
-model of the building.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
-| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
-| `geometry` | [`geometry`](../system/primitive/geometry.md) | The building's footprint or roofprint (if traced from aerial/satellite imagery).<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
-| `theme` | `"buildings"` | |
-| `type` | `"building"` | |
-| `version` | [`FeatureVersion`](../common/feature_version.md) | |
-| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
-| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
-| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
-| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
-| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
-| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
-| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
-| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
-| `subtype` | [`BuildingSubtype`](types/building_subtype.md) (optional) | A broad classification of the current use and purpose of the building.<br/><br/>If the current use of the building no longer accords with the original built purpose, the current use should be specified. For example, a building built as a train station but later converted into a shopping mall would have the value `"commercial"` rather than `"transportation"`. |
-| `class` | [`BuildingClass`](types/building_class.md) (optional) | A more specific classification of the current use and purpose of the building.<br/><br/>If the current use of the building no longer accords with the original built purpose, the current use should be specified. |
-| `has_parts` | `boolean` (optional) | Whether the building has associated building part features<br/><br/>*`strict=True`* |
-| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
-| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
-| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
-| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
-| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
-| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
-| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
-| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
-| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
-| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
-| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
-| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
-| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level |
-| `height` | [`float64`](../system/primitive/primitives.md) (optional) | Height of the building or part in meters.<br/><br/>This is the distance from the lowest point to the highest point.<br/><br/>*`> 0`* |
-| `is_underground` | `boolean` (optional) | Whether the entire building or part is completely below ground.<br/><br/>The underground flag is useful for display purposes. Buildings and building parts that are entirely below ground can be styled differently or omitted from the rendered image.<br/><br/>This flag is conceptually different from the `level` field, which indicates relative z-ordering and, notably, can be negative even if the building is entirely above-ground.<br/><br/>*`strict=True`* |
-| `num_floors` | [`int32`](../system/primitive/primitives.md) (optional) | Number of above-ground floors of the building or part.<br/><br/>*`> 0`* |
-| `num_floors_underground` | [`int32`](../system/primitive/primitives.md) (optional) | Number of below-ground floors of the building or part.<br/><br/>*`> 0`* |
-| `min_height` | [`float64`](../system/primitive/primitives.md) (optional) | Altitude above ground where the bottom of the building or building part starts.<br/><br/>If present, this value indicates that the lowest part of the building or building part starts is above ground level. |
-| `min_floor` | [`int32`](../system/primitive/primitives.md) (optional) | Start floor of this building or part.<br/><br/>If present, this value indicates that the building or part is "floating" and its bottom-most floor is above ground level, usually because it is part of a larger building in which some parts do reach down to ground level. An example is a building that has an entry road or driveway at ground level into an interior courtyard, where part of the building bridges above the entry road. This property may sometimes be populated when `min_height` is missing and in these cases can be used as a proxy for `min_height`.<br/><br/>*`> 0`* |
-| `facade_color` | [`HexColor`](../system/hex_color.md) (optional) | Facade color in `#rgb` or `#rrggbb` hex notation |
-| `facade_material` | [`FacadeMaterial`](types/facade_material.md) (optional) | Outer surface material of the facade |
-| `roof_material` | [`RoofMaterial`](types/roof_material.md) (optional) | Outer surface material of the roof |
-| `roof_shape` | [`RoofShape`](types/roof_shape.md) (optional) | Shape of the roof |
-| `roof_direction` | [`float64`](../system/primitive/primitives.md) (optional) | Bearing of the roof ridge line in degrees<br/><br/>*`≥ 0`*<br/>*`< 360`* |
-| `roof_orientation` | [`RoofOrientation`](types/roof_orientation.md) (optional) | Orientation of the roof shape relative to the footprint shape |
-| `roof_color` | [`HexColor`](../system/hex_color.md) (optional) | The roof color in `#rgb` or `#rrggbb` hex notation |
-| `roof_height` | [`float64`](../system/primitive/primitives.md) (optional) | Height of the roof in meters.<br/><br/>This is the distance from the base of the roof to its highest point. |
-
-## Examples
-
-| Column | Value |
-| -------: | ------- |
-| `id` | `148f35b1-7bc1-4180-9280-10d39b13883b` |
-| `bbox.xmin` | `-176.643798828125` |
-| `bbox.ymin` | `-43.9938850402832` |
-| `bbox.xmax` | `-176.64349365234375` |
-| `bbox.ymax` | `-43.993709564208984` |
-| `geometry` | `POLYGON ((-176.6435004 -43.9938042, -176.6435738 -43.9937107, -176.6437726 -43.9937913, -176.6436...` |
-| `theme` | `buildings` |
-| `type` | `building` |
-| `version` | `1` |
-| `sources[0].property` |  |
-| `sources[0].dataset` | `OpenStreetMap` |
-| `sources[0].license` | `null` |
-| `sources[0].record_id` | `w519166507@1` |
-| `sources[0].update_time` | `2017-08-27T21:39:50+00:00` |
-| `sources[0].confidence` | `null` |
-| `sources[0].between` | `null` |
-| `subtype` | `null` |
-| `class` | `null` |
-| `has_parts` | `false` |
-| `names` | `null` |
-| `level` | `0` |
-| `height` | `null` |
-| `is_underground` | `false` |
-| `num_floors` | `null` |
-| `num_floors_underground` | `null` |
-| `min_height` | `null` |
-| `min_floor` | `null` |
-| `facade_color` | `null` |
-| `facade_material` | `null` |
-| `roof_material` | `null` |
-| `roof_shape` | `null` |
-| `roof_direction` | `null` |
-| `roof_orientation` | `null` |
-| `roof_color` | `null` |
-| `roof_height` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/building_part.md b/schema_versioned_docs/version-v1.17.0/reference/buildings/building_part.md
deleted file mode 100644
index 845670209..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/buildings/building_part.md
+++ /dev/null
@@ -1,101 +0,0 @@
----
-sidebar_position: 1
----
-
-# BuildingPart
-
-Building parts represent parts of larger building features. They allow buildings to be modeled
-in rich detail suitable for creating realistic 3D models.
-
-Every building part is associated with a parent `Building` feature via the `building_id` field.
-In addition, a building part has a footprint geometry and may include additional details such as
-its height, the number of floors, and the color and material of its facade and roof.
-
-Building parts can float or be stacked on top of each other. The `min_height`, `min_floor`,
-`height`, and `num_floors`, fields can be used to arrange the parts correctly along the
-vertical dimension.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
-| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
-| `geometry` | [`geometry`](../system/primitive/geometry.md) | The footprint or roofprint of the building part.<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
-| `theme` | `"buildings"` | |
-| `type` | `"building_part"` | |
-| `version` | [`FeatureVersion`](../common/feature_version.md) | |
-| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
-| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
-| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
-| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
-| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
-| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
-| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
-| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
-| `building_id` | [`Id`](../system/ref/id.md) | The building to which this part belongs<br/><br/>*References [`Building`](building.md) (composition, part of)* |
-| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
-| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
-| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
-| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
-| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
-| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
-| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
-| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
-| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
-| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
-| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
-| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
-| `level` | [`Level`](../common/level.md) (optional) | Z-order of the feature where 0 is visual level |
-| `height` | [`float64`](../system/primitive/primitives.md) (optional) | Height of the building or part in meters.<br/><br/>This is the distance from the lowest point to the highest point.<br/><br/>*`> 0`* |
-| `is_underground` | `boolean` (optional) | Whether the entire building or part is completely below ground.<br/><br/>The underground flag is useful for display purposes. Buildings and building parts that are entirely below ground can be styled differently or omitted from the rendered image.<br/><br/>This flag is conceptually different from the `level` field, which indicates relative z-ordering and, notably, can be negative even if the building is entirely above-ground.<br/><br/>*`strict=True`* |
-| `num_floors` | [`int32`](../system/primitive/primitives.md) (optional) | Number of above-ground floors of the building or part.<br/><br/>*`> 0`* |
-| `num_floors_underground` | [`int32`](../system/primitive/primitives.md) (optional) | Number of below-ground floors of the building or part.<br/><br/>*`> 0`* |
-| `min_height` | [`float64`](../system/primitive/primitives.md) (optional) | Altitude above ground where the bottom of the building or building part starts.<br/><br/>If present, this value indicates that the lowest part of the building or building part starts is above ground level. |
-| `min_floor` | [`int32`](../system/primitive/primitives.md) (optional) | Start floor of this building or part.<br/><br/>If present, this value indicates that the building or part is "floating" and its bottom-most floor is above ground level, usually because it is part of a larger building in which some parts do reach down to ground level. An example is a building that has an entry road or driveway at ground level into an interior courtyard, where part of the building bridges above the entry road. This property may sometimes be populated when `min_height` is missing and in these cases can be used as a proxy for `min_height`.<br/><br/>*`> 0`* |
-| `facade_color` | [`HexColor`](../system/hex_color.md) (optional) | Facade color in `#rgb` or `#rrggbb` hex notation |
-| `facade_material` | [`FacadeMaterial`](types/facade_material.md) (optional) | Outer surface material of the facade |
-| `roof_material` | [`RoofMaterial`](types/roof_material.md) (optional) | Outer surface material of the roof |
-| `roof_shape` | [`RoofShape`](types/roof_shape.md) (optional) | Shape of the roof |
-| `roof_direction` | [`float64`](../system/primitive/primitives.md) (optional) | Bearing of the roof ridge line in degrees<br/><br/>*`≥ 0`*<br/>*`< 360`* |
-| `roof_orientation` | [`RoofOrientation`](types/roof_orientation.md) (optional) | Orientation of the roof shape relative to the footprint shape |
-| `roof_color` | [`HexColor`](../system/hex_color.md) (optional) | The roof color in `#rgb` or `#rrggbb` hex notation |
-| `roof_height` | [`float64`](../system/primitive/primitives.md) (optional) | Height of the roof in meters.<br/><br/>This is the distance from the base of the roof to its highest point. |
-
-## Examples
-
-| Column | Value |
-| -------: | ------- |
-| `id` | `19412d64-51ac-3d6a-ac2f-8a8c8b91bb60` |
-| `bbox.xmin` | `-73.24630737304688` |
-| `bbox.ymin` | `-39.81101608276367` |
-| `bbox.xmax` | `-73.24613952636719` |
-| `bbox.ymax` | `-39.81088638305664` |
-| `geometry` | `POLYGON ((-73.2462509 -39.8108937, -73.2462755 -39.8109047, -73.246291 -39.8109182, -73.2463022 -...` |
-| `theme` | `buildings` |
-| `type` | `building_part` |
-| `version` | `0` |
-| `sources[0].property` |  |
-| `sources[0].dataset` | `OpenStreetMap` |
-| `sources[0].license` | `null` |
-| `sources[0].record_id` | `w223076787@2` |
-| `sources[0].update_time` | `2014-10-31T22:55:36+00:00` |
-| `sources[0].confidence` | `null` |
-| `sources[0].between` | `null` |
-| `building_id` | `bd663bd4-1844-4d7d-a400-114de051cf49` |
-| `names` | `null` |
-| `level` | `3` |
-| `height` | `null` |
-| `is_underground` | `false` |
-| `num_floors` | `null` |
-| `num_floors_underground` | `null` |
-| `min_height` | `null` |
-| `min_floor` | `null` |
-| `facade_color` | `null` |
-| `facade_material` | `null` |
-| `roof_material` | `null` |
-| `roof_shape` | `null` |
-| `roof_direction` | `null` |
-| `roof_orientation` | `null` |
-| `roof_color` | `null` |
-| `roof_height` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/_category_.json
deleted file mode 100644
index a3ec08974..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/_category_.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-  "label": "Types"
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/building_class.md b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/building_class.md
deleted file mode 100644
index 7cdc52c0a..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/building_class.md
+++ /dev/null
@@ -1,99 +0,0 @@
-# BuildingClass
-
-Further classification of the type and purpose of a building.
-
-The building class adds detail to the broad classification of `BuildingSubtype`.
-
-## Values
-
-- `agricultural`
-- `allotment_house`
-- `apartments`
-- `barn`
-- `beach_hut`
-- `boathouse`
-- `bridge_structure`
-- `bungalow`
-- `bunker`
-- `cabin`
-- `carport`
-- `cathedral`
-- `chapel`
-- `church`
-- `civic`
-- `college`
-- `commercial`
-- `cowshed`
-- `detached`
-- `digester`
-- `dormitory`
-- `dwelling_house`
-- `factory`
-- `farm`
-- `farm_auxiliary`
-- `fire_station`
-- `garage`
-- `garages`
-- `ger`
-- `glasshouse`
-- `government`
-- `grandstand`
-- `greenhouse`
-- `guardhouse`
-- `hangar`
-- `hospital`
-- `hotel`
-- `house`
-- `houseboat`
-- `hut`
-- `industrial`
-- `kindergarten`
-- `kiosk`
-- `library`
-- `manufacture`
-- `military`
-- `monastery`
-- `mosque`
-- `office`
-- `outbuilding`
-- `parking`
-- `pavilion`
-- `post_office`
-- `presbytery`
-- `public`
-- `religious`
-- `residential`
-- `retail`
-- `roof`
-- `school`
-- `semi`
-- `semidetached_house`
-- `service`
-- `shed`
-- `shrine`
-- `silo`
-- `slurry_tank`
-- `sports_centre`
-- `sports_hall`
-- `stable`
-- `stadium`
-- `static_caravan`
-- `stilt_house`
-- `storage_tank`
-- `sty`
-- `supermarket`
-- `synagogue`
-- `temple`
-- `terrace`
-- `toilets`
-- `train_station`
-- `transformer_tower`
-- `transportation`
-- `trullo`
-- `university`
-- `warehouse`
-- `wayside_shrine`
-
-## Used By
-
-- [`Building`](../building.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/building_subtype.md b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/building_subtype.md
deleted file mode 100644
index 7069cf95e..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/building_subtype.md
+++ /dev/null
@@ -1,25 +0,0 @@
-# BuildingSubtype
-
-Broadest classification of the type and purpose of a building.
-
-This broad classification can be refined by `BuildingClass`.
-
-## Values
-
-- `agricultural`
-- `civic`
-- `commercial`
-- `education`
-- `entertainment`
-- `industrial`
-- `medical`
-- `military`
-- `outbuilding`
-- `religious`
-- `residential`
-- `service`
-- `transportation`
-
-## Used By
-
-- [`Building`](../building.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/facade_material.md b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/facade_material.md
deleted file mode 100644
index 13a5a8c41..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/facade_material.md
+++ /dev/null
@@ -1,22 +0,0 @@
-# FacadeMaterial
-
-The outer surface material of building facade.
-
-## Values
-
-- `brick`
-- `cement_block`
-- `clay`
-- `concrete`
-- `glass`
-- `metal`
-- `plaster`
-- `plastic`
-- `stone`
-- `timber_framing`
-- `wood`
-
-## Used By
-
-- [`Building`](../building.md)
-- [`BuildingPart`](../building_part.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_material.md b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_material.md
deleted file mode 100644
index 1efc1f022..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_material.md
+++ /dev/null
@@ -1,25 +0,0 @@
-# RoofMaterial
-
-The outermost material of the roof.
-
-## Values
-
-- `concrete`
-- `copper`
-- `eternit`
-- `glass`
-- `grass`
-- `gravel`
-- `metal`
-- `plastic`
-- `roof_tiles`
-- `slate`
-- `solar_panels`
-- `tar_paper`
-- `thatch`
-- `wood`
-
-## Used By
-
-- [`Building`](../building.md)
-- [`BuildingPart`](../building_part.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_orientation.md b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_orientation.md
deleted file mode 100644
index 443af22a2..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_orientation.md
+++ /dev/null
@@ -1,16 +0,0 @@
-# RoofOrientation
-
-Orientation of the roof shape relative to the footprint shape.
-
-The members of this enumeration, `"across"` and `"along"`, are borrowed from the OpenStreetMap
-`roof:orientation=*` tag and have the same meanings as they do in OSM.
-
-## Values
-
-- `across` - The roof ridge runs perpendicular to the longer of the two building edges, parallel to the shorter
-- `along` - The roof ridge runs parallel to the longer of the two building edges
-
-## Used By
-
-- [`Building`](../building.md)
-- [`BuildingPart`](../building_part.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_shape.md b/schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_shape.md
deleted file mode 100644
index f1271e095..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/buildings/types/roof_shape.md
+++ /dev/null
@@ -1,25 +0,0 @@
-# RoofShape
-
-The shape of the roof.
-
-## Values
-
-- `dome`
-- `flat`
-- `gabled`
-- `gambrel`
-- `half_hipped`
-- `hipped`
-- `mansard`
-- `onion`
-- `pyramidal`
-- `round`
-- `saltbox`
-- `sawtooth`
-- `skillion`
-- `spherical`
-
-## Used By
-
-- [`Building`](../building.md)
-- [`BuildingPart`](../building_part.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/common/_category_.json
deleted file mode 100644
index 44fea45e2..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/_category_.json
+++ /dev/null
@@ -1,4 +0,0 @@
-{
-  "label": "Common",
-  "position": 7
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/cartographic_hints.md b/schema_versioned_docs/version-v1.17.0/reference/common/cartographic_hints.md
deleted file mode 100644
index 33c58438b..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/cartographic_hints.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# CartographicHints
-
-Cartographic hints for optimal use of Overture features in map-making.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `prominence` | [`Prominence`](prominence.md) (optional) | Subjective scale of feature significance or importance, with 1 being the least, and 100 being the most, significant.<br/><br/>This value can be used to help drive decisions about how and when to display a feature, and how to treat it relative to neighboring features.<br/><br/>When populated by Overture, this value is derived from various factors including, but not limited to: feature and subtype, population, and capital status. |
-| `min_zoom` | [`MinZoom`](min_zoom.md) (optional) | Recommended minimum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels below this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
-| `max_zoom` | [`MaxZoom`](max_zoom.md) (optional) | Recommended maximum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels above this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
-| `sort_key` | [`SortKey`](sort_key.md) (optional) | Integer indicating the recommended order in which to draw features.<br/><br/>Features with a lower number should be drawn "in front" of features with a higher number. |
-
-## Used By
-
-- [`Bathymetry`](../base/bathymetry.md)
-- [`Division`](../divisions/division.md)
-- [`LandCover`](../base/land_cover.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/common_names.md b/schema_versioned_docs/version-v1.17.0/reference/common/common_names.md
deleted file mode 100644
index 2d1950d78..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/common_names.md
+++ /dev/null
@@ -1,10 +0,0 @@
-# CommonNames
-
-A mapping from language to the most commonly used or recognized name in that language.
-
-Underlying type: `map<`[`LanguageTag`](../system/language_tag.md)`,`[`StrippedString`](../system/stripped_string.md)`>`
-
-## Used By
-
-- [`Division`](../divisions/division.md)
-- [`Names`](names.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/confidence_score.md b/schema_versioned_docs/version-v1.17.0/reference/common/confidence_score.md
deleted file mode 100644
index 42256524e..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/confidence_score.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# ConfidenceScore
-
-Confidence score between 0.0 and 1.0
-
-Underlying type: `float64`
-
-## Constraints
-
-- `≥ 0.0`
-- `≤ 1.0`
-
-## Used By
-
-- [`Place`](../places/place.md)
-- [`SourceItem`](source_item.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/feature_version.md b/schema_versioned_docs/version-v1.17.0/reference/common/feature_version.md
deleted file mode 100644
index 969394483..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/feature_version.md
+++ /dev/null
@@ -1,27 +0,0 @@
-# FeatureVersion
-
-Underlying type: `int32`
-
-## Constraints
-
-- `≥ 0`
-- `≥ -2147483648` (from [`int32`](../system/primitive/primitives.md))
-- `≤ 2147483647` (from [`int32`](../system/primitive/primitives.md))
-
-## Used By
-
-- [`Address`](../addresses/address.md)
-- [`Bathymetry`](../base/bathymetry.md)
-- [`Building`](../buildings/building.md)
-- [`BuildingPart`](../buildings/building_part.md)
-- [`Connector`](../transportation/connector.md)
-- [`Division`](../divisions/division.md)
-- [`DivisionArea`](../divisions/division_area.md)
-- [`DivisionBoundary`](../divisions/division_boundary.md)
-- [`Infrastructure`](../base/infrastructure.md)
-- [`Land`](../base/land.md)
-- [`LandCover`](../base/land_cover.md)
-- [`LandUse`](../base/land_use.md)
-- [`Place`](../places/place.md)
-- [`Segment`](../transportation/segment.md)
-- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/length_unit.md b/schema_versioned_docs/version-v1.17.0/reference/common/length_unit.md
deleted file mode 100644
index 44750a380..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/length_unit.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# LengthUnit
-
-Unit of length.
-
-## Values
-
-- `in` - One inch in the imperial and US customary systems
-- `ft` - One foot in the imperial and US customary systems (12 inches)
-- `yd` - One yard in the imperial and US customary systems (three feet)
-- `mi` - One mile in the imperial and US customary systems (1,760 yards)
-- `cm` - One centimeter in the metric and SI systems
-- `m` - One meter in the metric and SI systems
-- `km` - One kilometer in the metric and SI systems
-
-## Used By
-
-- [`VehicleHeightSelector`](scoping/vehicle_height_selector.md)
-- [`VehicleLengthSelector`](scoping/vehicle_length_selector.md)
-- [`VehicleWidthSelector`](scoping/vehicle_width_selector.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/level.md b/schema_versioned_docs/version-v1.17.0/reference/common/level.md
deleted file mode 100644
index dff9ca8a0..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/level.md
+++ /dev/null
@@ -1,20 +0,0 @@
-# Level
-
-Z-order of the feature where 0 is visual level
-
-Underlying type: `int32`
-
-## Constraints
-
-- `≥ -2147483648` (from [`int32`](../system/primitive/primitives.md))
-- `≤ 2147483647` (from [`int32`](../system/primitive/primitives.md))
-
-## Used By
-
-- [`Building`](../buildings/building.md)
-- [`BuildingPart`](../buildings/building_part.md)
-- [`Infrastructure`](../base/infrastructure.md)
-- [`Land`](../base/land.md)
-- [`LandUse`](../base/land_use.md)
-- [`LevelRule`](../transportation/types/level_rule.md)
-- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/max_zoom.md b/schema_versioned_docs/version-v1.17.0/reference/common/max_zoom.md
deleted file mode 100644
index 6f06fba07..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/max_zoom.md
+++ /dev/null
@@ -1,23 +0,0 @@
-# MaxZoom
-
-Recommended maximum tile zoom level in which this feature should be displayed.
-
-It is recommended that the feature be hidden at zoom levels above this value.
-
-Zoom levels follow the Slippy Maps convention, documented in the following
-references:
-- [https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames](https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames)
-- [https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection](https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection)
-
-Underlying type: `int32`
-
-## Constraints
-
-- `≥ 0`
-- `≤ 23`
-- `≥ -2147483648` (from [`int32`](../system/primitive/primitives.md))
-- `≤ 2147483647` (from [`int32`](../system/primitive/primitives.md))
-
-## Used By
-
-- [`CartographicHints`](cartographic_hints.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/min_zoom.md b/schema_versioned_docs/version-v1.17.0/reference/common/min_zoom.md
deleted file mode 100644
index f309c1e03..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/min_zoom.md
+++ /dev/null
@@ -1,23 +0,0 @@
-# MinZoom
-
-Recommended minimum tile zoom level in which this feature should be displayed.
-
-It is recommended that the feature be hidden at zoom levels below this value.
-
-Zoom levels follow the Slippy Maps convention, documented in the following
-references:
-- [https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames](https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames)
-- [https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection](https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection)
-
-Underlying type: `int32`
-
-## Constraints
-
-- `≥ 0`
-- `≤ 23`
-- `≥ -2147483648` (from [`int32`](../system/primitive/primitives.md))
-- `≤ 2147483647` (from [`int32`](../system/primitive/primitives.md))
-
-## Used By
-
-- [`CartographicHints`](cartographic_hints.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/name_rule.md b/schema_versioned_docs/version-v1.17.0/reference/common/name_rule.md
deleted file mode 100644
index 4b1c0308b..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/name_rule.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# NameRule
-
-A rule that can be evaluated to determine the name in advanced scenarios.
-
-Name rules are used for cases where the primary name is not sufficient; the common name is not
-the right fit for the use case and another variant is needed; or where the name only applies in
-certain specific circumstances.
-
-Examples might include:
-- An official, alternate, or short name.
-- A name that only applies to part of a linear path like a road segment (geometric range
-  scoping).
-- A name that only applies to the left or right side of a linear path like a road segment (side
-  scoping).
-- A name that is only accepted by some political perspectives.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `value` | [`StrippedString`](../system/stripped_string.md) | The actual name value.<br/><br/>*Minimum length: 1* |
-| `variant` | [`NameVariant`](name_variant.md) | The name variant for this name rule. |
-| `language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
-| `perspectives` | [`Perspectives`](perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
-| `perspectives.mode` | [`PerspectiveMode`](perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
-| `perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
-| `between` | [`LinearlyReferencedRange`](scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
-| `side` | [`Side`](scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
-
-## Used By
-
-- [`Names`](names.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/name_variant.md b/schema_versioned_docs/version-v1.17.0/reference/common/name_variant.md
deleted file mode 100644
index ea9fa475c..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/name_variant.md
+++ /dev/null
@@ -1,22 +0,0 @@
-# NameVariant
-
-Name variant used in a `NameRule`.
-
-## Values
-
-- `common` - The most commonly used or recognized name for a feature in the specified language.
-
-In a `Names` value, most common names will appear in the `Names.common` field and will
-not need to be specified as `NameRule` values in `Names.rules`. This member of the
-enumeration should only be used to construct a `NameRule` if the common name needs to
-be scoped in some way and therefore cannot be accurately represented in `CommonNames`.
-- `official` - The legally or administratively recognized name, often used by government agencies or
-official documents.
-- `alternate` - An alternative name, which may be a historical name, a local colloquial name, or some
-other well-known name is not the common name.
-- `short` - An abbreviated or shortened version of the name, which may be an acronym or some other
-commonly-used short form. An example is "NYC" for New York City.
-
-## Used By
-
-- [`NameRule`](name_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/names.md b/schema_versioned_docs/version-v1.17.0/reference/common/names.md
deleted file mode 100644
index 220658c59..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/names.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# Names
-
-Multilingual names container.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name.<br/><br/>*Minimum length: 1* |
-| `common` | [`CommonNames`](common_names.md) (map, optional) | |
-| `rules[]` | `list<`[`NameRule`](name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
-| `rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
-| `rules[].variant` | [`NameVariant`](name_variant.md) | The name variant for this name rule. |
-| `rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
-| `rules[].perspectives` | [`Perspectives`](perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
-| `rules[].perspectives.mode` | [`PerspectiveMode`](perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
-| `rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
-| `rules[].between` | [`LinearlyReferencedRange`](scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
-| `rules[].side` | [`Side`](scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
-
-## Used By
-
-- [`Brand`](../places/types/brand.md)
-- [`Building`](../buildings/building.md)
-- [`BuildingPart`](../buildings/building_part.md)
-- [`Division`](../divisions/division.md)
-- [`DivisionArea`](../divisions/division_area.md)
-- [`Infrastructure`](../base/infrastructure.md)
-- [`Land`](../base/land.md)
-- [`LandUse`](../base/land_use.md)
-- [`Place`](../places/place.md)
-- [`Segment`](../transportation/segment.md)
-- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/perspective_mode.md b/schema_versioned_docs/version-v1.17.0/reference/common/perspective_mode.md
deleted file mode 100644
index af2f597ff..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/perspective_mode.md
+++ /dev/null
@@ -1,12 +0,0 @@
-# PerspectiveMode
-
-Perspective mode for disputed names.
-
-## Values
-
-- `accepted_by`
-- `disputed_by`
-
-## Used By
-
-- [`Perspectives`](perspectives.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/perspectives.md b/schema_versioned_docs/version-v1.17.0/reference/common/perspectives.md
deleted file mode 100644
index b5e634d91..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/perspectives.md
+++ /dev/null
@@ -1,16 +0,0 @@
-# Perspectives
-
-Political perspectives container.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `mode` | [`PerspectiveMode`](perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
-| `countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
-
-## Used By
-
-- [`Division`](../divisions/division.md)
-- [`DivisionBoundary`](../divisions/division_boundary.md)
-- [`NameRule`](name_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/prominence.md b/schema_versioned_docs/version-v1.17.0/reference/common/prominence.md
deleted file mode 100644
index 524ec9790..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/prominence.md
+++ /dev/null
@@ -1,23 +0,0 @@
-# Prominence
-
-Subjective scale of feature significance or importance, with 1 being the least, and
-100 being the most, significant.
-
-This value can be used to help drive decisions about how and when to display a
-feature, and how to treat it relative to neighboring features.
-
-When populated by Overture, this value is derived from various factors including,
-but not limited to: feature and subtype, population, and capital status.
-
-Underlying type: `int32`
-
-## Constraints
-
-- `≥ 1`
-- `≤ 100`
-- `≥ -2147483648` (from [`int32`](../system/primitive/primitives.md))
-- `≤ 2147483647` (from [`int32`](../system/primitive/primitives.md))
-
-## Used By
-
-- [`CartographicHints`](cartographic_hints.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/_category_.json
deleted file mode 100644
index 155d669bb..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/_category_.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-  "label": "Scoping"
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/heading.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/heading.md
deleted file mode 100644
index e59a4600d..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/heading.md
+++ /dev/null
@@ -1,17 +0,0 @@
-# Heading
-
-Travel direction along an oriented path: forward or backward.
-
-## Values
-
-- `forward`
-- `backward`
-
-## Used By
-
-- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
-- [`DestinationRule`](../../transportation/types/destination_rule.md)
-- [`DestinationRule.When`](../../transportation/types/destination_rule.when.md)
-- [`ProhibitedTransitionRule`](../../transportation/types/prohibited_transition_rule.md)
-- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
-- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/linearly_referenced_position.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/linearly_referenced_position.md
deleted file mode 100644
index 605af6ee2..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/linearly_referenced_position.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# LinearlyReferencedPosition
-
-Represents a linearly-referenced position between 0% and 100% of the distance along a path such as a road segment or a river center-line segment.
-
-Underlying type: `float64`
-
-## Constraints
-
-- `≥ 0.0`
-- `≤ 1.0`
-
-## Used By
-
-- [`ConnectorReference`](../../transportation/types/connector_reference.md)
-- [`LinearlyReferencedRange`](linearly_referenced_range.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/linearly_referenced_range.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/linearly_referenced_range.md
deleted file mode 100644
index b08f04917..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/linearly_referenced_range.md
+++ /dev/null
@@ -1,26 +0,0 @@
-# LinearlyReferencedRange
-
-Represents a non-empty range of positions along a path as a pair linearly-referenced positions. For example, the pair [0.25, 0.5] represents the range beginning 25% of the distance from the start of the path and ending 50% of the distance from the path
-
-Underlying type: `list<float64>`
-
-## Constraints
-
-- Linear reference range constraint (0.0 to 1.0). (`LinearReferenceRangeConstraint`)
-- `≥ 0.0` (from [`LinearlyReferencedPosition`](linearly_referenced_position.md))
-- `≤ 1.0` (from [`LinearlyReferencedPosition`](linearly_referenced_position.md))
-
-## Used By
-
-- [`AccessRestrictionRule`](../../transportation/types/access_restriction_rule.md)
-- [`LevelRule`](../../transportation/types/level_rule.md)
-- [`NameRule`](../name_rule.md)
-- [`ProhibitedTransitionRule`](../../transportation/types/prohibited_transition_rule.md)
-- [`RailFlagRule`](../../transportation/types/rail_flag_rule.md)
-- [`RoadFlagRule`](../../transportation/types/road_flag_rule.md)
-- [`RouteReference`](../../transportation/types/route_reference.md)
-- [`SourceItem`](../source_item.md)
-- [`SpeedLimitRule`](../../transportation/types/speed_limit_rule.md)
-- [`SubclassRule`](../../transportation/types/subclass_rule.md)
-- [`SurfaceRule`](../../transportation/types/surface_rule.md)
-- [`WidthRule`](../../transportation/types/width_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/opening_hours.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/opening_hours.md
deleted file mode 100644
index da30697ee..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/opening_hours.md
+++ /dev/null
@@ -1,12 +0,0 @@
-# OpeningHours
-
-Time span or time spans during which something is open or active, specified in the OpenStreetMap
-opening hours specification: [https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification](https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification).
-
-Underlying type: `string`
-
-## Used By
-
-- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
-- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
-- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/purpose_of_use.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/purpose_of_use.md
deleted file mode 100644
index a91e74f92..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/purpose_of_use.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# PurposeOfUse
-
-Reason why a person or entity travelling on the transportation network is using a particular
-location.
-
-## Values
-
-- `as_customer`
-- `at_destination`
-- `to_deliver`
-- `to_farm`
-- `for_forestry`
-
-## Used By
-
-- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
-- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
-- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/recognized_status.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/recognized_status.md
deleted file mode 100644
index 52ce0c78c..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/recognized_status.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# RecognizedStatus
-
-Status of the person or entity travelling as recognized by authorities controlling the particular
-location.
-
-## Values
-
-- `as_permitted`
-- `as_private`
-- `as_disabled`
-- `as_employee`
-- `as_student`
-
-## Used By
-
-- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
-- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
-- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/side.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/side.md
deleted file mode 100644
index e8a269ef7..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/side.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# Side
-
-The side, left or right, on which something appears relative to a facing or heading direction
-(*e.g.*, the side of a road relative to the road orientation), or relative to the direction of
-travel of a person or vehicle.
-
-## Values
-
-- `left` - On the left relative to the facing direction
-- `right` - On the right side relative to the facing direction
-
-## Used By
-
-- [`NameRule`](../name_rule.md)
-- [`Norms`](../../divisions/types/norms.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/travel_mode.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/travel_mode.md
deleted file mode 100644
index 1a2aa0b55..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/travel_mode.md
+++ /dev/null
@@ -1,25 +0,0 @@
-# TravelMode
-
-Enumerates possible travel modes.
-
-Some modes represent groups of modes.
-
-## Values
-
-- `vehicle`
-- `motor_vehicle`
-- `car`
-- `truck`
-- `motorcycle`
-- `foot`
-- `bicycle`
-- `bus`
-- `hgv`
-- `hov`
-- `emergency`
-
-## Used By
-
-- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
-- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
-- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_axle_count_selector.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_axle_count_selector.md
deleted file mode 100644
index 461dd926a..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_axle_count_selector.md
+++ /dev/null
@@ -1,17 +0,0 @@
-# VehicleAxleCountSelector
-
-Selects vehicles based on the number of axles they have.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `dimension` | `"axle_count"` | |
-| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
-| `value` | [`uint8`](../../system/primitive/primitives.md) | Number of axles on the vehicle |
-
-## Used By
-
-- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
-- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
-- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_height_selector.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_height_selector.md
deleted file mode 100644
index ba56f33d7..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_height_selector.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# VehicleHeightSelector
-
-Selects vehicles based on their height.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `dimension` | `"height"` | |
-| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
-| `value` | [`float64`](../../system/primitive/primitives.md) | Vehicle height selection threshold in the given `unit`<br/><br/>*`≥ 0`* |
-| `unit` | [`LengthUnit`](../length_unit.md) | Height unit in which `value` is expressed |
-
-## Used By
-
-- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
-- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
-- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_length_selector.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_length_selector.md
deleted file mode 100644
index 5a6e1c017..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_length_selector.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# VehicleLengthSelector
-
-Selects vehicles based on their length.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `dimension` | `"length"` | |
-| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
-| `value` | [`float64`](../../system/primitive/primitives.md) | Vehicle length selection threshold in the given `unit`<br/><br/>*`≥ 0`* |
-| `unit` | [`LengthUnit`](../length_unit.md) | Length unit in which `value` is expressed |
-
-## Used By
-
-- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
-- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
-- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_relation.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_relation.md
deleted file mode 100644
index 0ac89eddd..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_relation.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# VehicleRelation
-
-Relational operator, such as less than or equal to.
-
-## Values
-
-- `greater_than`
-- `greater_than_equal`
-- `equal`
-- `less_than`
-- `less_than_equal`
-
-## Used By
-
-- [`VehicleAxleCountSelector`](vehicle_axle_count_selector.md)
-- [`VehicleHeightSelector`](vehicle_height_selector.md)
-- [`VehicleLengthSelector`](vehicle_length_selector.md)
-- [`VehicleWeightSelector`](vehicle_weight_selector.md)
-- [`VehicleWidthSelector`](vehicle_width_selector.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_weight_selector.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_weight_selector.md
deleted file mode 100644
index 3e42bdce1..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_weight_selector.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# VehicleWeightSelector
-
-Selects vehicles based on their weight.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `dimension` | `"weight"` | |
-| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
-| `value` | [`float64`](../../system/primitive/primitives.md) | Vehicle weight selection threshold in the given `unit`<br/><br/>*`≥ 0`* |
-| `unit` | [`WeightUnit`](../weight_unit.md) | Weight unit in which `value` is expressed |
-
-## Used By
-
-- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
-- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
-- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_width_selector.md b/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_width_selector.md
deleted file mode 100644
index f86e41b3b..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/scoping/vehicle_width_selector.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# VehicleWidthSelector
-
-Selects vehicles based on their width.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `dimension` | `"width"` | |
-| `comparison` | [`VehicleRelation`](vehicle_relation.md) | |
-| `value` | [`float64`](../../system/primitive/primitives.md) | Vehicle width selection threshold in the given `unit`<br/><br/>*`≥ 0`* |
-| `unit` | [`LengthUnit`](../length_unit.md) | Width unit in which `value` is expressed |
-
-## Used By
-
-- [`AccessRestrictionRule.When`](../../transportation/types/access_restriction_rule.when.md)
-- [`ProhibitedTransitionRule.When`](../../transportation/types/prohibited_transition_rule.when.md)
-- [`SpeedLimitRule.When`](../../transportation/types/speed_limit_rule.when.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/sort_key.md b/schema_versioned_docs/version-v1.17.0/reference/common/sort_key.md
deleted file mode 100644
index 1c1187168..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/sort_key.md
+++ /dev/null
@@ -1,17 +0,0 @@
-# SortKey
-
-Integer indicating the recommended order in which to draw features.
-
-Features with a lower number should be drawn "in front" of features with a higher
-number.
-
-Underlying type: `int32`
-
-## Constraints
-
-- `≥ -2147483648` (from [`int32`](../system/primitive/primitives.md))
-- `≤ 2147483647` (from [`int32`](../system/primitive/primitives.md))
-
-## Used By
-
-- [`CartographicHints`](cartographic_hints.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/source_item.md b/schema_versioned_docs/version-v1.17.0/reference/common/source_item.md
deleted file mode 100644
index c4acca0d8..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/source_item.md
+++ /dev/null
@@ -1,34 +0,0 @@
-# SourceItem
-
-Specifies the source of the data used for a feature or one of its properties.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
-| `dataset` | `string` | Name of the dataset where the source data can be found. |
-| `license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
-| `record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
-| `update_time` | `datetime` (optional) | Last update time of the source data record. |
-| `confidence` | [`ConfidenceScore`](confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
-| `between` | [`LinearlyReferencedRange`](scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
-
-## Used By
-
-- [`Address`](../addresses/address.md)
-- [`Bathymetry`](../base/bathymetry.md)
-- [`Building`](../buildings/building.md)
-- [`BuildingPart`](../buildings/building_part.md)
-- [`Connector`](../transportation/connector.md)
-- [`Division`](../divisions/division.md)
-- [`DivisionArea`](../divisions/division_area.md)
-- [`DivisionBoundary`](../divisions/division_boundary.md)
-- [`Infrastructure`](../base/infrastructure.md)
-- [`Land`](../base/land.md)
-- [`LandCover`](../base/land_cover.md)
-- [`LandUse`](../base/land_use.md)
-- [`Place`](../places/place.md)
-- [`Segment`](../transportation/segment.md)
-- [`Water`](../base/water.md)
-- [`Sources`](sources.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/sources.md b/schema_versioned_docs/version-v1.17.0/reference/common/sources.md
deleted file mode 100644
index ac48419ef..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/sources.md
+++ /dev/null
@@ -1,28 +0,0 @@
-# Sources
-
-Information about the source data used to assemble the feature.
-
-Underlying type: `list<`[`SourceItem`](source_item.md)`>`
-
-## Constraints
-
-- Minimum length: 1
-- All items must be unique. (`UniqueItemsConstraint`)
-
-## Used By
-
-- [`Address`](../addresses/address.md)
-- [`Bathymetry`](../base/bathymetry.md)
-- [`Building`](../buildings/building.md)
-- [`BuildingPart`](../buildings/building_part.md)
-- [`Connector`](../transportation/connector.md)
-- [`Division`](../divisions/division.md)
-- [`DivisionArea`](../divisions/division_area.md)
-- [`DivisionBoundary`](../divisions/division_boundary.md)
-- [`Infrastructure`](../base/infrastructure.md)
-- [`Land`](../base/land.md)
-- [`LandCover`](../base/land_cover.md)
-- [`LandUse`](../base/land_use.md)
-- [`Place`](../places/place.md)
-- [`Segment`](../transportation/segment.md)
-- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/speed_unit.md b/schema_versioned_docs/version-v1.17.0/reference/common/speed_unit.md
deleted file mode 100644
index acfd44ac0..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/speed_unit.md
+++ /dev/null
@@ -1,12 +0,0 @@
-# SpeedUnit
-
-Unit of speed.
-
-## Values
-
-- `mph` - Miles per hour
-- `km/h` - Kilometers per hour
-
-## Used By
-
-- [`Speed`](../transportation/types/speed.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/common/weight_unit.md b/schema_versioned_docs/version-v1.17.0/reference/common/weight_unit.md
deleted file mode 100644
index f53cb2977..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/common/weight_unit.md
+++ /dev/null
@@ -1,17 +0,0 @@
-# WeightUnit
-
-Unit of weight.
-
-## Values
-
-- `oz` - One ounce in the imperial and US customary systems
-- `lb` - One pound in the imperial and US customary systems
-- `st` - One short ton, or one ton in the US customary system (2,000 pounds)
-- `lt` - One long ton, or one ton in the imperial system (2,400 pounds)
-- `g` - One gram in the metric and SI systems
-- `kg` - One kilogram in the metric and SI systems
-- `t` - One tonne in the metric and SI systems
-
-## Used By
-
-- [`VehicleWeightSelector`](scoping/vehicle_weight_selector.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/divisions/_category_.json
deleted file mode 100644
index 51eecd257..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/divisions/_category_.json
+++ /dev/null
@@ -1,4 +0,0 @@
-{
-  "label": "Divisions",
-  "position": 4
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/division.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/division.md
deleted file mode 100644
index 94981f754..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/divisions/division.md
+++ /dev/null
@@ -1,132 +0,0 @@
----
-sidebar_position: 1
----
-
-# Division
-
-Divisions are recognized official or non-official organizations of people as seen from a given
-political perspective.
-
-Examples include countries, provinces, cities, towns, neighborhoods, etc.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `cartography` | [`CartographicHints`](../common/cartographic_hints.md) (optional) | Cartographic hints useful when including the feature in maps |
-| `cartography.prominence` | [`Prominence`](../common/prominence.md) (optional) | Subjective scale of feature significance or importance, with 1 being the least, and 100 being the most, significant.<br/><br/>This value can be used to help drive decisions about how and when to display a feature, and how to treat it relative to neighboring features.<br/><br/>When populated by Overture, this value is derived from various factors including, but not limited to: feature and subtype, population, and capital status. |
-| `cartography.min_zoom` | [`MinZoom`](../common/min_zoom.md) (optional) | Recommended minimum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels below this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
-| `cartography.max_zoom` | [`MaxZoom`](../common/max_zoom.md) (optional) | Recommended maximum tile zoom level in which this feature should be displayed.<br/><br/>It is recommended that the feature be hidden at zoom levels above this value.<br/><br/>Zoom levels follow the Slippy Maps convention, documented in the following references: - https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames - https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection |
-| `cartography.sort_key` | [`SortKey`](../common/sort_key.md) (optional) | Integer indicating the recommended order in which to draw features.<br/><br/>Features with a lower number should be drawn "in front" of features with a higher number. |
-| `names` | [`Names`](../common/names.md) | All known names by which the division is called |
-| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
-| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
-| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
-| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
-| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
-| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
-| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
-| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
-| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
-| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
-| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
-| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
-| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
-| `geometry` | [`geometry`](../system/primitive/geometry.md) | Approximate location of a position commonly associated with the real-world entity modeled by the division feature.<br/><br/>*Allowed geometry types: Point* |
-| `theme` | `"divisions"` | |
-| `type` | `"division"` | |
-| `version` | [`FeatureVersion`](../common/feature_version.md) | |
-| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
-| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
-| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
-| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
-| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
-| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
-| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
-| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
-| `subtype` | [`DivisionSubtype`](types/division_subtype.md) | A broad classification of the division (e.g., country, region, locality, etc.).<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`*<br/>*`parent_division_id` is required when `subtype` ≠ `country`*<br/>*`parent_division_id` is forbidden when `subtype` = `country`* |
-| `country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) | ISO 3166-1 alpha-2 country code of the country or country-like entity, that this division represents or belongs to.<br/><br/>If the entity this division represents has a country code, the country property contains it. If it does not, the country property contains the country code of the first division encountered by traversing the parent_division_id chain to the root.<br/><br/>For example: - The country value for the United States is 'US' - The country value for New York City is 'US' - The country value for Puerto Rico, a dependency of the US, is 'PR'. - The country value for San Juan, Puerto Rico is 'PR'.<br/><br/>If an entity has an internationally-recognized ISO 3166-1 alpha-2 country code, it should always be used. In cases where the schema requires the code but no internationally-recognized code is available, a synthetic code may be used provided it does not conflict with any internationally-recognized codes. |
-| `hierarchies[][]` | `list<`[`Hierarchy`](types/hierarchy.md)`>` | Hierarchies in which this division participates.<br/><br/>Every division participates in at least one hierarchy. Most participate in only one. Some divisions may participate in more than one hierarchy, for example if they are claimed by different parent divisions from different political perspectives; or if there are other real-world reasons why the division or one of its ancestors has multiple parents.<br/><br/>The first hierarchy in the list is the default hierarchy, and the second-to-last entry in the default hierarchy (if there is such an entry) always corresponds to the `parent_division_id` property. The ordering of hierarchies after the first one is arbitrary.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
-| `hierarchies[][].division_id` | [`Id`](../system/ref/id.md) | ID of a division that is an ancestor of the current division.<br/><br/>In the context of division hierarchies, the ancestor divisions of a division include the division itself, and any other division that is an ancestor of the division's parent. |
-| `hierarchies[][].subtype` | [`DivisionSubtype`](types/division_subtype.md) | |
-| `hierarchies[][].name` | [`StrippedString`](../system/stripped_string.md) | Primary name of the division |
-| `parent_division_id` | [`Id`](../system/ref/id.md) (optional) | Division ID of this division's parent division.<br/><br/>Not allowed for top-level divisions (countries) and required for all other divisions.<br/><br/>The default parent division is the parent division as seen from the default political perspective, if there is one, and is otherwise chosen somewhat arbitrarily. The hierarchies property can be used to inspect the exhaustive list of parent divisions.<br/><br/>*References `Division` (hierarchy, child of)*<br/><br/>*`parent_division_id` is required when `subtype` ≠ `country`*<br/>*`parent_division_id` is forbidden when `subtype` = `country`* |
-| `admin_level` | [`AdminLevel`](types/admin_level.md) (optional) | Integer representing the division's position in its country's administrative hierarchy, where lower numbers correspond to higher level administrative units.<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`* |
-| `class` | [`DivisionClass`](types/division_class.md) (optional) | A more specific classification of the division than is provided by `subtype`. |
-| `local_type` | [`CommonNames`](../common/common_names.md) (map, optional) | Local name for the subtype property, optionally localized.<br/><br/>For example, the Canadian province of Quebec has the subtype `"region"`, but in the local administrative hierarchy it is referred to as a province. Similarly, the Canadian Yukon territory also has subtype `"region"`, but is locally called a territory.<br/><br/>This property is localized using a standard Overture names structure. So for example, in Switzerland the top-level administrative subdivision corresponding to subtype 'region' is the canton, which may be translated in each of Switzerland's official languages as, 'canton' in French, 'kanton' in German, 'cantone' in Italian, and 'chantun' in Romansh. |
-| `region` | [`RegionCode`](../system/region_code.md) (optional) | ISO 3166-2 principal subdivision code of the subdivision-like entity this division represents or belongs to.<br/><br/>If the entity this division represents has a principal subdivision code, the region property contains it. If it does not, the region property contains the principal subdivision code of the first division encountered by traversing the `parent_division_id` chain to the root.<br/><br/>For example: - The region value for the United States is omitted. - The region value for the U.S. state of New York is 'US-NY'. - The region value for New York City is 'US-NY', which it inherits from the state   of New York. - The region value for Puerto Rico is 'US-PR'. |
-| `perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which this division is considered to be an accurate representation.<br/><br/>If this property is absent, then this division is not known to be disputed from any political perspective. Consequently, there is only one division feature representing the entire real world entity.<br/><br/>If this property is present, it means the division represents one of several alternative perspectives on the same real-world entity.<br/><br/>There are two modes of perspective:<br/><br/>1. `accepted_by` means the representation of the division is accepted by the    listed entities and would be included on a map drawn from their perspective.<br/><br/>2. `disputed_by` means the representation of the division is disputed by the    listed entities and would be excluded from a map drawn from their perspective.<br/><br/>When drawing a map from the perspective of a given country, one would start by gathering all the undisputed divisions (with no `perspectives` property), and then adding to that first all divisions explicitly accepted by the country, and second all divisions not explicitly disputed by the country. |
-| `perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
-| `perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
-| `norms` | [`Norms`](types/norms.md) (optional) | Collects information about local norms and rules within the division that are generally useful for mapping and map-related use cases.<br/><br/>If the norms property or a desired sub-property of the norms property is missing on a division, but at least one of its ancestor divisions has the norms property and the desired sub-property, then the value from the nearest ancestor division may be assumed. |
-| `norms.driving_side` | [`Side`](../common/scoping/side.md) (optional) | Side of the road on which vehicles drive in the division. |
-| `population` | [`int32`](../system/primitive/primitives.md) (optional) | Population of the division<br/><br/>*`≥ 0`* |
-| `capital_division_ids` | `list<`[`Id`](../system/ref/id.md)`>` (optional) | Division IDs of this division's capital divisions. If present, this property will refer to the division IDs of the capital cities, county seats, etc. of a division.<br/><br/>*References `Division` (hierarchy, has as capital)*<br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
-| `capital_of_divisions[]` | `list<`[`CapitalOfDivisionItem`](types/capital_of_division_item.md)`>` (optional) | Division IDs and subtypes of divisions this division is a capital of.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
-| `capital_of_divisions[].division_id` | [`Id`](../system/ref/id.md) | ID of the division whose capital is the current division. |
-| `capital_of_divisions[].subtype` | [`DivisionSubtype`](types/division_subtype.md) | |
-| `wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
-
-## Constraints
-
-- `admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`
-- `parent_division_id` is required when `subtype` ≠ `country`
-- `parent_division_id` is forbidden when `subtype` = `country`
-
-## Examples
-
-| Column | Value |
-| -------: | ------- |
-| `cartography.prominence` | `29` |
-| `cartography.min_zoom` | `null` |
-| `cartography.max_zoom` | `null` |
-| `cartography.sort_key` | `null` |
-| `names.primary` | `Sia'atoutai` |
-| `names.common` | `null` |
-| `id` | `350e85f6-68ba-4114-9906-c2844815988b` |
-| `bbox.xmin` | `-175.25515747070312` |
-| `bbox.ymin` | `-21.1353702545166` |
-| `bbox.xmax` | `-175.255126953125` |
-| `bbox.ymax` | `-21.13536834716797` |
-| `geometry` | `POINT (-175.2551522 -21.1353686)` |
-| `theme` | `divisions` |
-| `type` | `division` |
-| `version` | `1` |
-| `sources[0].property` |  |
-| `sources[0].dataset` | `OpenStreetMap` |
-| `sources[0].license` | `null` |
-| `sources[0].record_id` | `n3173231082@4` |
-| `sources[0].update_time` | `2014-12-18T09:17:03+00:00` |
-| `sources[0].confidence` | `null` |
-| `sources[0].between` | `null` |
-| `subtype` | `locality` |
-| `country` | `TO` |
-| `hierarchies[0][0].division_id` | `fef8748b-0c91-46ad-9f2d-976d8d2de3e9` |
-| `hierarchies[0][0].subtype` | `country` |
-| `hierarchies[0][0].name` | `Tonga` |
-| `hierarchies[0][1].division_id` | `4d67561a-2292-41bd-8996-7853d276a42c` |
-| `hierarchies[0][1].subtype` | `region` |
-| `hierarchies[0][1].name` | `Tongatapu` |
-| `hierarchies[0][2].division_id` | `8730f0cc-d436-4f11-a7d3-49085813ef44` |
-| `hierarchies[0][2].subtype` | `county` |
-| `hierarchies[0][2].name` | `Vahe Kolomotu'a` |
-| `hierarchies[0][3].division_id` | `350e85f6-68ba-4114-9906-c2844815988b` |
-| `hierarchies[0][3].subtype` | `locality` |
-| `hierarchies[0][3].name` | `Sia'atoutai` |
-| `parent_division_id` | `8730f0cc-d436-4f11-a7d3-49085813ef44` |
-| `admin_level` | `null` |
-| `class` | `village` |
-| `local_type` | `{"en": "village"}` |
-| `region` | `TO-04` |
-| `perspectives` | `null` |
-| `norms` | `null` |
-| `population` | `534` |
-| `capital_division_ids` | `null` |
-| `capital_of_divisions` | `null` |
-| `wikidata` | `null` |
-| `names.rules[0].value` | `Nafualu` |
-| `names.rules[0].variant` | `alternate` |
-| `names.rules[0].language` | `null` |
-| `names.rules[0].perspectives` | `null` |
-| `names.rules[0].between` | `null` |
-| `names.rules[0].side` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/division_area.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/division_area.md
deleted file mode 100644
index 0fa1c5c60..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/divisions/division_area.md
+++ /dev/null
@@ -1,88 +0,0 @@
----
-sidebar_position: 1
----
-
-# DivisionArea
-
-Division areas are polygon features that represent the land or maritime area covered by a
-division.
-
-Each division area belongs to a division which it references by ID, and for which the division
-area provides an area polygon. For ease of use, every division area repeats the subtype, names,
-country, and region properties of the division it belongs to.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `names` | [`Names`](../common/names.md) | All known names by which the owning division is called |
-| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
-| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
-| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
-| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
-| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
-| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
-| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
-| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
-| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
-| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
-| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
-| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
-| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
-| `geometry` | [`geometry`](../system/primitive/geometry.md) | The area covered by the division with which this area feature is associated.<br/><br/>*Allowed geometry types: MultiPolygon, Polygon* |
-| `theme` | `"divisions"` | |
-| `type` | `"division_area"` | |
-| `version` | [`FeatureVersion`](../common/feature_version.md) | |
-| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
-| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
-| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
-| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
-| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
-| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
-| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
-| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
-| `subtype` | [`DivisionSubtype`](types/division_subtype.md) | A broad classification of the division this area belongs to (e.g., country, region, locality, etc.).<br/><br/>This value is the same as the owning division's `subtype`.<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`* |
-| `class` | [`AreaClass`](types/area_class.md) | A more specific classification of the division area than is provided by `subtype`. |
-| `is_land` | `boolean` (optional) | Flag indicating whether or not the feature geometry represents the land-clipped, non-maritime boundary. The geometry can be used for map rendering, cartographic display, and similar purposes.<br/><br/>*`strict=True`*<br/><br/>*Exactly one of `is_land`, `is_territorial` must be `true`* |
-| `is_territorial` | `boolean` (optional) | Flag indicating whether or not the feature geometry represents Overture's best approximation of the division's territorial boundary. For coastal places, this will tend to include the water area. The geometry can be used for data processing, reverse-geocoding, and similar purposes.<br/><br/>*`strict=True`*<br/><br/>*Exactly one of `is_land`, `is_territorial` must be `true`* |
-| `division_id` | [`Id`](../system/ref/id.md) | Division ID of the parent division of this area.<br/><br/>*References [`Division`](division.md) (hierarchy, child of)* |
-| `country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) | ISO 3166-1 alpha-2 country code of the division this area belongs to. |
-| `region` | [`RegionCode`](../system/region_code.md) (optional) | ISO 3166-2 principal subdivision code of the division this area belongs to. |
-| `admin_level` | [`AdminLevel`](types/admin_level.md) (optional) | Integer representing the division's position in its country's administrative hierarchy, where lower numbers correspond to higher level administrative units.<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`* |
-
-## Constraints
-
-- Exactly one of `is_land`, `is_territorial` must be `true`
-- `admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`
-
-## Examples
-
-| Column | Value |
-| -------: | ------- |
-| `names.primary` | `ʻEua` |
-| `names.common` | `null` |
-| `names.rules` | `null` |
-| `id` | `eb9b112f-ec3c-47f7-b519-6f9f2e6fc2bd` |
-| `bbox.xmin` | `-174.97535705566406` |
-| `bbox.ymin` | `-21.473018646240234` |
-| `bbox.xmax` | `-174.90040588378906` |
-| `bbox.ymax` | `-21.283489227294922` |
-| `geometry` | `MULTIPOLYGON (((-174.9553949 -21.4730179, -174.9514163 -21.4719978, -174.9520108 -21.4681253, -17...` |
-| `theme` | `divisions` |
-| `type` | `division_area` |
-| `version` | `2` |
-| `sources[0].property` |  |
-| `sources[0].dataset` | `OpenStreetMap` |
-| `sources[0].license` | `null` |
-| `sources[0].record_id` | `r7247527@3` |
-| `sources[0].update_time` | `2020-12-30T18:41:56+00:00` |
-| `sources[0].confidence` | `null` |
-| `sources[0].between` | `null` |
-| `subtype` | `region` |
-| `class` | `land` |
-| `is_land` | `true` |
-| `is_territorial` | `false` |
-| `division_id` | `21597af0-b564-463c-a356-42c29e712b7d` |
-| `country` | `TO` |
-| `region` | `TO-01` |
-| `admin_level` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/division_boundary.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/division_boundary.md
deleted file mode 100644
index 8988cc6ce..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/divisions/division_boundary.md
+++ /dev/null
@@ -1,85 +0,0 @@
----
-sidebar_position: 1
----
-
-# DivisionBoundary
-
-Boundaries represent borders between divisions of the same subtype.
-
-Some boundaries may be disputed by the divisions on one or both sides.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
-| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
-| `geometry` | [`geometry`](../system/primitive/geometry.md) | Boundary line or lines<br/><br/>*Allowed geometry types: LineString, MultiLineString* |
-| `theme` | `"divisions"` | |
-| `type` | `"division_boundary"` | |
-| `version` | [`FeatureVersion`](../common/feature_version.md) | |
-| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
-| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
-| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
-| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
-| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
-| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
-| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
-| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
-| `subtype` | [`DivisionSubtype`](types/division_subtype.md) | A broad classification of the divisions this boundary separates (e.g., country, region, locality, etc.).<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`*<br/>*`country` is required when `subtype` ≠ `country`*<br/>*`country` is forbidden when `subtype` = `country`* |
-| `class` | [`BoundaryClass`](types/boundary_class.md) | The kind of boundary: land or maritime. |
-| `is_land` | `boolean` (optional) | Flag indicating whether or not the feature geometry represents the land-clipped, non-maritime boundary. The geometry can be used for map rendering, cartographic display, and similar purposes.<br/><br/>*`strict=True`*<br/><br/>*Exactly one of `is_land`, `is_territorial` must be `true`* |
-| `is_territorial` | `boolean` (optional) | Flag indicating whether or not the feature geometry represents Overture's best approximation of the division's territorial boundary. For coastal places, this will tend to include the water area. The geometry can be used for data processing, reverse-geocoding, and similar purposes.<br/><br/>*`strict=True`*<br/><br/>*Exactly one of `is_land`, `is_territorial` must be `true`* |
-| `division_ids` | `list<`[`Id`](../system/ref/id.md)`>` | Identifies the two divisions to the left and right, respectively, of the boundary line. The left- and right-hand sides of the boundary are considered from the perspective of a person standing on the line facing in the direction in which the geometry is oriented, i.e. facing toward the end of the line.<br/><br/>The first array element is the Overture ID of the left division. The second element is the Overture ID of the right division.<br/><br/>*References [`Division`](division.md) (composition, boundary of)*<br/>*Minimum length: 2*<br/>*Maximum length: 2*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
-| `country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) (optional) | ISO 3166-1 alpha-2 country code of the country or country-like entity that both sides of the boundary share.<br/><br/>This property will be present on boundaries between two regions, counties, or similar entities within the same country, but will not be present on boundaries between two countries or country-like entities.<br/><br/>*`country` is required when `subtype` ≠ `country`*<br/>*`country` is forbidden when `subtype` = `country`* |
-| `region` | [`RegionCode`](../system/region_code.md) (optional) | ISO 3166-2 principal subdivision code of the subdivision-like entity that both sides of the boundary share.<br/><br/>This property will be present on boundaries between two counties, localadmins or similar entities within the same principal subdivision, but will not be present on boundaries between different principal subdivisions or countries. |
-| `admin_level` | [`AdminLevel`](types/admin_level.md) (optional) | Integer representing the division's position in its country's administrative hierarchy, where lower numbers correspond to higher level administrative units.<br/><br/>*`admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`* |
-| `is_disputed` | `boolean` (optional) | Flag indicating whether this boundary is either disputed outright or is a "best guess" in a case where the boundary between two divisions is unclear.<br/><br/>If the boundary is disputed outright, this flag is true and the entities disputing it are listed in the `perspectives` property. If the boundary is simply a "best guess", this flag is true but no disputing entities are listed in `perspectives`.<br/><br/>*`strict=True`* |
-| `perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which this division boundary is considered to be an accurate representation.<br/><br/>If this property is absent, then this boundary is not known to be disputed from any political perspective. Consequently, there is only one boundary feature representing the entire real world entity.<br/><br/>If this property is present, it means the boundary represents one of several alternative perspectives on the same real-world entity.<br/><br/>There are two modes of perspective:<br/><br/>1. `accepted_by` means the representation of the boundary is accepted by the    listed entities and would be included on a map drawn from their perspective.<br/><br/>2. `disputed_by` means the representation of the boundary is disputed by the    listed entities and would be excluded from a map drawn from their    perspective.<br/><br/>When drawing a map from the perspective of a given country, one would start by gathering all the undisputed boundaries (those with no `perspectives` value); and then adding to that: first, all boundaries explicitly accepted by the country, and second, all boundaries not explicitly disputed by the country. |
-| `perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
-| `perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
-
-## Constraints
-
-- Exactly one of `is_land`, `is_territorial` must be `true`
-- `admin_level` is required when `subtype` is one of: `county`, `macrocounty`, `region`, `macroregion`, `dependency`, `country`
-- `country` is required when `subtype` ≠ `country`
-- `country` is forbidden when `subtype` = `country`
-
-## Examples
-
-| Column | Value |
-| -------: | ------- |
-| `id` | `2bdf68e4-860d-3d8c-a472-ccf439a5302a` |
-| `bbox.xmin` | `-147.06483459472656` |
-| `bbox.ymin` | `-15.4231538772583` |
-| `bbox.xmax` | `-147.04847717285156` |
-| `bbox.ymax` | `-15.151169776916504` |
-| `geometry` | `LINESTRING (-147.064823 -15.4231537, -147.0519131 -15.2885069, -147.048482 -15.1511701)` |
-| `theme` | `divisions` |
-| `type` | `division_boundary` |
-| `version` | `1` |
-| `sources[0].property` |  |
-| `sources[0].dataset` | `OpenStreetMap` |
-| `sources[0].license` | `null` |
-| `sources[0].record_id` | `r6063055@9` |
-| `sources[0].update_time` | `2023-07-20T00:28:40+00:00` |
-| `sources[0].confidence` | `null` |
-| `sources[0].between` | `null` |
-| `sources[1].property` |  |
-| `sources[1].dataset` | `OpenStreetMap` |
-| `sources[1].license` | `null` |
-| `sources[1].record_id` | `r6063063@12` |
-| `sources[1].update_time` | `2023-07-20T00:28:40+00:00` |
-| `sources[1].confidence` | `null` |
-| `sources[1].between` | `null` |
-| `subtype` | `county` |
-| `class` | `maritime` |
-| `is_land` | `false` |
-| `is_territorial` | `true` |
-| `division_ids` | `["ae266459-63a4-4508-8295-0101e27d039b", "d4a6873d-885a-4f2a-bc0f-37e9d9e874e4"]` |
-| `country` | `PF` |
-| `region` | `null` |
-| `admin_level` | `null` |
-| `is_disputed` | `false` |
-| `perspectives` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/_category_.json
deleted file mode 100644
index a3ec08974..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/_category_.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-  "label": "Types"
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/admin_level.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/admin_level.md
deleted file mode 100644
index 98e38c849..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/admin_level.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# AdminLevel
-
-Integer representing the division's position in its country's administrative
-hierarchy, where lower numbers correspond to higher level administrative units.
-
-Underlying type: `int32`
-
-## Constraints
-
-- `≥ 0`
-- `≤ 16`
-- `≥ -2147483648` (from [`int32`](../../system/primitive/primitives.md))
-- `≤ 2147483647` (from [`int32`](../../system/primitive/primitives.md))
-
-## Used By
-
-- [`Division`](../division.md)
-- [`DivisionArea`](../division_area.md)
-- [`DivisionBoundary`](../division_boundary.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/area_class.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/area_class.md
deleted file mode 100644
index b0367b2ca..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/area_class.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# AreaClass
-
-Further classification of a division area that is more specific than its `subtype`.
-
-A division area's `class` adds detail to the broad classification found in `DivisionSubtype`.
-
-## Values
-
-- `land` - The area does not extend beyond the coastline.
-- `maritime` - The area extends beyond the coastline, in most cases to the extent of the division's
-territorial sea, if it has one.
-
-## Used By
-
-- [`DivisionArea`](../division_area.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/boundary_class.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/boundary_class.md
deleted file mode 100644
index 9b2d103da..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/boundary_class.md
+++ /dev/null
@@ -1,13 +0,0 @@
-# BoundaryClass
-
-The kind of boundary: land or maritime.
-
-## Values
-
-- `land` - None of the boundary geometry extends beyond the coastline of either associated
-division.
-- `maritime` - All the boundary geometry extends beyond the coastline of both associated divisions.
-
-## Used By
-
-- [`DivisionBoundary`](../division_boundary.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/capital_of_division_item.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/capital_of_division_item.md
deleted file mode 100644
index f7c5f1c78..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/capital_of_division_item.md
+++ /dev/null
@@ -1,14 +0,0 @@
-# CapitalOfDivisionItem
-
-A division of which the owning division is the capital, together with its subtype.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `division_id` | [`Id`](../../system/ref/id.md) | ID of the division whose capital is the current division.<br/><br/>*References [`Division`](../division.md) (hierarchy, capital of)* |
-| `subtype` | [`DivisionSubtype`](division_subtype.md) | |
-
-## Used By
-
-- [`Division`](../division.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/division_class.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/division_class.md
deleted file mode 100644
index f7cac4560..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/division_class.md
+++ /dev/null
@@ -1,20 +0,0 @@
-# DivisionClass
-
-Further classification of a division that is more specific than its `subtype`.
-
-A division's `class` adds detail to the broad classification found in `DivisionSubtype`.
-
-## Values
-
-- `megacity` - A very large city or metropolitan area, typically having a population of 10 million or
-more. Example: Tokyo, Japan.
-- `city` - A large, permanent human settlement. Example: Guadalajara, Mexico.
-- `town` - A medium-sized permanent human settlement that is smaller than a city, but larger than a
-village. Example: Walldürn, Germany.
-- `village` - A smallish permanent human settlement that is smaller than a town, but larger than a
-hamlet. Example: Wadi El Karm, Lebanon.
-- `hamlet` - A very small, isolated human settlement in a rural area. Example: Tjarnabyggð, Iceland.
-
-## Used By
-
-- [`Division`](../division.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/division_subtype.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/division_subtype.md
deleted file mode 100644
index ad061cd7e..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/division_subtype.md
+++ /dev/null
@@ -1,35 +0,0 @@
-# DivisionSubtype
-
-Category of the division from a finite, hierarchical, ordered list of categories (e.g., country,
-region, locality, etc.) similar to a Who's on First placetype.
-
-## Values
-
-- `country` - Largest unit of independent sovereignty, e.g., the United States, France.
-- `dependency` - A place that is not exactly a sub-region of a country but is dependent on a parent
-country for defence, passport control, etc., e.g., Puerto Rico.
-- `macroregion` - A bundle of regions, e.g., England, Scotland, Île-de-France. These exist mainly in
-Europe.
-- `region` - A state, province, region, etc. Largest sub-country administrative unit in most
-countries, except those that have dependencies or macro-regions.
-- `macrocounty` - A bundle of counties, e.g. Inverness. These exist mainly in Europe.
-- `county` - Largest sub-region administrative unit in most countries, unless they have
-macrocounties.
-- `localadmin` - An administrative unit existing in some parts of the world that contains localities
-or populated places, e.g. département de Paris. Often the contained places do not
-have independent authority. Often, but not exclusively, found in Europe.
-- `locality` - A populated place that may or may not have its own administrative authority.
-- `borough` - A local government unit subordinate to a locality.
-- `macrohood` - A super-neighborhood that contains smaller divisions of type neighborhood, e.g.
-BoCaCa (Boerum Hill, Cobble Hill, and Carroll Gardens).
-- `neighborhood` - A neighborhood. Most neighborhoods will be just this, unless there's enough granular
-detail to justify introducing macrohood or microhood divisions.
-- `microhood` - A mini-neighborhood that is contained within a division of type neighborhood.
-
-## Used By
-
-- [`CapitalOfDivisionItem`](capital_of_division_item.md)
-- [`Division`](../division.md)
-- [`DivisionArea`](../division_area.md)
-- [`DivisionBoundary`](../division_boundary.md)
-- [`HierarchyItem`](hierarchy_item.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/hierarchy.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/hierarchy.md
deleted file mode 100644
index 22098138b..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/hierarchy.md
+++ /dev/null
@@ -1,21 +0,0 @@
-# Hierarchy
-
-A hierarchy of divisions, with the first entry being a country; each subsequent
-entry, if any, being a division that is a direct child of the previous entry; and
-the last entry representing the division that contains the hierarchy.
-
-For example, a hierarchy for the United States is simply [United States]. A
-hierarchy for the U.S. state of New Hampshire would be
-[United States, New Hampshire], and a hierarchy for the city of Concord, NH would be
-[United States, New Hampshire, Merrimack County, Concord].
-
-Underlying type: `list<`[`HierarchyItem`](hierarchy_item.md)`>`
-
-## Constraints
-
-- Minimum length: 1
-- All items must be unique. (`UniqueItemsConstraint`)
-
-## Used By
-
-- [`Division`](../division.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/hierarchy_item.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/hierarchy_item.md
deleted file mode 100644
index ffcf3aa94..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/hierarchy_item.md
+++ /dev/null
@@ -1,16 +0,0 @@
-# HierarchyItem
-
-One division in a hierarchy.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `division_id` | [`Id`](../../system/ref/id.md) | ID of a division that is an ancestor of the current division.<br/><br/>In the context of division hierarchies, the ancestor divisions of a division include the division itself, and any other division that is an ancestor of the division's parent.<br/><br/>*References [`Division`](../division.md) (hierarchy, descendant of)* |
-| `subtype` | [`DivisionSubtype`](division_subtype.md) | |
-| `name` | [`StrippedString`](../../system/stripped_string.md) | Primary name of the division<br/><br/>*Minimum length: 1* |
-
-## Used By
-
-- [`Division`](../division.md)
-- [`Hierarchy`](hierarchy.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/norms.md b/schema_versioned_docs/version-v1.17.0/reference/divisions/types/norms.md
deleted file mode 100644
index be619f59c..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/divisions/types/norms.md
+++ /dev/null
@@ -1,13 +0,0 @@
-# Norms
-
-Local norms and standards.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `driving_side` | [`Side`](../../common/scoping/side.md) (optional) | Side of the road on which vehicles drive in the division. |
-
-## Used By
-
-- [`Division`](../division.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/places/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/places/_category_.json
deleted file mode 100644
index 69d3715d6..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/places/_category_.json
+++ /dev/null
@@ -1,4 +0,0 @@
-{
-  "label": "Places",
-  "position": 5
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/places/place.md b/schema_versioned_docs/version-v1.17.0/reference/places/place.md
deleted file mode 100644
index 25911a72a..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/places/place.md
+++ /dev/null
@@ -1,115 +0,0 @@
----
-sidebar_position: 1
----
-
-# Place
-
-Places are point representations of real-world facilities, businesses, services, or amenities.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
-| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
-| `geometry` | [`geometry`](../system/primitive/geometry.md) | Position of the place. Places are point geometries.<br/><br/>*Allowed geometry types: Point* |
-| `theme` | `"places"` | |
-| `type` | `"place"` | |
-| `version` | [`FeatureVersion`](../common/feature_version.md) | |
-| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
-| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
-| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
-| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
-| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
-| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
-| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
-| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
-| `operating_status` | [`OperatingStatus`](types/operating_status.md) (optional) | An indication of whether a place is: in continued operation, in a temporary operating hiatus, or closed permanently.<br/><br/>This is not an indication of opening hours or that the place is open/closed at the current time-of-day or day-of-week.<br/><br/>When `operating_status` is `"permanently_closed"`, the `confidence` field will be set to 0. |
-| `categories` | [`Categories`](types/categories.md) (optional) | |
-| `categories.primary` | [`SnakeCaseString`](../system/snake_case_string.md) | The primary or main category of the place. |
-| `categories.alternate` | `list<`[`SnakeCaseString`](../system/snake_case_string.md)`>` (optional) | Alternate categories of the place.<br/><br/>Some places might fit into two categories, e.g., a book store and a coffee shop. In these cases, the primary category can be augmented with additional categories. |
-| `basic_category` | [`SnakeCaseString`](../system/snake_case_string.md) (optional) | The basic level category of a place.<br/><br/>This field classifies places into categories at a level that most people find intuitive. The full list of possible values it may hold can be found at (TODO).<br/><br/>The basic level category, or simply basic category, is based on a cognitive science model use in taxonomy and ontology development. The idea is to provide the category name at the level of generality that is preferred by humans in learning and memory tasks. This category to be roughly in the middle of the general-to-specific category hierarchy.<br/><br/>The full list of basic level categories is available at https://docs.overturemaps.org/guides/places/ |
-| `taxonomy` | [`Taxonomy`](types/taxonomy.md) (optional) | A structured representation of the place's category within the Overture taxonomy.<br/><br/>Provides the primary classification, full hierarchy path, and alternate categories. |
-| `taxonomy.primary` | [`SnakeCaseString`](../system/snake_case_string.md) | The primary, or most specific, category known about this place.<br/><br/>The `primary` category value must always equal the last or rightmost entry in the `hierarchy` field. |
-| `taxonomy.hierarchy` | `list<`[`SnakeCaseString`](../system/snake_case_string.md)`>` | The full primary hierarchy of categories known for this place, ordered from most general to most specific. An example hierarchy might be: `["food_and_drink", "restaurant", "casual_eatery", "gas_station_sushi"]`.<br/><br/>The rightmost, or most specific, value in the `hierarchy` must always be equal to the `primary` field. The basic level category of the place will typically be found in the middle of the primary hierarchy. The primary hierarchy does not include any of the alternate categories found in the `alternates` field. |
-| `taxonomy.alternates` | `list<`[`SnakeCaseString`](../system/snake_case_string.md)`>` (optional) | Unordered list of additional categories that are known for this place but that are not part of the primary category hierarchy.<br/><br/>Alternate categories allow a more complete picture of the place to be surfaced when it fits multiple unconnected branches in the taxonomy. For example a gas station that also sells groceries might have primary category of "gas_station" with an alternate of "grocery_store".<br/><br/>Alternate categories are not part of the primary hierarchy or another alternate category's hierarchy. In other words, if a category is a parent in the hierarchy of another category, that category can't be a primary or alternate category itself.<br/><br/>Note as well that this field is an unordered list of extra categories and does not represent a hierarchy. |
-| `confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | A score between 0 and 1 indicating how confident we are that the place exists.<br/><br/>A confidence score of 0 indicates that we are certain the place doesn't exist anymore and will always be paired with an `operating_status` of `"permanently_closed"`.<br/><br/>A confidence score of 1 indicates that we are certain the place does exist.<br/><br/>If there is no value for confidence, it means we don't have enough information on which to estimate our confidence level. |
-| `websites` | `list<`[`HttpUrl`](../pydantic/networks/http_url.md)`>` (optional) | The websites of the place.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
-| `socials` | `list<`[`HttpUrl`](../pydantic/networks/http_url.md)`>` (optional) | The social media URLs of the place.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
-| `emails` | `list<`[`EmailStr`](../pydantic/networks/email_str.md)`>` (optional) | The email addresses of the place.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
-| `phones` | `list<`[`PhoneNumber`](../system/phone_number.md)`>` (optional) | The phone numbers of the place.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
-| `brand` | [`Brand`](types/brand.md) (optional) | The brand associated with the place. |
-| `brand.names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
-| `brand.names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
-| `brand.names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
-| `brand.names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
-| `brand.names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
-| `brand.names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
-| `brand.names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
-| `brand.names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
-| `brand.names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
-| `brand.names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
-| `brand.names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
-| `brand.names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
-| `brand.wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
-| `addresses[]` | `list<`[`Address`](types/address.md)`>` (optional) | The address or addresses of the place<br/><br/>*Minimum length: 1* |
-| `addresses[].freeform` | `string` (optional) | Free-form address that contains street name, house number and other address info |
-| `addresses[].locality` | `string` (optional) | City, town, or neighborhood component of the place address |
-| `addresses[].postcode` | `string` (optional) | Postal code component of the place address |
-| `addresses[].region` | [`RegionCode`](../system/region_code.md) (optional) | An ISO 3166-2 principal subdivision code |
-| `addresses[].country` | [`CountryCodeAlpha2`](../system/country_code_alpha2.md) (optional) | An ISO 3166-1 alpha-2 country code |
-| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
-| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
-| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
-| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
-| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
-| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
-| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
-| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
-| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
-| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
-| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
-| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
-
-## Examples
-
-| Column | Value |
-| -------: | ------- |
-| `id` | `99003ee6-e75b-4dd6-8a8a-53a5a716c50d` |
-| `bbox.xmin` | `-150.46875` |
-| `bbox.ymin` | `-79.17134094238281` |
-| `bbox.xmax` | `-150.46875` |
-| `bbox.ymax` | `-79.17133331298828` |
-| `geometry` | `POINT (-150.46875 -79.1713346)` |
-| `theme` | `places` |
-| `type` | `place` |
-| `version` | `1` |
-| `sources[0].property` |  |
-| `sources[0].dataset` | `meta` |
-| `sources[0].license` | `null` |
-| `sources[0].record_id` | `107663894904826` |
-| `sources[0].update_time` | `2025-06-30T07:00:00+00:00` |
-| `sources[0].confidence` | `0.7337175792507205` |
-| `sources[0].between` | `null` |
-| `operating_status` | `open` |
-| `categories.primary` | `hotel` |
-| `categories.alternate` | `null` |
-| `basic_category` | `null` |
-| `taxonomy` | `null` |
-| `confidence` | `0.7337175792507205` |
-| `websites` | `["https://www.superhotel.co.jp/s_hotels/beppu/"]` |
-| `socials` | `["https://www.facebook.com/107663894904826"]` |
-| `emails` | `null` |
-| `phones` | `["+81977009000"]` |
-| `brand.names.primary` | `SUPER HOTEL` |
-| `brand.names.common` | `null` |
-| `brand.names.rules` | `null` |
-| `brand.wikidata` | `null` |
-| `addresses[0].freeform` | `秋田県横手市駅前町１３−８` |
-| `addresses[0].locality` | `横手市` |
-| `addresses[0].postcode` | `013-0036` |
-| `addresses[0].region` | `null` |
-| `addresses[0].country` | `JP` |
-| `names.primary` | `スーパーホテル別府駅前` |
-| `names.common` | `null` |
-| `names.rules` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/places/types/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/places/types/_category_.json
deleted file mode 100644
index a3ec08974..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/places/types/_category_.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-  "label": "Types"
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/places/types/address.md b/schema_versioned_docs/version-v1.17.0/reference/places/types/address.md
deleted file mode 100644
index b64d5be16..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/places/types/address.md
+++ /dev/null
@@ -1,17 +0,0 @@
-# Address
-
-An address associated with a place.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `freeform` | `string` (optional) | Free-form address that contains street name, house number and other address info |
-| `locality` | `string` (optional) | City, town, or neighborhood component of the place address |
-| `postcode` | `string` (optional) | Postal code component of the place address |
-| `region` | [`RegionCode`](../../system/region_code.md) (optional) | An ISO 3166-2 principal subdivision code |
-| `country` | [`CountryCodeAlpha2`](../../system/country_code_alpha2.md) (optional) | An ISO 3166-1 alpha-2 country code |
-
-## Used By
-
-- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/places/types/brand.md b/schema_versioned_docs/version-v1.17.0/reference/places/types/brand.md
deleted file mode 100644
index 65ebf269d..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/places/types/brand.md
+++ /dev/null
@@ -1,27 +0,0 @@
-# Brand
-
-A brand associated with a place.
-
-A location with multiple brands is modeled as multiple separate places, each with its own brand.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `names` | [`Names`](../../common/names.md) (optional) | All known names by which the feature is called |
-| `names.primary` | [`StrippedString`](../../system/stripped_string.md) | The most commonly used name. |
-| `names.common` | [`CommonNames`](../../common/common_names.md) (map, optional) | |
-| `names.rules[]` | `list<`[`NameRule`](../../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
-| `names.rules[].value` | [`StrippedString`](../../system/stripped_string.md) | The actual name value. |
-| `names.rules[].variant` | [`NameVariant`](../../common/name_variant.md) | The name variant for this name rule. |
-| `names.rules[].language` | [`LanguageTag`](../../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
-| `names.rules[].perspectives` | [`Perspectives`](../../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
-| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
-| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
-| `names.rules[].between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
-| `names.rules[].side` | [`Side`](../../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
-| `wikidata` | [`WikidataId`](../../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
-
-## Used By
-
-- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/places/types/categories.md b/schema_versioned_docs/version-v1.17.0/reference/places/types/categories.md
deleted file mode 100644
index 1dcce4d93..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/places/types/categories.md
+++ /dev/null
@@ -1,16 +0,0 @@
-# Categories
-
-Categories a place belongs to.
-
-Complete list is available on GitHub: [https://github.com/OvertureMaps/schema/blob/v1.17.0/docs/schema/concepts/by-theme/places/overture_categories.csv](https://github.com/OvertureMaps/schema/blob/v1.17.0/docs/schema/concepts/by-theme/places/overture_categories.csv)
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `primary` | [`SnakeCaseString`](../../system/snake_case_string.md) | The primary or main category of the place. |
-| `alternate` | `list<`[`SnakeCaseString`](../../system/snake_case_string.md)`>` (optional) | Alternate categories of the place.<br/><br/>Some places might fit into two categories, e.g., a book store and a coffee shop. In these cases, the primary category can be augmented with additional categories.<br/><br/>*All items must be unique. (`UniqueItemsConstraint`)* |
-
-## Used By
-
-- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/places/types/operating_status.md b/schema_versioned_docs/version-v1.17.0/reference/places/types/operating_status.md
deleted file mode 100644
index 61b17c7fe..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/places/types/operating_status.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# OperatingStatus
-
-General indication of whether a place is: in continued operation, in a temporary operating
-hiatus, or closed permanently.
-
-Operating status should not be confused with opening hours or operating hours. In particular,
-the status `"open"` does not mean the place is open *right now*, it means that in general the
-place is continuing to operate normally, as opposed to being in an operating hiatus
-(`"temporarily_closed"`) or shuttered (`"permanently_closed"`).
-
-## Values
-
-- `open`
-- `permanently_closed`
-- `temporarily_closed`
-
-## Used By
-
-- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/places/types/taxonomy.md b/schema_versioned_docs/version-v1.17.0/reference/places/types/taxonomy.md
deleted file mode 100644
index 33f5b4da9..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/places/types/taxonomy.md
+++ /dev/null
@@ -1,17 +0,0 @@
-# Taxonomy
-
-A structured representation of the place's category within the Overture taxonomy.
-
-Provides the primary classification, full hierarchy path, and alternate categories.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `primary` | [`SnakeCaseString`](../../system/snake_case_string.md) | The primary, or most specific, category known about this place.<br/><br/>The `primary` category value must always equal the last or rightmost entry in the `hierarchy` field. |
-| `hierarchy` | `list<`[`SnakeCaseString`](../../system/snake_case_string.md)`>` | The full primary hierarchy of categories known for this place, ordered from most general to most specific. An example hierarchy might be: `["food_and_drink", "restaurant", "casual_eatery", "gas_station_sushi"]`.<br/><br/>The rightmost, or most specific, value in the `hierarchy` must always be equal to the `primary` field. The basic level category of the place will typically be found in the middle of the primary hierarchy. The primary hierarchy does not include any of the alternate categories found in the `alternates` field.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
-| `alternates` | `list<`[`SnakeCaseString`](../../system/snake_case_string.md)`>` (optional) | Unordered list of additional categories that are known for this place but that are not part of the primary category hierarchy.<br/><br/>Alternate categories allow a more complete picture of the place to be surfaced when it fits multiple unconnected branches in the taxonomy. For example a gas station that also sells groceries might have primary category of "gas_station" with an alternate of "grocery_store".<br/><br/>Alternate categories are not part of the primary hierarchy or another alternate category's hierarchy. In other words, if a category is a parent in the hierarchy of another category, that category can't be a primary or alternate category itself.<br/><br/>Note as well that this field is an unordered list of extra categories and does not represent a hierarchy.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
-
-## Used By
-
-- [`Place`](../place.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/pydantic/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/pydantic/_category_.json
deleted file mode 100644
index 6bc65c372..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/pydantic/_category_.json
+++ /dev/null
@@ -1,4 +0,0 @@
-{
-  "label": "Pydantic",
-  "position": 8
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/_category_.json
deleted file mode 100644
index 8dc67bc4c..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/_category_.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-  "label": "Networks"
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/email_str.md b/schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/email_str.md
deleted file mode 100644
index 3bf99260b..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/email_str.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# EmailStr
-
-See: [Pydantic docs](https://docs.pydantic.dev/latest/api/networks/#pydantic.networks.EmailStr)
-
-## Used By
-
-- [`Place`](../../places/place.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/http_url.md b/schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/http_url.md
deleted file mode 100644
index b4b25f0ef..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/pydantic/networks/http_url.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# HttpUrl
-
-A type that will accept any http or https URL.
-
-See: [Pydantic docs](https://docs.pydantic.dev/latest/api/networks/#pydantic.networks.HttpUrl)
-
-## Used By
-
-- [`Place`](../../places/place.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/system/_category_.json
deleted file mode 100644
index 22378997a..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/system/_category_.json
+++ /dev/null
@@ -1,4 +0,0 @@
-{
-  "label": "System",
-  "position": 9
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/country_code_alpha2.md b/schema_versioned_docs/version-v1.17.0/reference/system/country_code_alpha2.md
deleted file mode 100644
index 815aaacfa..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/system/country_code_alpha2.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# CountryCodeAlpha2
-
-An ISO-3166-1 alpha-2 country code.
-
-Underlying type: `string`
-
-## Constraints
-
-- Allows only ISO 3166-1 alpha-2 country codes. (`CountryCodeAlpha2Constraint`, pattern: `^[A-Z]{2}$`)
-
-## Used By
-
-- [`Address`](../addresses/address.md)
-- [`Address`](../places/types/address.md)
-- [`Division`](../divisions/division.md)
-- [`DivisionArea`](../divisions/division_area.md)
-- [`DivisionBoundary`](../divisions/division_boundary.md)
-- [`Perspectives`](../common/perspectives.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/hex_color.md b/schema_versioned_docs/version-v1.17.0/reference/system/hex_color.md
deleted file mode 100644
index a22c9c1fb..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/system/hex_color.md
+++ /dev/null
@@ -1,20 +0,0 @@
-# HexColor
-
-A color represented as an #RRGGBB or #RGB hexadecimal string.
-
-For example:
-
-- `"#ff0000"` or `#f00` for pure red 🟥
-- `"#ffa500"` for bright orange 🟧
-- `"#000000"` or `"#000"` for black ⬛
-
-Underlying type: `string`
-
-## Constraints
-
-- Allows only hexadecimal color codes (e.g., #FF0000 or #FFF). (`HexColorConstraint`, pattern: `^#[0-9A-Fa-f]{3}([0-9A-Fa-f]{3})?$`)
-
-## Used By
-
-- [`Building`](../buildings/building.md)
-- [`BuildingPart`](../buildings/building_part.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/json_pointer.md b/schema_versioned_docs/version-v1.17.0/reference/system/json_pointer.md
deleted file mode 100644
index 6363abdc1..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/system/json_pointer.md
+++ /dev/null
@@ -1,23 +0,0 @@
-# JsonPointer
-
-A JSON Pointer
-
-As described in `the JSON Pointer specification, RFC-6901`_.
-
-.. _the JSON Pointer specification, RFC-6901: [https://rfc-editor.org/rfc/rfc6901.html](https://rfc-editor.org/rfc/rfc6901.html)
-
-For example:
-
-- `""` (root value)
-- `"/connectors/"`
-- `"/connectors/0/at"`
-
-Underlying type: `string`
-
-## Constraints
-
-- Allows only valid JSON Pointer values (RFC 6901). (`JsonPointerConstraint`)
-
-## Used By
-
-- [`SourceItem`](../common/source_item.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/language_tag.md b/schema_versioned_docs/version-v1.17.0/reference/system/language_tag.md
deleted file mode 100644
index c3145671a..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/system/language_tag.md
+++ /dev/null
@@ -1,27 +0,0 @@
-# LanguageTag
-
-A BCP-47 language tag.
-
-As described in `Tags for Identifying Languages, BCP-47`_.
-
-.. _Tags for Identifying Languages, BCP-47: [https://www.rfc-editor.org/rfc/bcp/bcp47.txt](https://www.rfc-editor.org/rfc/bcp/bcp47.txt)
-
-For example:
-
-- `"en"`
-- `"en-US"`
-- `"fr-CA"`
-- `"zh-Hant-TW"`
-
-Underlying type: `string`
-
-## Constraints
-
-- Allows only `BCP-47`_ language tags. (`LanguageTagConstraint`, pattern: `^(?:(?:[A-Za-z]{2,3}(?:-[A-Za-z]{3}){0,3}?)|(?:[A-Za-z]{4,8}))(?:-[A-Za-z]{4})?(?:-[A-Za-z]{2}|[0-9]{3})?(?:-(?:[A-Za-z0-9]{5,8}|[0-9][A-Za-z0-9]{3}))*(?:-[A-WY-Za-wy-z0-9](?:-[A-Za-z0-9]{2,8})+)*$`)
-
-## Used By
-
-- [`Division`](../divisions/division.md)
-- [`NameRule`](../common/name_rule.md)
-- [`Names`](../common/names.md)
-- [`CommonNames`](../common/common_names.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/no_whitespace_string.md b/schema_versioned_docs/version-v1.17.0/reference/system/no_whitespace_string.md
deleted file mode 100644
index ad2deca9b..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/system/no_whitespace_string.md
+++ /dev/null
@@ -1,13 +0,0 @@
-# NoWhitespaceString
-
-A string that contains no whitespace characters.
-
-Underlying type: `string`
-
-## Constraints
-
-- Allows only strings that contain no whitespace characters. (`NoWhitespaceConstraint`, pattern: `^\S+$`)
-
-## Used By
-
-- [`Id`](ref/id.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/phone_number.md b/schema_versioned_docs/version-v1.17.0/reference/system/phone_number.md
deleted file mode 100644
index 8bfed0469..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/system/phone_number.md
+++ /dev/null
@@ -1,13 +0,0 @@
-# PhoneNumber
-
-An international phone number.
-
-Underlying type: `string`
-
-## Constraints
-
-- Allows only international phone numbers. (`PhoneNumberConstraint`, pattern: `^\+\d{1,3}[\s\-\(\)0-9]+$`)
-
-## Used By
-
-- [`Place`](../places/place.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/primitive/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/system/primitive/_category_.json
deleted file mode 100644
index ee6c4309a..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/system/primitive/_category_.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-  "label": "Primitive"
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/primitive/geometry.md b/schema_versioned_docs/version-v1.17.0/reference/system/primitive/geometry.md
deleted file mode 100644
index 25d26fde7..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/system/primitive/geometry.md
+++ /dev/null
@@ -1,11 +0,0 @@
-# Geometry Types
-
-Spatial types for representing geographic features.
-
-## Types
-
-| Type | Description |
-| -----: | ------------- |
-| `Geometry` | GeoJSON geometry value (Point, LineString, Polygon, etc.) |
-| `BBox` | Bounding box as 4 or 6 coordinate values: [west, south, east, north] or [west, south, min-altitude, east, north, max-altitude] |
-| `GeometryType` | Enumeration of geometry types: `geometry_collection`, `line_string`, `multi_line_string`, `multi_point`, `multi_polygon`, `point`, `polygon` |
\ No newline at end of file
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/primitive/primitives.md b/schema_versioned_docs/version-v1.17.0/reference/system/primitive/primitives.md
deleted file mode 100644
index 8b0415a7d..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/system/primitive/primitives.md
+++ /dev/null
@@ -1,27 +0,0 @@
-# Primitive Types
-
-Numeric types used for schema field definitions.
-
-## Integer Types
-
-| Type | Range | Description |
-| -----: | :-----: | ------------- |
-| `int8` | -128 to 127 | Portable 8-bit signed integer. |
-| `int16` | -32,768 to 32,767 | Portable 16-bit signed integer. |
-| `int32` | -2,147,483,648 to 2,147,483,647 | Portable 32-bit signed integer. |
-| `int64` | -2^63 to 2^63-1 | Portable 64-bit signed integer. |
-
-## Unsigned Integer Types
-
-| Type | Range | Description |
-| -----: | :-----: | ------------- |
-| `uint8` | 0 to 255 | Portable 8-bit unsigned integer. |
-| `uint16` | 0 to 65,535 | Portable 16-bit unsigned integer. |
-| `uint32` | 0 to 4,294,967,295 | Portable 32-bit unsigned integer. |
-
-## Floating Point Types
-
-| Type | Precision | Description |
-| -----: | :---------: | ------------- |
-| `float32` | ~7 decimal digits | Portable IEEE 32-bit floating point number. |
-| `float64` | ~15 decimal digits | Portable IEEE 64-bit floating point number. |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/ref/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/system/ref/_category_.json
deleted file mode 100644
index a3d90fc8f..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/system/ref/_category_.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-  "label": "Ref"
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/ref/id.md b/schema_versioned_docs/version-v1.17.0/reference/system/ref/id.md
deleted file mode 100644
index 59a1fc75a..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/system/ref/id.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# Id
-
-A unique identifier.
-
-Underlying type: `string`
-
-## Constraints
-
-- Minimum length: 1
-- Allows only strings that contain no whitespace characters. (`NoWhitespaceConstraint`, pattern: `^\S+$`) (from [`NoWhitespaceString`](../no_whitespace_string.md))
-
-## Used By
-
-- [`Address`](../../addresses/address.md)
-- [`Bathymetry`](../../base/bathymetry.md)
-- [`Building`](../../buildings/building.md)
-- [`BuildingPart`](../../buildings/building_part.md)
-- [`CapitalOfDivisionItem`](../../divisions/types/capital_of_division_item.md)
-- [`Connector`](../../transportation/connector.md)
-- [`ConnectorReference`](../../transportation/types/connector_reference.md)
-- [`DestinationRule`](../../transportation/types/destination_rule.md)
-- [`Division`](../../divisions/division.md)
-- [`DivisionArea`](../../divisions/division_area.md)
-- [`DivisionBoundary`](../../divisions/division_boundary.md)
-- [`HierarchyItem`](../../divisions/types/hierarchy_item.md)
-- [`Infrastructure`](../../base/infrastructure.md)
-- [`Land`](../../base/land.md)
-- [`LandCover`](../../base/land_cover.md)
-- [`LandUse`](../../base/land_use.md)
-- [`Place`](../../places/place.md)
-- [`Segment`](../../transportation/segment.md)
-- [`SequenceEntry`](../../transportation/types/sequence_entry.md)
-- [`Water`](../../base/water.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/region_code.md b/schema_versioned_docs/version-v1.17.0/reference/system/region_code.md
deleted file mode 100644
index bf2f016ee..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/system/region_code.md
+++ /dev/null
@@ -1,16 +0,0 @@
-# RegionCode
-
-An ISO 3166-2 principal subdivision code.
-
-Underlying type: `string`
-
-## Constraints
-
-- Allows only ISO 3166-2 principal subdivision codes. (`RegionCodeConstraint`, pattern: `^[A-Z]{2}-[A-Z0-9]{1,3}$`)
-
-## Used By
-
-- [`Address`](../places/types/address.md)
-- [`Division`](../divisions/division.md)
-- [`DivisionArea`](../divisions/division_area.md)
-- [`DivisionBoundary`](../divisions/division_boundary.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/snake_case_string.md b/schema_versioned_docs/version-v1.17.0/reference/system/snake_case_string.md
deleted file mode 100644
index de08e7608..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/system/snake_case_string.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# SnakeCaseString
-
-A string that looks like a snake case identifier, like a Python variable name (*e.g.*, `foo_bar`).
-
-Underlying type: `string`
-
-## Constraints
-
-- Allows only strings that look like snake case identifiers, *e.g.* `"foo_bar"`. (`SnakeCaseConstraint`, pattern: `^[a-z0-9]+(_[a-z0-9]+)*$`)
-
-## Used By
-
-- [`Categories`](../places/types/categories.md)
-- [`Place`](../places/place.md)
-- [`Taxonomy`](../places/types/taxonomy.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/stripped_string.md b/schema_versioned_docs/version-v1.17.0/reference/system/stripped_string.md
deleted file mode 100644
index 5600ca2d7..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/system/stripped_string.md
+++ /dev/null
@@ -1,22 +0,0 @@
-# StrippedString
-
-A string without leading or trailing whitespace.
-
-Underlying type: `string`
-
-## Constraints
-
-- Allows only strings that have no leading/trailing whitespace. (`StrippedConstraint`, pattern: `^(\S(.*\S)?)?\Z`)
-
-## Used By
-
-- [`Address`](../addresses/address.md)
-- [`AddressLevel`](../addresses/types/address_level.md)
-- [`DestinationLabels`](../transportation/types/destination_labels.md)
-- [`Division`](../divisions/division.md)
-- [`HierarchyItem`](../divisions/types/hierarchy_item.md)
-- [`NameRule`](../common/name_rule.md)
-- [`Names`](../common/names.md)
-- [`RouteReference`](../transportation/types/route_reference.md)
-- [`SourceItem`](../common/source_item.md)
-- [`CommonNames`](../common/common_names.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/system/wikidata_id.md b/schema_versioned_docs/version-v1.17.0/reference/system/wikidata_id.md
deleted file mode 100644
index ebef7cee6..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/system/wikidata_id.md
+++ /dev/null
@@ -1,23 +0,0 @@
-# WikidataId
-
-A wikidata ID, as found on [https://www.wikidata.org/](https://www.wikidata.org/).
-
-- `"Q42"`
-- `"Q11643"`
-- `"Q116257497"`
-
-Underlying type: `string`
-
-## Constraints
-
-- Allows only Wikidata identifiers (Q followed by digits). (`WikidataIdConstraint`, pattern: `^Q\d+$`)
-
-## Used By
-
-- [`Brand`](../places/types/brand.md)
-- [`Division`](../divisions/division.md)
-- [`Infrastructure`](../base/infrastructure.md)
-- [`Land`](../base/land.md)
-- [`LandUse`](../base/land_use.md)
-- [`RouteReference`](../transportation/types/route_reference.md)
-- [`Water`](../base/water.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/transportation/_category_.json
deleted file mode 100644
index 597025adb..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/_category_.json
+++ /dev/null
@@ -1,4 +0,0 @@
-{
-  "label": "Transportation",
-  "position": 6
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/connector.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/connector.md
deleted file mode 100644
index 206899f2e..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/connector.md
+++ /dev/null
@@ -1,49 +0,0 @@
----
-sidebar_position: 1
----
-
-# Connector
-
-Connectors create physical connections between segments.
-
-Connectors are compatible with GeoJSON Point features.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
-| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
-| `geometry` | [`geometry`](../system/primitive/geometry.md) | Position of the connector<br/><br/>*Allowed geometry types: Point* |
-| `theme` | `"transportation"` | |
-| `type` | `"connector"` | |
-| `version` | [`FeatureVersion`](../common/feature_version.md) | |
-| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
-| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
-| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
-| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
-| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
-| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
-| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
-| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
-
-## Examples
-
-| Column | Value |
-| -------: | ------- |
-| `id` | `39542bee-230f-4b91-b7e5-a9b58e0c59b1` |
-| `bbox.xmin` | `-176.54730224609375` |
-| `bbox.ymin` | `-43.96794891357422` |
-| `bbox.xmax` | `-176.54727172851562` |
-| `bbox.ymax` | `-43.96794128417969` |
-| `geometry` | `POINT (-176.5472979 -43.9679472)` |
-| `theme` | `transportation` |
-| `type` | `connector` |
-| `version` | `1` |
-| `sources[0].property` |  |
-| `sources[0].dataset` | `OpenStreetMap` |
-| `sources[0].license` | `null` |
-| `sources[0].record_id` | `null` |
-| `sources[0].update_time` | `null` |
-| `sources[0].confidence` | `null` |
-| `sources[0].between` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/segment.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/segment.md
deleted file mode 100644
index 1db0d2c4a..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/segment.md
+++ /dev/null
@@ -1,168 +0,0 @@
----
-sidebar_position: 1
----
-
-# Segment
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `id` | [`Id`](../system/ref/id.md) | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
-| `bbox` | [`bbox`](../system/primitive/geometry.md) (optional) | An optional bounding box for the feature |
-| `geometry` | [`geometry`](../system/primitive/geometry.md) | Segment centerline<br/><br/>*Allowed geometry types: LineString* |
-| `theme` | `"transportation"` | |
-| `type` | `"segment"` | |
-| `version` | [`FeatureVersion`](../common/feature_version.md) | |
-| `sources[]` | [`Sources`](../common/sources.md) (list, optional) | Information about the source data used to assemble the feature. |
-| `sources[].property` | [`JsonPointer`](../system/json_pointer.md) | A JSON Pointer identifying the property (field) that this source information applies to.<br/><br/>The root document value `""` indicates that this source information applies to the entire feature, excepting properties (fields) for which a dedicated source information record exists.<br/><br/>Any other JSON Pointer apart from `""` indicates that this source record provides dedicated source information for the property at the path in the JSON Pointer. As an example, the value `"/names/common/en"` indicates that the source information applies to the English common name of a named feature, while the value `"/geometry"` indicates that it applies to the feature geometry. |
-| `sources[].dataset` | `string` | Name of the dataset where the source data can be found. |
-| `sources[].license` | [`StrippedString`](../system/stripped_string.md) (optional) | Source data license name.<br/><br/>This should be a valid SPDX license identifier when available.<br/><br/>If omitted, contact the data provider for more license information. |
-| `sources[].record_id` | `string` (optional) | Identifies the specific record within the source dataset where the source data can be found.<br/><br/>The format of record identifiers is dataset-specific. |
-| `sources[].update_time` | `datetime` (optional) | Last update time of the source data record. |
-| `sources[].confidence` | [`ConfidenceScore`](../common/confidence_score.md) (optional) | Confidence value from the source dataset.<br/><br/>This is a value between 0.0 and 1.0 and is particularly relevant for ML-derived data. |
-| `sources[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SourceItem applies to. |
-| `subtype` | [`Subtype`](types/subtype.md) | Broad category of transportation segment. |
-| `access_restrictions[]` | [`AccessRules`](types/access_rules.md) (list, optional) | Rules governing access to this road segment |
-| `access_restrictions[].access_type` | [`AccessType`](types/access_type.md) | |
-| `access_restrictions[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing AccessRestrictionRule applies to. |
-| `access_restrictions[].when` | [`AccessRestrictionRule.When`](types/access_restriction_rule.when.md) (optional) | Scopes for AccessRestrictionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
-| `access_restrictions[].when.heading` | [`Heading`](../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing AccessRestrictionRule applies to. |
-| `access_restrictions[].when.during` | [`OpeningHours`](../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing AccessRestrictionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
-| `access_restrictions[].when.mode` | `list<`[`TravelMode`](../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing AccessRestrictionRule applies to. |
-| `access_restrictions[].when.using` | `list<`[`PurposeOfUse`](../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing AccessRestrictionRule applies to. |
-| `access_restrictions[].when.recognized` | `list<`[`RecognizedStatus`](../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing AccessRestrictionRule applies to. |
-| `access_restrictions[].when.vehicle` | [`VehicleAxleCountSelector`](../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing AccessRestrictionRule applies to. |
-| `connectors[]` | `list<`[`ConnectorReference`](types/connector_reference.md)`>` (optional) | List of connectors which this segment is physically connected to and their relative location. Each connector is a possible routing decision point, meaning it defines a place along the segment in which there is possibility to transition to other segments which share the same connector.<br/><br/>*Minimum length: 2*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
-| `connectors[].connector_id` | [`Id`](../system/ref/id.md) | A unique identifier |
-| `connectors[].at` | [`LinearlyReferencedPosition`](../common/scoping/linearly_referenced_position.md) (optional) | The linearly-referenced position on the geometry, specified as a percentage displacement from the start of the geometry, that the containing ConnectorReference applies to. |
-| `level_rules[]` | [`LevelRules`](types/level_rules.md) (list, optional) | Defines the Z-order, i.e. stacking order, of the road segment. |
-| `level_rules[].value` | [`Level`](../common/level.md) | Z-order of the feature where 0 is visual level |
-| `level_rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing LevelRule applies to. |
-| `routes[]` | [`Routes`](types/routes.md) (list, optional) | Routes this segment belongs to |
-| `routes[].name` | [`StrippedString`](../system/stripped_string.md) (optional) | Full name of the route |
-| `routes[].network` | [`StrippedString`](../system/stripped_string.md) (optional) | Name of the highway system this route belongs to |
-| `routes[].ref` | [`StrippedString`](../system/stripped_string.md) (optional) | Code or number used to reference the route |
-| `routes[].symbol` | [`StrippedString`](../system/stripped_string.md) (optional) | URL or description of route signage |
-| `routes[].wikidata` | [`WikidataId`](../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
-| `routes[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RouteReference applies to. |
-| `subclass_rules[]` | [`SubclassRules`](types/subclass_rules.md) (list, optional) | Set of subclasses scoped along segment |
-| `subclass_rules[].value` | [`Subclass`](types/subclass.md) | |
-| `subclass_rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SubclassRule applies to. |
-| `names` | [`Names`](../common/names.md) (optional) | All known names by which the feature is called |
-| `names.primary` | [`StrippedString`](../system/stripped_string.md) | The most commonly used name. |
-| `names.common` | [`CommonNames`](../common/common_names.md) (map, optional) | |
-| `names.rules[]` | `list<`[`NameRule`](../common/name_rule.md)`>` (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
-| `names.rules[].value` | [`StrippedString`](../system/stripped_string.md) | The actual name value. |
-| `names.rules[].variant` | [`NameVariant`](../common/name_variant.md) | The name variant for this name rule. |
-| `names.rules[].language` | [`LanguageTag`](../system/language_tag.md) (optional) | The language in which the name `value` is specified, if known, as an IETF BCP 47 language tag. |
-| `names.rules[].perspectives` | [`Perspectives`](../common/perspectives.md) (optional) | Political perspectives from which a named feature is viewed. |
-| `names.rules[].perspectives.mode` | [`PerspectiveMode`](../common/perspective_mode.md) | Whether the perspective holder accepts or disputes this name. |
-| `names.rules[].perspectives.countries` | `list<`[`CountryCodeAlpha2`](../system/country_code_alpha2.md)`>` | Countries holding the given mode of perspective. |
-| `names.rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing NameRule applies to. |
-| `names.rules[].side` | [`Side`](../common/scoping/side.md) (optional) | The side, either left or right, that the containing NameRule applies to. |
-| `class` *(Road)* | [`RoadClass`](types/road_class.md) | |
-| `destinations[]` *(Road)* | [`Destinations`](types/destinations.md) (list, optional) | Describes objects that can be reached by following a transportation segment in the same way those objects are described on signposts or ground writing that a traveller following the segment would observe in the real world. This allows navigation systems to refer to signs and observable writing that a traveller actually sees. |
-| `destinations[].from_connector_id` | [`Id`](../system/ref/id.md) | Identifies the point of physical connection on this segment before which the destination sign or marking is visible. |
-| `destinations[].to_connector_id` | [`Id`](../system/ref/id.md) | Identifies the point of physical connection on the segment identified by 'to_segment_id' to transition to for reaching the destination(s). |
-| `destinations[].to_segment_id` | [`Id`](../system/ref/id.md) | Identifies the segment to transition to reach the destination(s) labeled on the sign or marking. |
-| `destinations[].final_heading` | [`Heading`](../common/scoping/heading.md) | Direction of travel on the segment identified by 'to_segment_id' that leads to the destination. |
-| `destinations[].labels[]` | `list<`[`DestinationLabels`](types/destination_labels.md)`>` (optional) | Labeled destinations that can be reached by following the segment. |
-| `destinations[].labels[].value` | [`StrippedString`](../system/stripped_string.md) | Names the object that is reached |
-| `destinations[].labels[].type` | [`DestinationLabelType`](types/destination_label_type.md) | |
-| `destinations[].symbols` | `list<`[`DestinationSignSymbol`](types/destination_sign_symbol.md)`>` (optional) | A collection of symbols or icons present on the sign next to current destination label. |
-| `destinations[].when` | [`DestinationRule.When`](types/destination_rule.when.md) (optional) | Scope for DestinationRule: |
-| `destinations[].when.heading` | [`Heading`](../common/scoping/heading.md) | The heading, either forward or backward, that the containing DestinationRule applies to. |
-| `prohibited_transitions[]` *(Road)* | [`ProhibitedTransitions`](types/prohibited_transitions.md) (list, optional) | Rules preventing transitions from this segment to another segment. |
-| `prohibited_transitions[].sequence[]` | `list<`[`SequenceEntry`](types/sequence_entry.md)`>` | Ordered sequence of connector/segment pairs that it is prohibited to follow from this segment. |
-| `prohibited_transitions[].sequence[].connector_id` | [`Id`](../system/ref/id.md) | Identifies the point of physical connection between the previous segment in the sequence and the segment in this sequence entry. |
-| `prohibited_transitions[].sequence[].segment_id` | [`Id`](../system/ref/id.md) | Identifies the segment that the previous segment in the sequence is physically connected to via the sequence entry's connector. |
-| `prohibited_transitions[].final_heading` | [`Heading`](../common/scoping/heading.md) | Direction of travel that is prohibited on the destination segment of the sequence. |
-| `prohibited_transitions[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing ProhibitedTransitionRule applies to. |
-| `prohibited_transitions[].when` | [`ProhibitedTransitionRule.When`](types/prohibited_transition_rule.when.md) (optional) | Scopes for ProhibitedTransitionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
-| `prohibited_transitions[].when.heading` | [`Heading`](../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing ProhibitedTransitionRule applies to. |
-| `prohibited_transitions[].when.during` | [`OpeningHours`](../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing ProhibitedTransitionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
-| `prohibited_transitions[].when.mode` | `list<`[`TravelMode`](../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing ProhibitedTransitionRule applies to. |
-| `prohibited_transitions[].when.using` | `list<`[`PurposeOfUse`](../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing ProhibitedTransitionRule applies to. |
-| `prohibited_transitions[].when.recognized` | `list<`[`RecognizedStatus`](../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing ProhibitedTransitionRule applies to. |
-| `prohibited_transitions[].when.vehicle` | [`VehicleAxleCountSelector`](../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing ProhibitedTransitionRule applies to. |
-| `road_flags[]` *(Road)* | [`RoadFlags`](types/road_flags.md) (list, optional) | Set of boolean attributes applicable to roads. May be specified either as a single flag array of flag values, or as an array of flag rules. |
-| `road_flags[].values` | `list<`[`RoadFlag`](types/road_flag.md)`>` | |
-| `road_flags[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RoadFlagRule applies to. |
-| `road_surface[]` *(Road)* | [`Surfaces`](types/surfaces.md) (list, optional) | Physical surface of the road. May either be specified as a single global value for the segment, or as an array of surface rules. |
-| `road_surface[].value` | [`RoadSurface`](types/road_surface.md) | |
-| `road_surface[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SurfaceRule applies to. |
-| `speed_limits[]` *(Road)* | [`SpeedLimits`](types/speed_limits.md) (list, optional) | Rules governing speed on this road segment |
-| `speed_limits[].max_speed` | [`Speed`](types/speed.md) (optional) | |
-| `speed_limits[].max_speed.value` | [`SpeedValue`](types/speed_value.md) | Speed value |
-| `speed_limits[].max_speed.unit` | [`SpeedUnit`](../common/speed_unit.md) | |
-| `speed_limits[].min_speed` | [`Speed`](types/speed.md) (optional) | |
-| `speed_limits[].min_speed.value` | [`SpeedValue`](types/speed_value.md) | Speed value |
-| `speed_limits[].min_speed.unit` | [`SpeedUnit`](../common/speed_unit.md) | |
-| `speed_limits[].is_max_speed_variable` | `boolean` (optional) | Indicates a variable speed corridor |
-| `speed_limits[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SpeedLimitRule applies to. |
-| `speed_limits[].when` | [`SpeedLimitRule.When`](types/speed_limit_rule.when.md) (optional) | Scopes for SpeedLimitRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
-| `speed_limits[].when.heading` | [`Heading`](../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing SpeedLimitRule applies to. |
-| `speed_limits[].when.during` | [`OpeningHours`](../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing SpeedLimitRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
-| `speed_limits[].when.mode` | `list<`[`TravelMode`](../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing SpeedLimitRule applies to. |
-| `speed_limits[].when.using` | `list<`[`PurposeOfUse`](../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing SpeedLimitRule applies to. |
-| `speed_limits[].when.recognized` | `list<`[`RecognizedStatus`](../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing SpeedLimitRule applies to. |
-| `speed_limits[].when.vehicle` | [`VehicleAxleCountSelector`](../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing SpeedLimitRule applies to. |
-| `subclass` *(Road)* | [`Subclass`](types/subclass.md) (optional) | |
-| `width_rules[]` *(Road)* | [`WidthRules`](types/width_rules.md) (list, optional) | Edge-to-edge width of the road modeled by this segment, in meters.<br/><br/>Examples: (1) If this segment models a carriageway without sidewalk, this value represents the edge-to-edge width of the carriageway, inclusive of any shoulder. (2) If this segment models a sidewalk by itself, this value represents the edge-to-edge width of the sidewalk. (3) If this segment models a combined sidewalk and carriageway, this value represents the edge-to-edge width inclusive of sidewalk. |
-| `width_rules[].value` | [`Width`](types/width.md) | |
-| `width_rules[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing WidthRule applies to. |
-| `class` *(Rail)* | [`RailClass`](types/rail_class.md) | |
-| `rail_flags[]` *(Rail)* | [`RailFlags`](types/rail_flags.md) (list, optional) | Set of boolean attributes applicable to railways. May be specified either as a single flag array of flag values, or as an array of flag rules. |
-| `rail_flags[].values` | `list<`[`RailFlag`](types/rail_flag.md)`>` | |
-| `rail_flags[].between` | [`LinearlyReferencedRange`](../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RailFlagRule applies to. |
-
-## Examples
-
-| Column | Value |
-| -------: | ------- |
-| `id` | `1bc62f3b-08b5-42b8-89fe-36f685f60455` |
-| `bbox.xmin` | `-176.5650177001953` |
-| `bbox.ymin` | `-43.954410552978516` |
-| `bbox.xmax` | `-176.56361389160156` |
-| `bbox.ymax` | `-43.953250885009766` |
-| `geometry` | `LINESTRING (-176.5636191 -43.954404, -176.5643637 -43.9538145, -176.5647264 -43.9535274, -176.564...` |
-| `theme` | `transportation` |
-| `type` | `segment` |
-| `version` | `1` |
-| `sources[0].property` |  |
-| `sources[0].dataset` | `OpenStreetMap` |
-| `sources[0].license` | `null` |
-| `sources[0].record_id` | `w53435546@6` |
-| `sources[0].update_time` | `2021-05-03T06:37:03+00:00` |
-| `sources[0].confidence` | `null` |
-| `sources[0].between` | `null` |
-| `subtype` | `road` |
-| `access_restrictions` | `null` |
-| `connectors[0].connector_id` | `15b2c131-9137-4add-88c6-2acd3fa61355` |
-| `connectors[0].at` | `0.0` |
-| `connectors[1].connector_id` | `23ae2702-ef77-4d2e-b39d-77360b696d20` |
-| `connectors[1].at` | `0.523536154` |
-| `connectors[2].connector_id` | `8e944ce1-4b81-49eb-a823-7d98779c855c` |
-| `connectors[2].at` | `1.0` |
-| `level_rules` | `null` |
-| `routes` | `null` |
-| `subclass_rules` | `null` |
-| `names.primary` | `Meteorological Lane` |
-| `names.common` | `null` |
-| `destinations` | `null` |
-| `prohibited_transitions` | `null` |
-| `road_flags` | `null` |
-| `road_surface[0].value` | `gravel` |
-| `road_surface[0].between` | `null` |
-| `speed_limits` | `null` |
-| `subclass` | `null` |
-| `width_rules` | `null` |
-| `class` | `residential` |
-| `rail_flags` | `null` |
-| `names.rules[0].value` | `Meteorological Lane` |
-| `names.rules[0].variant` | `common` |
-| `names.rules[0].language` | `null` |
-| `names.rules[0].perspectives` | `null` |
-| `names.rules[0].between` | `null` |
-| `names.rules[0].side` | `null` |
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/_category_.json b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/_category_.json
deleted file mode 100644
index a3ec08974..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/_category_.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-  "label": "Types"
-}
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_restriction_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_restriction_rule.md
deleted file mode 100644
index 8324d767c..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_restriction_rule.md
+++ /dev/null
@@ -1,20 +0,0 @@
-# AccessRestrictionRule
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `access_type` | [`AccessType`](access_type.md) | |
-| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing AccessRestrictionRule applies to. |
-| `when` | [`AccessRestrictionRule.When`](access_restriction_rule.when.md) (optional) | Scopes for AccessRestrictionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
-| `when.heading` | [`Heading`](../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing AccessRestrictionRule applies to. |
-| `when.during` | [`OpeningHours`](../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing AccessRestrictionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
-| `when.mode` | `list<`[`TravelMode`](../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing AccessRestrictionRule applies to. |
-| `when.using` | `list<`[`PurposeOfUse`](../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing AccessRestrictionRule applies to. |
-| `when.recognized` | `list<`[`RecognizedStatus`](../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing AccessRestrictionRule applies to. |
-| `when.vehicle` | [`VehicleAxleCountSelector`](../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing AccessRestrictionRule applies to. |
-
-## Used By
-
-- [`Segment`](../segment.md)
-- [`AccessRules`](access_rules.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_restriction_rule.when.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_restriction_rule.when.md
deleted file mode 100644
index 780d8ef3e..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_restriction_rule.when.md
+++ /dev/null
@@ -1,22 +0,0 @@
-# AccessRestrictionRule.When
-
-Scopes for AccessRestrictionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `heading` | [`Heading`](../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing AccessRestrictionRule applies to.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
-| `during` | [`OpeningHours`](../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing AccessRestrictionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
-| `mode` | `list<`[`TravelMode`](../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing AccessRestrictionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
-| `using` | `list<`[`PurposeOfUse`](../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing AccessRestrictionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
-| `recognized` | `list<`[`RecognizedStatus`](../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing AccessRestrictionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
-| `vehicle` | [`VehicleAxleCountSelector`](../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing AccessRestrictionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
-
-## Constraints
-
-- At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set
-
-## Used By
-
-- [`AccessRestrictionRule`](access_restriction_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_rules.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_rules.md
deleted file mode 100644
index 1f3341a71..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_rules.md
+++ /dev/null
@@ -1,14 +0,0 @@
-# AccessRules
-
-Rules governing access to this road segment
-
-Underlying type: `list<`[`AccessRestrictionRule`](access_restriction_rule.md)`>`
-
-## Constraints
-
-- Minimum length: 1
-- All items must be unique. (`UniqueItemsConstraint`)
-
-## Used By
-
-- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_type.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_type.md
deleted file mode 100644
index e77c8ab8a..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/access_type.md
+++ /dev/null
@@ -1,11 +0,0 @@
-# AccessType
-
-## Values
-
-- `allowed`
-- `denied`
-- `designated`
-
-## Used By
-
-- [`AccessRestrictionRule`](access_restriction_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/connector_reference.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/connector_reference.md
deleted file mode 100644
index 632eed33a..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/connector_reference.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# ConnectorReference
-
-Contains the GERS ID and relative position between 0 and 1 of a connector feature along the
-segment.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `connector_id` | [`Id`](../../system/ref/id.md) | A unique identifier<br/><br/>*References [`Connector`](../connector.md) (association, connects to)* |
-| `at` | [`LinearlyReferencedPosition`](../../common/scoping/linearly_referenced_position.md) (optional) | The linearly-referenced position on the geometry, specified as a percentage displacement from the start of the geometry, that the containing ConnectorReference applies to. |
-
-## Used By
-
-- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_label_type.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_label_type.md
deleted file mode 100644
index cf2ccb11f..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_label_type.md
+++ /dev/null
@@ -1,16 +0,0 @@
-# DestinationLabelType
-
-Indicates what special symbol/icon is present on a signpost, visible as road marking or
-similar.
-
-## Values
-
-- `street`
-- `country`
-- `route_ref`
-- `toward_route_ref`
-- `unknown`
-
-## Used By
-
-- [`DestinationLabels`](destination_labels.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_labels.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_labels.md
deleted file mode 100644
index 578aaaace..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_labels.md
+++ /dev/null
@@ -1,14 +0,0 @@
-# DestinationLabels
-
-The type of object of the destination label.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `value` | [`StrippedString`](../../system/stripped_string.md) | Names the object that is reached<br/><br/>*Minimum length: 1* |
-| `type` | [`DestinationLabelType`](destination_label_type.md) | |
-
-## Used By
-
-- [`DestinationRule`](destination_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_rule.md
deleted file mode 100644
index 2c340c56e..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_rule.md
+++ /dev/null
@@ -1,25 +0,0 @@
-# DestinationRule
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `from_connector_id` | [`Id`](../../system/ref/id.md) | Identifies the point of physical connection on this segment before which the destination sign or marking is visible. |
-| `to_connector_id` | [`Id`](../../system/ref/id.md) | Identifies the point of physical connection on the segment identified by 'to_segment_id' to transition to for reaching the destination(s). |
-| `to_segment_id` | [`Id`](../../system/ref/id.md) | Identifies the segment to transition to reach the destination(s) labeled on the sign or marking. |
-| `final_heading` | [`Heading`](../../common/scoping/heading.md) | Direction of travel on the segment identified by 'to_segment_id' that leads to the destination. |
-| `labels[]` | `list<`[`DestinationLabels`](destination_labels.md)`>` (optional) | Labeled destinations that can be reached by following the segment.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `labels`, `symbols` must be set* |
-| `labels[].value` | [`StrippedString`](../../system/stripped_string.md) | Names the object that is reached |
-| `labels[].type` | [`DestinationLabelType`](destination_label_type.md) | |
-| `symbols` | `list<`[`DestinationSignSymbol`](destination_sign_symbol.md)`>` (optional) | A collection of symbols or icons present on the sign next to current destination label.<br/><br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `labels`, `symbols` must be set* |
-| `when` | [`DestinationRule.When`](destination_rule.when.md) (optional) | Scope for DestinationRule: |
-| `when.heading` | [`Heading`](../../common/scoping/heading.md) | The heading, either forward or backward, that the containing DestinationRule applies to. |
-
-## Constraints
-
-- At least one of `labels`, `symbols` must be set
-
-## Used By
-
-- [`Segment`](../segment.md)
-- [`Destinations`](destinations.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_rule.when.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_rule.when.md
deleted file mode 100644
index 0d48f31f3..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_rule.when.md
+++ /dev/null
@@ -1,13 +0,0 @@
-# DestinationRule.When
-
-Scope for DestinationRule: 
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `heading` | [`Heading`](../../common/scoping/heading.md) | The heading, either forward or backward, that the containing DestinationRule applies to. |
-
-## Used By
-
-- [`DestinationRule`](destination_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_sign_symbol.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_sign_symbol.md
deleted file mode 100644
index ec81dbe19..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destination_sign_symbol.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# DestinationSignSymbol
-
-Indicates what special symbol/icon is present on a signpost, visible as road marking or
-similar.
-
-## Values
-
-- `motorway`
-- `airport`
-- `hospital`
-- `center`
-- `industrial`
-- `parking`
-- `bus`
-- `train_station`
-- `rest_area`
-- `ferry`
-- `motorroad`
-- `fuel`
-- `viewpoint`
-- `fuel_diesel`
-- `food`
-- `lodging`
-- `info`
-- `camp_site`
-- `interchange`
-- `restrooms`
-
-## Used By
-
-- [`DestinationRule`](destination_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destinations.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destinations.md
deleted file mode 100644
index d2c434eb6..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/destinations.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# Destinations
-
-Describes objects that can be reached by following a transportation segment in the same way those objects are described on signposts or ground writing that a traveller following the segment would observe in the real world. This allows navigation systems to refer to signs and observable writing that a traveller actually sees.
-
-Underlying type: `list<`[`DestinationRule`](destination_rule.md)`>`
-
-## Used By
-
-- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/level_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/level_rule.md
deleted file mode 100644
index 1612c0b2e..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/level_rule.md
+++ /dev/null
@@ -1,16 +0,0 @@
-# LevelRule
-
-A single level rule defining the Z-order, i.e. stacking order, applicable within a given scope
-on the road segment.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `value` | [`Level`](../../common/level.md) | Z-order of the feature where 0 is visual level |
-| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing LevelRule applies to. |
-
-## Used By
-
-- [`Segment`](../segment.md)
-- [`LevelRules`](level_rules.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/level_rules.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/level_rules.md
deleted file mode 100644
index f95284be6..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/level_rules.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# LevelRules
-
-Defines the Z-order, i.e. stacking order, of the road segment.
-
-Underlying type: `list<`[`LevelRule`](level_rule.md)`>`
-
-## Used By
-
-- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transition_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transition_rule.md
deleted file mode 100644
index a78a45c03..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transition_rule.md
+++ /dev/null
@@ -1,23 +0,0 @@
-# ProhibitedTransitionRule
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `sequence[]` | `list<`[`SequenceEntry`](sequence_entry.md)`>` | Ordered sequence of connector/segment pairs that it is prohibited to follow from this segment.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
-| `sequence[].connector_id` | [`Id`](../../system/ref/id.md) | Identifies the point of physical connection between the previous segment in the sequence and the segment in this sequence entry. |
-| `sequence[].segment_id` | [`Id`](../../system/ref/id.md) | Identifies the segment that the previous segment in the sequence is physically connected to via the sequence entry's connector. |
-| `final_heading` | [`Heading`](../../common/scoping/heading.md) | Direction of travel that is prohibited on the destination segment of the sequence. |
-| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing ProhibitedTransitionRule applies to. |
-| `when` | [`ProhibitedTransitionRule.When`](prohibited_transition_rule.when.md) (optional) | Scopes for ProhibitedTransitionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
-| `when.heading` | [`Heading`](../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing ProhibitedTransitionRule applies to. |
-| `when.during` | [`OpeningHours`](../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing ProhibitedTransitionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
-| `when.mode` | `list<`[`TravelMode`](../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing ProhibitedTransitionRule applies to. |
-| `when.using` | `list<`[`PurposeOfUse`](../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing ProhibitedTransitionRule applies to. |
-| `when.recognized` | `list<`[`RecognizedStatus`](../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing ProhibitedTransitionRule applies to. |
-| `when.vehicle` | [`VehicleAxleCountSelector`](../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing ProhibitedTransitionRule applies to. |
-
-## Used By
-
-- [`Segment`](../segment.md)
-- [`ProhibitedTransitions`](prohibited_transitions.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transition_rule.when.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transition_rule.when.md
deleted file mode 100644
index 1c38a5d60..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transition_rule.when.md
+++ /dev/null
@@ -1,22 +0,0 @@
-# ProhibitedTransitionRule.When
-
-Scopes for ProhibitedTransitionRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `heading` | [`Heading`](../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing ProhibitedTransitionRule applies to.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
-| `during` | [`OpeningHours`](../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing ProhibitedTransitionRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
-| `mode` | `list<`[`TravelMode`](../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing ProhibitedTransitionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
-| `using` | `list<`[`PurposeOfUse`](../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing ProhibitedTransitionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
-| `recognized` | `list<`[`RecognizedStatus`](../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing ProhibitedTransitionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
-| `vehicle` | [`VehicleAxleCountSelector`](../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing ProhibitedTransitionRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
-
-## Constraints
-
-- At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set
-
-## Used By
-
-- [`ProhibitedTransitionRule`](prohibited_transition_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transitions.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transitions.md
deleted file mode 100644
index 2a4a5179e..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/prohibited_transitions.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# ProhibitedTransitions
-
-Rules preventing transitions from this segment to another segment.
-
-Underlying type: `list<`[`ProhibitedTransitionRule`](prohibited_transition_rule.md)`>`
-
-## Used By
-
-- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_class.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_class.md
deleted file mode 100644
index c43bb6a6a..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_class.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# RailClass
-
-Captures the kind of rail segment.
-
-## Values
-
-- `funicular`
-- `light_rail`
-- `monorail`
-- `narrow_gauge`
-- `standard_gauge`
-- `subway`
-- `tram`
-- `unknown`
-
-## Used By
-
-- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flag.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flag.md
deleted file mode 100644
index 9316a8129..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flag.md
+++ /dev/null
@@ -1,20 +0,0 @@
-# RailFlag
-
-Simple flags that can be on or off for a railway segment.
-
-Specifies physical characteristics and can overlap.
-
-## Values
-
-- `is_bridge`
-- `is_tunnel`
-- `is_under_construction`
-- `is_abandoned`
-- `is_covered`
-- `is_passenger`
-- `is_freight`
-- `is_disused`
-
-## Used By
-
-- [`RailFlagRule`](rail_flag_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flag_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flag_rule.md
deleted file mode 100644
index 52273bde4..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flag_rule.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# RailFlagRule
-
-Rail-specific flag rule with geometric scoping only.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `values` | `list<`[`RailFlag`](rail_flag.md)`>` | *Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
-| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RailFlagRule applies to. |
-
-## Used By
-
-- [`Segment`](../segment.md)
-- [`RailFlags`](rail_flags.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flags.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flags.md
deleted file mode 100644
index 806331852..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/rail_flags.md
+++ /dev/null
@@ -1,14 +0,0 @@
-# RailFlags
-
-Set of boolean attributes applicable to railways. May be specified either as a single flag array of flag values, or as an array of flag rules.
-
-Underlying type: `list<`[`RailFlagRule`](rail_flag_rule.md)`>`
-
-## Constraints
-
-- Minimum length: 1
-- All items must be unique. (`UniqueItemsConstraint`)
-
-## Used By
-
-- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_class.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_class.md
deleted file mode 100644
index d18b7735a..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_class.md
+++ /dev/null
@@ -1,27 +0,0 @@
-# RoadClass
-
-Captures the kind of road and its position in the road network hierarchy.
-
-## Values
-
-- `motorway`
-- `primary`
-- `secondary`
-- `tertiary`
-- `residential`
-- `living_street`
-- `trunk`
-- `unclassified`
-- `service`
-- `pedestrian`
-- `footway`
-- `steps`
-- `path`
-- `track`
-- `cycleway`
-- `bridleway`
-- `unknown`
-
-## Used By
-
-- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flag.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flag.md
deleted file mode 100644
index a2448e725..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flag.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# RoadFlag
-
-Simple flags that can be on or off for a road segment.
-
-Specifies physical characteristics and can overlap.
-
-## Values
-
-- `is_bridge`
-- `is_link`
-- `is_tunnel`
-- `is_under_construction`
-- `is_abandoned`
-- `is_covered`
-- `is_indoor`
-
-## Used By
-
-- [`RoadFlagRule`](road_flag_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flag_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flag_rule.md
deleted file mode 100644
index 4ff3120c9..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flag_rule.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# RoadFlagRule
-
-Road-specific flag rule with geometric scoping only.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `values` | `list<`[`RoadFlag`](road_flag.md)`>` | *Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)* |
-| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RoadFlagRule applies to. |
-
-## Used By
-
-- [`Segment`](../segment.md)
-- [`RoadFlags`](road_flags.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flags.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flags.md
deleted file mode 100644
index 88445c57d..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_flags.md
+++ /dev/null
@@ -1,14 +0,0 @@
-# RoadFlags
-
-Set of boolean attributes applicable to roads. May be specified either as a single flag array of flag values, or as an array of flag rules.
-
-Underlying type: `list<`[`RoadFlagRule`](road_flag_rule.md)`>`
-
-## Constraints
-
-- Minimum length: 1
-- All items must be unique. (`UniqueItemsConstraint`)
-
-## Used By
-
-- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_surface.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_surface.md
deleted file mode 100644
index 6ac837769..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/road_surface.md
+++ /dev/null
@@ -1,17 +0,0 @@
-# RoadSurface
-
-Physical surface of the road.
-
-## Values
-
-- `unknown`
-- `paved`
-- `unpaved`
-- `gravel`
-- `dirt`
-- `paving_stones`
-- `metal`
-
-## Used By
-
-- [`SurfaceRule`](surface_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/route_reference.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/route_reference.md
deleted file mode 100644
index 4433bcf41..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/route_reference.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# RouteReference
-
-Route reference with linear referencing support.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `name` | [`StrippedString`](../../system/stripped_string.md) (optional) | Full name of the route<br/><br/>*Minimum length: 1* |
-| `network` | [`StrippedString`](../../system/stripped_string.md) (optional) | Name of the highway system this route belongs to<br/><br/>*Minimum length: 1* |
-| `ref` | [`StrippedString`](../../system/stripped_string.md) (optional) | Code or number used to reference the route<br/><br/>*Minimum length: 1* |
-| `symbol` | [`StrippedString`](../../system/stripped_string.md) (optional) | URL or description of route signage<br/><br/>*Minimum length: 1* |
-| `wikidata` | [`WikidataId`](../../system/wikidata_id.md) (optional) | A wikidata ID, as found on https://www.wikidata.org/ |
-| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing RouteReference applies to. |
-
-## Used By
-
-- [`Segment`](../segment.md)
-- [`Routes`](routes.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/routes.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/routes.md
deleted file mode 100644
index 72143b256..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/routes.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# Routes
-
-Routes this segment belongs to
-
-Underlying type: `list<`[`RouteReference`](route_reference.md)`>`
-
-## Used By
-
-- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/sequence_entry.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/sequence_entry.md
deleted file mode 100644
index 859b96c5c..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/sequence_entry.md
+++ /dev/null
@@ -1,14 +0,0 @@
-# SequenceEntry
-
-A segment/connector pair in a prohibited transition sequence.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `connector_id` | [`Id`](../../system/ref/id.md) | Identifies the point of physical connection between the previous segment in the sequence and the segment in this sequence entry. |
-| `segment_id` | [`Id`](../../system/ref/id.md) | Identifies the segment that the previous segment in the sequence is physically connected to via the sequence entry's connector. |
-
-## Used By
-
-- [`ProhibitedTransitionRule`](prohibited_transition_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed.md
deleted file mode 100644
index 728a27352..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed.md
+++ /dev/null
@@ -1,14 +0,0 @@
-# Speed
-
-A speed value, i.e. a certain number of distance units travelled per unit time.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `value` | [`SpeedValue`](speed_value.md) | Speed value |
-| `unit` | [`SpeedUnit`](../../common/speed_unit.md) | |
-
-## Used By
-
-- [`SpeedLimitRule`](speed_limit_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limit_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limit_rule.md
deleted file mode 100644
index ed02b113e..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limit_rule.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# SpeedLimitRule
-
-An individual speed limit rule.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `max_speed` | [`Speed`](speed.md) (optional) | *At least one of `max_speed`, `min_speed` must be set* |
-| `max_speed.value` | [`SpeedValue`](speed_value.md) | Speed value |
-| `max_speed.unit` | [`SpeedUnit`](../../common/speed_unit.md) | |
-| `min_speed` | [`Speed`](speed.md) (optional) | *At least one of `max_speed`, `min_speed` must be set* |
-| `min_speed.value` | [`SpeedValue`](speed_value.md) | Speed value |
-| `min_speed.unit` | [`SpeedUnit`](../../common/speed_unit.md) | |
-| `is_max_speed_variable` | `boolean` (optional) | Indicates a variable speed corridor<br/><br/>*`strict=True`* |
-| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SpeedLimitRule applies to. |
-| `when` | [`SpeedLimitRule.When`](speed_limit_rule.when.md) (optional) | Scopes for SpeedLimitRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE |
-| `when.heading` | [`Heading`](../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing SpeedLimitRule applies to. |
-| `when.during` | [`OpeningHours`](../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing SpeedLimitRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification. |
-| `when.mode` | `list<`[`TravelMode`](../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing SpeedLimitRule applies to. |
-| `when.using` | `list<`[`PurposeOfUse`](../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing SpeedLimitRule applies to. |
-| `when.recognized` | `list<`[`RecognizedStatus`](../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing SpeedLimitRule applies to. |
-| `when.vehicle` | [`VehicleAxleCountSelector`](../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing SpeedLimitRule applies to. |
-
-## Constraints
-
-- At least one of `max_speed`, `min_speed` must be set
-
-## Used By
-
-- [`Segment`](../segment.md)
-- [`SpeedLimits`](speed_limits.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limit_rule.when.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limit_rule.when.md
deleted file mode 100644
index f9a4b0918..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limit_rule.when.md
+++ /dev/null
@@ -1,22 +0,0 @@
-# SpeedLimitRule.When
-
-Scopes for SpeedLimitRule: Scope.HEADING, Scope.TEMPORAL, Scope.TRAVEL MODE, Scope.PURPOSE OF USE, Scope.RECOGNIZED STATUS and Scope.VEHICLE
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `heading` | [`Heading`](../../common/scoping/heading.md) (optional) | The heading, either forward or backward, that the containing SpeedLimitRule applies to.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
-| `during` | [`OpeningHours`](../../common/scoping/opening_hours.md) (optional) | The recurring time span, in the OpenStreetMap opening hours format, that the containing SpeedLimitRule applies to. For the OSM opening hours specification, see https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification.<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
-| `mode` | `list<`[`TravelMode`](../../common/scoping/travel_mode.md)`>` (optional) | A list of one or more travel modes, such as car, truck, or foot, that the containing SpeedLimitRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
-| `using` | `list<`[`PurposeOfUse`](../../common/scoping/purpose_of_use.md)`>` (optional) | A list of one or more usage purposes, such as delivery or arrival at final destination, that the containing SpeedLimitRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
-| `recognized` | `list<`[`RecognizedStatus`](../../common/scoping/recognized_status.md)`>` (optional) | A list of one or more recognized status values, such as employee or student, that the containing SpeedLimitRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
-| `vehicle` | [`VehicleAxleCountSelector`](../../common/scoping/vehicle_axle_count_selector.md) \| [`VehicleHeightSelector`](../../common/scoping/vehicle_height_selector.md) \| [`VehicleLengthSelector`](../../common/scoping/vehicle_length_selector.md) \| [`VehicleWeightSelector`](../../common/scoping/vehicle_weight_selector.md) \| [`VehicleWidthSelector`](../../common/scoping/vehicle_width_selector.md) (list, optional) | A list of one or more vehicle parameters that limit the vehicles the containing SpeedLimitRule applies to.<br/><br/>*Minimum length: 1*<br/>*All items must be unique. (`UniqueItemsConstraint`)*<br/><br/>*At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set* |
-
-## Constraints
-
-- At least one of `heading`, `during`, `mode`, `using`, `recognized`, `vehicle` must be set
-
-## Used By
-
-- [`SpeedLimitRule`](speed_limit_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limits.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limits.md
deleted file mode 100644
index c42f47267..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_limits.md
+++ /dev/null
@@ -1,14 +0,0 @@
-# SpeedLimits
-
-Rules governing speed on this road segment
-
-Underlying type: `list<`[`SpeedLimitRule`](speed_limit_rule.md)`>`
-
-## Constraints
-
-- Minimum length: 1
-- All items must be unique. (`UniqueItemsConstraint`)
-
-## Used By
-
-- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_value.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_value.md
deleted file mode 100644
index 8b4983f6b..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/speed_value.md
+++ /dev/null
@@ -1,16 +0,0 @@
-# SpeedValue
-
-Speed value
-
-Underlying type: `int32`
-
-## Constraints
-
-- `≥ 1`
-- `≤ 350`
-- `≥ -2147483648` (from [`int32`](../../system/primitive/primitives.md))
-- `≤ 2147483647` (from [`int32`](../../system/primitive/primitives.md))
-
-## Used By
-
-- [`Speed`](speed.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass.md
deleted file mode 100644
index f91d5d42e..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# Subclass
-
-Refines expected usage of the segment, must not overlap.
-
-## Values
-
-- `link`
-- `sidewalk`
-- `crosswalk`
-- `parking_aisle`
-- `driveway`
-- `alley`
-- `cycle_crossing`
-
-## Used By
-
-- [`Segment`](../segment.md)
-- [`SubclassRule`](subclass_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass_rule.md
deleted file mode 100644
index 3b67cc1db..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass_rule.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# SubclassRule
-
-Set of subclasses scoped along segment.
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `value` | [`Subclass`](subclass.md) | |
-| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SubclassRule applies to. |
-
-## Used By
-
-- [`Segment`](../segment.md)
-- [`SubclassRules`](subclass_rules.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass_rules.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass_rules.md
deleted file mode 100644
index a8322e9e1..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subclass_rules.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# SubclassRules
-
-Set of subclasses scoped along segment
-
-Underlying type: `list<`[`SubclassRule`](subclass_rule.md)`>`
-
-## Used By
-
-- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subtype.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subtype.md
deleted file mode 100644
index e24c2f7e4..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/subtype.md
+++ /dev/null
@@ -1,13 +0,0 @@
-# Subtype
-
-Transportation segment subtype classification.
-
-## Values
-
-- `road`
-- `rail`
-- `water`
-
-## Used By
-
-- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/surface_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/surface_rule.md
deleted file mode 100644
index 2b4e12ed9..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/surface_rule.md
+++ /dev/null
@@ -1,13 +0,0 @@
-# SurfaceRule
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `value` | [`RoadSurface`](road_surface.md) | |
-| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing SurfaceRule applies to. |
-
-## Used By
-
-- [`Segment`](../segment.md)
-- [`Surfaces`](surfaces.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/surfaces.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/surfaces.md
deleted file mode 100644
index 846f48828..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/surfaces.md
+++ /dev/null
@@ -1,14 +0,0 @@
-# Surfaces
-
-Physical surface of the road. May either be specified as a single global value for the segment, or as an array of surface rules.
-
-Underlying type: `list<`[`SurfaceRule`](surface_rule.md)`>`
-
-## Constraints
-
-- Minimum length: 1
-- All items must be unique. (`UniqueItemsConstraint`)
-
-## Used By
-
-- [`Segment`](../segment.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/width.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/width.md
deleted file mode 100644
index c7e6d5ec4..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/width.md
+++ /dev/null
@@ -1,11 +0,0 @@
-# Width
-
-Underlying type: `float64`
-
-## Constraints
-
-- `> 0`
-
-## Used By
-
-- [`WidthRule`](width_rule.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/width_rule.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/width_rule.md
deleted file mode 100644
index 5b954eebe..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/width_rule.md
+++ /dev/null
@@ -1,13 +0,0 @@
-# WidthRule
-
-## Fields
-
-| Name | Type | Description |
-| -----: | :----: | ------------- |
-| `value` | [`Width`](width.md) | |
-| `between` | [`LinearlyReferencedRange`](../../common/scoping/linearly_referenced_range.md) (list, optional) | The linearly-referenced sub-segment of the geometry, specified as a range (pair) of percentage displacements from the start of the geometry, that the containing WidthRule applies to. |
-
-## Used By
-
-- [`Segment`](../segment.md)
-- [`WidthRules`](width_rules.md)
diff --git a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/width_rules.md b/schema_versioned_docs/version-v1.17.0/reference/transportation/types/width_rules.md
deleted file mode 100644
index 1c5cbf035..000000000
--- a/schema_versioned_docs/version-v1.17.0/reference/transportation/types/width_rules.md
+++ /dev/null
@@ -1,16 +0,0 @@
-# WidthRules
-
-Edge-to-edge width of the road modeled by this segment, in meters.
-
-Examples: (1) If this segment models a carriageway without sidewalk, this value represents the edge-to-edge width of the carriageway, inclusive of any shoulder. (2) If this segment models a sidewalk by itself, this value represents the edge-to-edge width of the sidewalk. (3) If this segment models a combined sidewalk and carriageway, this value represents the edge-to-edge width inclusive of sidewalk.
-
-Underlying type: `list<`[`WidthRule`](width_rule.md)`>`
-
-## Constraints
-
-- Minimum length: 1
-- All items must be unique. (`UniqueItemsConstraint`)
-
-## Used By
-
-- [`Segment`](../segment.md)
diff --git a/schema_versioned_sidebars/version-v1.17.0-sidebars.json b/schema_versioned_sidebars/version-v1.17.0-sidebars.json
deleted file mode 100644
index 4c080aea5..000000000
--- a/schema_versioned_sidebars/version-v1.17.0-sidebars.json
+++ /dev/null
@@ -1,14 +0,0 @@
-{
-  "schema": [
-    {
-      "type": "link",
-      "label": "← All docs",
-      "href": "/"
-    },
-    "index",
-    {
-      "type": "autogenerated",
-      "dirName": "reference"
-    }
-  ]
-}
diff --git a/schema_versions.json b/schema_versions.json
index aacd3e59a..562d8481e 100644
--- a/schema_versions.json
+++ b/schema_versions.json
@@ -1,5 +1,4 @@
 [
   "v2.0.0",
-  "v1.18.0",
-  "v1.17.0"
+  "v1.18.0"
 ]
diff --git a/scripts/add-schema-version.mjs b/scripts/add-schema-version.mjs
index 35613eb5b..0a913e8c8 100644
--- a/scripts/add-schema-version.mjs
+++ b/scripts/add-schema-version.mjs
@@ -4,12 +4,12 @@
 //   npm run add-schema-version -- v2.0.0
 //
 // Steps: clone the schema repo at the tag, run its own overture-codegen (same
-// as the generate-schema-docs CI action) into schema/reference, then run
+// as the schema repo's generate-schema-docs action) into schema/reference, then run
 // `docusaurus docs:version:schema <tag>`, which copies schema/ into
 // schema_versioned_docs/version-<tag>/, snapshots sidebars-schema.js, and
 // prepends the tag to schema_versions.json. Those three outputs are committed.
-// schema/reference is left clean afterwards (it is gitignored and
-// regenerated from `main` on every build). See README "Schema Reference".
+// schema/reference is left clean afterwards (it is gitignored scratch space).
+// See README "Schema Reference".
 import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { dirname, join } from 'node:path';