From 065261e5317faad63647bd4f34f2819d08ffe4a6 Mon Sep 17 00:00:00 2001 From: John McCall Date: Wed, 22 Apr 2026 14:34:48 -0400 Subject: [PATCH 1/5] Replace HTML comments with MDX JSX comments Replace HTML-style comments () with MDX/JSX comment syntax ({/* ... */}) across many blog and docs MDX files to ensure comments are handled correctly by the MDX/React parser. Also update docusaurus.config.js mdx1Compat settings to disable legacy comments and admonitions (comments: false, admonitions: false) to align with the MDX comment changes and avoid compatibility issues. Signed-off-by: John McCall --- blog/2023-alpha/2023-07-26-alpha.0.mdx | 2 +- blog/2023-alpha/2023-10-19-alpha.0.mdx | 2 +- blog/2023-alpha/2023-11-14-alpha.0.mdx | 2 +- blog/2023-alpha/2023-12-14-alpha.0.mdx | 2 +- blog/2024-04-21-welcome.mdx | 2 +- blog/2024-04-22-beta-release.mdx | 2 +- blog/2024-05-16-land-cover.mdx | 2 +- blog/2024-07-24-explore-site.mdx | 2 +- blog/2024-08-15-preview-august-release.mdx | 2 +- blog/2024-10-21-preview-october-release.mdx | 2 +- blog/2024-12-18-transportation-to-ga.mdx | 2 +- blog/2024-alpha/2024-01-17-alpha.0.mdx | 2 +- blog/2024-alpha/2024-02-15-alpha.0.mdx | 2 +- blog/2024-alpha/2024-03-12-alpha.0.mdx | 2 +- blog/2024-beta/2024-04-16-beta.0.mdx | 2 +- blog/2024-beta/2024-05-16-beta.0.mdx | 2 +- blog/2024-beta/2024-06-13-beta.0.mdx | 2 +- blog/2024/2024-07-22.0.mdx | 2 +- blog/2024/2024-08-20.0.mdx | 2 +- blog/2024/2024-09-18.0.mdx | 2 +- blog/2024/2024-10-23.0.mdx | 2 +- blog/2024/2024-11-13.0.mdx | 2 +- blog/2024/2024-12-18.0.mdx | 2 +- blog/2025-01-22-release-notes.mdx | 2 +- blog/2025-02-19-release-notes.mdx | 2 +- blog/2025-03-19-release-notes.mdx | 2 +- blog/2025-04-23-release-notes.mdx | 2 +- blog/2025-05-21-release-notes.mdx | 2 +- blog/2025-06-25-getting-started-gers.mdx | 2 +- blog/2025-06-25-release-notes.mdx | 2 +- blog/2025-07-23-release-notes.mdx | 2 +- blog/2025-08-20-release-notes.mdx | 2 +- blog/2025-09-24-release-notes.mdx | 2 +- blog/2025-10-22-release-notes.mdx | 2 +- blog/2025-11-19-release-notes.mdx | 2 +- blog/2025-12-17-release-notes.mdx | 2 +- blog/2026-01-21-release-notes.mdx | 2 +- blog/2026-02-11-stac.mdx | 2 +- blog/2026-02-18-release-notes.mdx | 2 +- blog/2026-03-12-explorer-got-pretty.mdx | 2 +- blog/2026-03-18-release-notes.mdx | 2 +- blog/2026-04-15-release-notes.mdx | 2 +- docs/examples/athena-aws.mdx | 4 ++-- docs/examples/build-a-map.mdx | 10 +++++----- docusaurus.config.js | 4 ++-- 45 files changed, 51 insertions(+), 51 deletions(-) diff --git a/blog/2023-alpha/2023-07-26-alpha.0.mdx b/blog/2023-alpha/2023-07-26-alpha.0.mdx index ea5881c99..e832d0abc 100644 --- a/blog/2023-alpha/2023-07-26-alpha.0.mdx +++ b/blog/2023-alpha/2023-07-26-alpha.0.mdx @@ -8,7 +8,7 @@ tags: ### Highlights Overture `2023-07-26-alpha.0` is a first release version of open map data, establishing a baseline for future releases by the Overture Maps Foundation. The data is available for use under the designated licenses for each theme. Users should note that while Overture intends to release open map data on a regular cadence in the future, the date of subsequent releases has not been established yet. - +{/* truncate */} We would like feedback on the data, its usefulness and how it could be improved. Please use this Github repo for discussions and feedback related to this data release. diff --git a/blog/2023-alpha/2023-10-19-alpha.0.mdx b/blog/2023-alpha/2023-10-19-alpha.0.mdx index 4a9a5f633..c9b208258 100644 --- a/blog/2023-alpha/2023-10-19-alpha.0.mdx +++ b/blog/2023-alpha/2023-10-19-alpha.0.mdx @@ -13,7 +13,7 @@ Overture `2023-10-19-alpha.0` is now available. This release includes several im More information about these additions is available in the relevant sections below. - +{/* truncate */} This data is formatted in the Overture Data Schema unless otherwise noted. diff --git a/blog/2023-alpha/2023-11-14-alpha.0.mdx b/blog/2023-alpha/2023-11-14-alpha.0.mdx index a73ee3f46..1c14a639d 100644 --- a/blog/2023-alpha/2023-11-14-alpha.0.mdx +++ b/blog/2023-alpha/2023-11-14-alpha.0.mdx @@ -8,7 +8,7 @@ tags: ### Highlights Overture `2023-11-14-alpha.0` is now available. This is an incremental release that includes several improvements to the data quality and coverage as well as updates for data currency. More information about these additions is available in the relevant sections below. - +{/* truncate */} This data is formatted in the Overture Data Schema unless otherwise noted. diff --git a/blog/2023-alpha/2023-12-14-alpha.0.mdx b/blog/2023-alpha/2023-12-14-alpha.0.mdx index bcaf4b07f..63fc9aad8 100644 --- a/blog/2023-alpha/2023-12-14-alpha.0.mdx +++ b/blog/2023-alpha/2023-12-14-alpha.0.mdx @@ -8,7 +8,7 @@ tags: ### Highlights Overture `2023-12-14-alpha.0` is now available. This release includes several incremental improvements, the conflation of Google Open Buildings into the Building theme and expansion of GERS IDs across several themes. More information about these additions is available in the relevant sections below. - +{/* truncate */} This data is formatted in the Overture Data Schema unless otherwise noted. diff --git a/blog/2024-04-21-welcome.mdx b/blog/2024-04-21-welcome.mdx index 5b99372f2..bb520a6b7 100644 --- a/blog/2024-04-21-welcome.mdx +++ b/blog/2024-04-21-welcome.mdx @@ -8,7 +8,7 @@ We're excited to tell the technical stories behind this big, exciting, ambitious The engineers building Overture Maps are eager to connect with our developer community. In the posts we publish in the coming months, you’ll hear from team members who work at Amazon, Meta, Microsoft, TomTom, Esri, Development Seed, Precisely, and more. - +{/* truncate */} And we’d like to hear from you: [feedback and contributions](https://github.com/OvertureMaps/data/discussions) from folks working with our data and schema are crucial to our success. Thanks for joining us on this journey. diff --git a/blog/2024-04-22-beta-release.mdx b/blog/2024-04-22-beta-release.mdx index 24389418a..2efe79132 100644 --- a/blog/2024-04-22-beta-release.mdx +++ b/blog/2024-04-22-beta-release.mdx @@ -12,7 +12,7 @@ import TabItem from '@theme/TabItem'; Last week Overture Maps [announced the beta release](https://overturemaps.org/overture-maps-foundation-releases-beta-of-its-first-open-map-dataset/) of our schema and data. After months of hard work and steady improvements, we are nearing production-level stability. In a series of posts over the next few weeks -- starting with this one -- we’ll unpack the highlights and improvements you'll see in this release and beyond. - +{/* truncate */} ## Making geospatial fast diff --git a/blog/2024-05-16-land-cover.mdx b/blog/2024-05-16-land-cover.mdx index 61b38d48a..c28854a74 100644 --- a/blog/2024-05-16-land-cover.mdx +++ b/blog/2024-05-16-land-cover.mdx @@ -15,7 +15,7 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; The [May release](https://docs.overturemaps.org/release/latest) of Overture Maps includes new high-resolution land cover data _and_ new cartographic schema properties. - +{/* truncate */} Our `land_cover` layer is vectorized data derived from the [European Space Agency’s 2020 WorldCover (10m) rasters](https://esa-worldcover.org/en). It's similar to the land cover layer in the [Daylight](https://daylightmap.org/2023/10/11/landcover.html) map distribution, but Overture Maps added higher-resolution data (zoom level 15) with more detail and land cover classes. You'll find 10 subtypes in the new data: snow, forest, urban, grass, crop, barren, wetland, moss, mangrove, and shrub. diff --git a/blog/2024-07-24-explore-site.mdx b/blog/2024-07-24-explore-site.mdx index a04d6e257..775181006 100644 --- a/blog/2024-07-24-explore-site.mdx +++ b/blog/2024-07-24-explore-site.mdx @@ -24,7 +24,7 @@ Overture has launched a new browser-based tool to give users a no-code option to - +{/* truncate */} ## Not a map diff --git a/blog/2024-08-15-preview-august-release.mdx b/blog/2024-08-15-preview-august-release.mdx index 594c86435..da851452f 100644 --- a/blog/2024-08-15-preview-august-release.mdx +++ b/blog/2024-08-15-preview-august-release.mdx @@ -17,7 +17,7 @@ base, buildings, divisions, and places. Our [addresses theme](https://docs.overt for 14 countries; we anticipate adding more address data each month, country by country, starting with Switzerland in the August release. - +{/* truncate */} The [transportation theme](https://docs.overturemaps.org/guides/transportation/) remains in beta and we expect to make significant changes over the next couple months. In this post, we'll give you a preview of three key improvements to the transportation schema in the August diff --git a/blog/2024-10-21-preview-october-release.mdx b/blog/2024-10-21-preview-october-release.mdx index 4be6355c5..9f93f0cbd 100644 --- a/blog/2024-10-21-preview-october-release.mdx +++ b/blog/2024-10-21-preview-october-release.mdx @@ -16,7 +16,7 @@ and new building height data from Microsoft and Esri Community Maps contributors | :--------------------------------------------------------------: | | _H3 coverage map of Overture addresses_ | - +{/*truncate*/} In July, Overture [launched](https://docs.overturemaps.org/release/2024-07-22.0/#new-theme-addresses) our addresses theme with 200 million features in 14 countries. Since then, diff --git a/blog/2024-12-18-transportation-to-ga.mdx b/blog/2024-12-18-transportation-to-ga.mdx index 97399a4d3..623ded6d5 100644 --- a/blog/2024-12-18-transportation-to-ga.mdx +++ b/blog/2024-12-18-transportation-to-ga.mdx @@ -8,7 +8,7 @@ tags: Over the past several releases, Overture has been laying the groundwork to transition our transportation theme from beta to general availability (GA). This post provides a brief roadmap of the work we’ve done to reach that goal, along with a request for our community to continue testing the data and providing valuable feedback. - +{/* truncate */} First, let’s talk about what GA means for the transportation theme. We have a few guiding principles: diff --git a/blog/2024-alpha/2024-01-17-alpha.0.mdx b/blog/2024-alpha/2024-01-17-alpha.0.mdx index d1d69c7a5..2297df76c 100644 --- a/blog/2024-alpha/2024-01-17-alpha.0.mdx +++ b/blog/2024-alpha/2024-01-17-alpha.0.mdx @@ -8,7 +8,7 @@ tags: ### Highlights Overture `2024-01-17-alpha.0` is now available. This release includes several incremental improvements, addition of geopolitical boundary information in the Admins Theme and expansion of GERS IDs across several themes. More information about these additions is available in the relevant sections below. - +{/* truncate */} This data is formatted in the Overture Data Schema unless otherwise noted. diff --git a/blog/2024-alpha/2024-02-15-alpha.0.mdx b/blog/2024-alpha/2024-02-15-alpha.0.mdx index c2cc6dac8..88af44d15 100644 --- a/blog/2024-alpha/2024-02-15-alpha.0.mdx +++ b/blog/2024-alpha/2024-02-15-alpha.0.mdx @@ -8,7 +8,7 @@ tags: ### Highlights Overture `2024-02-15-alpha.0` is now available. This release includes several incremental improvements, addition of geopolitical boundary information in the Admins Theme and expansion of GERS IDs across several themes. More information about these additions is available in the relevant sections below. - +{/* truncate */} This data is formatted in the Overture Data Schema unless otherwise noted. diff --git a/blog/2024-alpha/2024-03-12-alpha.0.mdx b/blog/2024-alpha/2024-03-12-alpha.0.mdx index ebdae7f36..09f161865 100644 --- a/blog/2024-alpha/2024-03-12-alpha.0.mdx +++ b/blog/2024-alpha/2024-03-12-alpha.0.mdx @@ -8,7 +8,7 @@ tags: ### Highlights Here are the highlights of what's new and updated in Overture's `2024-03-12-alpha.0` release. This release includes a schema change from `camelCase` to `snake_case` for all property names and enumeration member names, an expansion of stable GERS IDs and incremental updates to the schema and datasets. - +{/* truncate */} ### Breaking changes We changed `camelCase` to `snake_case` in the schema for properties to be more compatible with some SQL engines. This may break existing code and queries: diff --git a/blog/2024-beta/2024-04-16-beta.0.mdx b/blog/2024-beta/2024-04-16-beta.0.mdx index 82ada62a7..8f4880f7e 100644 --- a/blog/2024-beta/2024-04-16-beta.0.mdx +++ b/blog/2024-beta/2024-04-16-beta.0.mdx @@ -12,7 +12,7 @@ Overture Maps `2024-04-16-beta.0` is available in GeoParquet and stored on AWS a We encourage developers wishing to adopt Overture Maps base layers to begin evaluating and providing [feedback on the data, schema, and GERS IDs](https://github.com/OvertureMaps/data/discussions). Depending on the feedback from this release and subsequent releases, we anticipate moving to a production release in the next few months. - +{/* truncate */} ### Breaking changes We renamed the `bbox` column fields to align with the upcoming [GeoParquet](https://geoparquet.org/) 1.1 spec. diff --git a/blog/2024-beta/2024-05-16-beta.0.mdx b/blog/2024-beta/2024-05-16-beta.0.mdx index 73b108a05..7d61dd278 100644 --- a/blog/2024-beta/2024-05-16-beta.0.mdx +++ b/blog/2024-beta/2024-05-16-beta.0.mdx @@ -9,7 +9,7 @@ Here's what's new and updated in the Overture Maps `2024-05-16-beta.0` release. Overture Maps `2024-05-16-beta.0` is available in GeoParquet and stored on AWS and Azure. Users can select the data of interest and download it by following the process outlined [here](https://docs.overturemaps.org/getting-data/). We encourage developers wishing to adopt Overture Maps base layers to begin evaluating and providing [feedback on the data, schema, and GERS IDs](https://github.com/OvertureMaps/data/discussions). Depending on the feedback from this release and subsequent releases, we anticipate moving to a production release in the next few months. - +{/* truncate */} ### Breaking changes diff --git a/blog/2024-beta/2024-06-13-beta.0.mdx b/blog/2024-beta/2024-06-13-beta.0.mdx index 230297874..d61b04611 100644 --- a/blog/2024-beta/2024-06-13-beta.0.mdx +++ b/blog/2024-beta/2024-06-13-beta.0.mdx @@ -24,7 +24,7 @@ AWS path: s3://overturemaps-us-west-2/release/2024-06-13-beta.1 ``` ::: - +{/* truncate */} Overture's `2024-06-13-beta.0` release is available in GeoParquet and stored on AWS and Azure. You can access the datasets by following the process outlined [here](https://docs.overturemaps.org/getting-data/). We encourage users to report bugs and provide feedback on the data, schema, and GERS via any publicly-available Overture Maps repository on GitHub: diff --git a/blog/2024/2024-07-22.0.mdx b/blog/2024/2024-07-22.0.mdx index 51ac44be0..30251af07 100644 --- a/blog/2024/2024-07-22.0.mdx +++ b/blog/2024/2024-07-22.0.mdx @@ -25,7 +25,7 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2024-07-22.0 s3://overturemaps-us-west-2/release/2024-07-22.0 ``` - +{/* truncate */} You can access the datasets by following the process outlined [here](https://docs.overturemaps.org/getting-data/). We encourage users to report bugs and provide feedback on the data, schema, and GERS on one of our Overture GitHub repositories: diff --git a/blog/2024/2024-08-20.0.mdx b/blog/2024/2024-08-20.0.mdx index 56affa9e6..cdb8fdf25 100644 --- a/blog/2024/2024-08-20.0.mdx +++ b/blog/2024/2024-08-20.0.mdx @@ -24,7 +24,7 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2024-08-20.0 s3://overturemaps-us-west-2/release/2024-08-20.0 ``` - +{/* truncate */} You can access the datasets by following the process outlined [here](https://docs.overturemaps.org/getting-data/). We encourage users to report bugs and provide feedback on the data, schema, and GERS on one of our Overture GitHub repositories: diff --git a/blog/2024/2024-09-18.0.mdx b/blog/2024/2024-09-18.0.mdx index 6927fc9fa..518d4d9f8 100644 --- a/blog/2024/2024-09-18.0.mdx +++ b/blog/2024/2024-09-18.0.mdx @@ -24,7 +24,7 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2024-09-18.0 ``` s3://overturemaps-us-west-2/release/2024-09-18.0 ``` - +{/* truncate */} :::note Overture's GeoParquet files are now released according to the [GeoParquet v1.1.0 specification](https://geoparquet.org/releases/v1.1.0/), with the `covering` metadata included. diff --git a/blog/2024/2024-10-23.0.mdx b/blog/2024/2024-10-23.0.mdx index 4706642b4..f77af1dbc 100644 --- a/blog/2024/2024-10-23.0.mdx +++ b/blog/2024/2024-10-23.0.mdx @@ -24,7 +24,7 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2024-10-23.0 ``` s3://overturemaps-us-west-2/release/2024-10-23.0 ``` - +{/* truncate */} :::note We are now releasing Overture's GeoParquet files in accordance with the [GeoParquet v1.1.0 specification](https://geoparquet.org/releases/v1.1.0/), with the covering metadata included. diff --git a/blog/2024/2024-11-13.0.mdx b/blog/2024/2024-11-13.0.mdx index 32c1a5be6..6ae004288 100644 --- a/blog/2024/2024-11-13.0.mdx +++ b/blog/2024/2024-11-13.0.mdx @@ -24,7 +24,7 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2024-11-13.0 s3://overturemaps-us-west-2/release/2024-11-13.0 ``` - +{/* truncate */} :::note We are now releasing Overture's GeoParquet files in accordance with the [GeoParquet v1.1.0 specification](https://geoparquet.org/releases/v1.1.0/), with the covering metadata included. diff --git a/blog/2024/2024-12-18.0.mdx b/blog/2024/2024-12-18.0.mdx index 7238daa08..ad29c9e99 100644 --- a/blog/2024/2024-12-18.0.mdx +++ b/blog/2024/2024-12-18.0.mdx @@ -23,7 +23,7 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2024-12-18.0 ``` s3://overturemaps-us-west-2/release/2024-12-18.0 ``` - +{/* truncate */} You can access the datasets by following the process outlined [here](/getting-data). We encourage you to ask questions, report bugs, and provide feedback via our [data](https://github.com/OvertureMaps/data) and [schema](https://github.com/OvertureMaps/schema) repositories on GitHub. If you have a suggestion for a new dataset or if you have data you'd like to contribute to Overture, you can email us at data@overturemaps.org. We’d love to hear from you. diff --git a/blog/2025-01-22-release-notes.mdx b/blog/2025-01-22-release-notes.mdx index 4c9cfbd0a..57b7a19a8 100644 --- a/blog/2025-01-22-release-notes.mdx +++ b/blog/2025-01-22-release-notes.mdx @@ -23,7 +23,7 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2025-01-22.0 s3://overturemaps-us-west-2/release/2025-01-22.0 ``` - +{/* truncate */} You can access the datasets by following the process outlined [here](/getting-data). We encourage you to ask questions, report bugs, and provide feedback via our [data](https://github.com/OvertureMaps/data) and [schema](https://github.com/OvertureMaps/schema) repositories on GitHub. If you have a suggestion for a new dataset or if you have data you'd like to contribute to Overture, you can email us at data@overturemaps.org. We’d love to hear from you. diff --git a/blog/2025-02-19-release-notes.mdx b/blog/2025-02-19-release-notes.mdx index f5432a2c5..0be51fea2 100644 --- a/blog/2025-02-19-release-notes.mdx +++ b/blog/2025-02-19-release-notes.mdx @@ -23,7 +23,7 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2025-02-19.0 s3://overturemaps-us-west-2/release/2025-02-19.0 ``` - +{/* truncate */} You can access the datasets by following the process outlined [here](/getting-data). We encourage you to ask questions and provide feedback on the Overture Maps [Discussions forum on GitHub](https://github.com/orgs/OvertureMaps/discussions). You can also file issues and report bugs in our [data](https://github.com/OvertureMaps/data/issues) and [schema](https://github.com/OvertureMaps/schema/issues) repositories. If you have a suggestion for a new dataset or if you have data you'd like to contribute to Overture, you can email us at data@overturemaps.org. We’d love to hear from you. diff --git a/blog/2025-03-19-release-notes.mdx b/blog/2025-03-19-release-notes.mdx index 009f1f532..db988cddd 100644 --- a/blog/2025-03-19-release-notes.mdx +++ b/blog/2025-03-19-release-notes.mdx @@ -27,7 +27,7 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2025-03-19.1 ::: - +{/* truncate */} ## Overview diff --git a/blog/2025-04-23-release-notes.mdx b/blog/2025-04-23-release-notes.mdx index 6fe278e71..3dd73c7a0 100644 --- a/blog/2025-04-23-release-notes.mdx +++ b/blog/2025-04-23-release-notes.mdx @@ -22,7 +22,7 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2025-04-23.0 ``` s3://overturemaps-us-west-2/release/2025-04-23.0 ``` - +{/* truncate */} You can access the datasets by following the process outlined [here](/getting-data). We encourage you to ask questions and provide feedback on the Overture Maps [Discussions forum on GitHub](https://github.com/orgs/OvertureMaps/discussions). You can also file issues and report bugs in our [data](https://github.com/OvertureMaps/data/issues) and [schema](https://github.com/OvertureMaps/schema/issues) repositories. If you have a suggestion for a new dataset or if you have data you'd like to contribute to Overture, you can email us at data@overturemaps.org. We’d love to hear from you. diff --git a/blog/2025-05-21-release-notes.mdx b/blog/2025-05-21-release-notes.mdx index c82b4be61..87481e2b6 100644 --- a/blog/2025-05-21-release-notes.mdx +++ b/blog/2025-05-21-release-notes.mdx @@ -26,7 +26,7 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2025-05-21.0 s3://overturemaps-us-west-2/release/2025-05-21.0 ``` - +{/* truncate */} You can access the datasets by following the process outlined [here](/getting-data). We encourage you to ask questions and provide feedback on the Overture Maps [Discussion forum on GitHub](https://github.com/orgs/OvertureMaps/discussions). You can also file issues and report bugs in our [data](https://github.com/OvertureMaps/data/issues) and [schema](https://github.com/OvertureMaps/schema/issues) repositories. If you have a suggestion for a new dataset or if you have data you'd like to contribute to Overture, you can email us at data@overturemaps.org. We’d love to hear from you. diff --git a/blog/2025-06-25-getting-started-gers.mdx b/blog/2025-06-25-getting-started-gers.mdx index 707395a88..8ee4674dd 100644 --- a/blog/2025-06-25-getting-started-gers.mdx +++ b/blog/2025-06-25-getting-started-gers.mdx @@ -13,7 +13,7 @@ First, let's look at the new ID format for GERS. As of the June 2025 release, al For this release only, we're providing Parquet files that map GERS IDs from the May release to the new GERS UUIDs in June release. These files are partitioned by `theme` and 'type' and can be accessed here: `s3://overturemaps-extras-us-west-2/june_to_may_id_mapping/`. - +{/* truncate */} ## Exploring Overture data with GERS diff --git a/blog/2025-06-25-release-notes.mdx b/blog/2025-06-25-release-notes.mdx index 895b83261..e0353abf8 100644 --- a/blog/2025-06-25-release-notes.mdx +++ b/blog/2025-06-25-release-notes.mdx @@ -60,7 +60,7 @@ az://overturemapswestus2.blob.core.windows.net/registry/ s3://overturemaps-us-west-2/registry/ ``` - +{/* truncate */} You can access the datasets by following the process outlined [here](/getting-data). We encourage you to ask questions and provide feedback on the Overture Maps [Discussion forum on GitHub](https://github.com/orgs/OvertureMaps/discussions). You can also file issues and report bugs in our [data](https://github.com/OvertureMaps/data/issues) and [schema](https://github.com/OvertureMaps/schema/issues) repositories. If you have a suggestion for a new dataset or if you have data you'd like to contribute to Overture, you can email us at data@overturemaps.org. We’d love to hear from you. diff --git a/blog/2025-07-23-release-notes.mdx b/blog/2025-07-23-release-notes.mdx index 11670af10..a80e0a353 100644 --- a/blog/2025-07-23-release-notes.mdx +++ b/blog/2025-07-23-release-notes.mdx @@ -61,7 +61,7 @@ s3://overturemaps-us-west-2/registry/ - +{/* truncate */} You can access the datasets by following the process outlined [here](/getting-data). We encourage you to ask questions and provide feedback on the Overture Maps [Discussion forum on GitHub](https://github.com/orgs/OvertureMaps/discussions). You can also file issues and report bugs in our [data](https://github.com/OvertureMaps/data/issues) and [schema](https://github.com/OvertureMaps/schema/issues) repositories. If you have a suggestion for a new dataset or if you have data you'd like to contribute to Overture, you can email us at data@overturemaps.org. We’d love to hear from you. diff --git a/blog/2025-08-20-release-notes.mdx b/blog/2025-08-20-release-notes.mdx index 2ff785bfd..6005b1f87 100644 --- a/blog/2025-08-20-release-notes.mdx +++ b/blog/2025-08-20-release-notes.mdx @@ -86,7 +86,7 @@ s3://overturemaps-us-west-2/registry/ - +{/* truncate */} You can access the datasets by following the process outlined [here](/getting-data). We encourage you to ask questions and provide feedback on the Overture Maps [Discussion forum on GitHub](https://github.com/orgs/OvertureMaps/discussions). You can also file issues and report bugs in our [data](https://github.com/OvertureMaps/data/issues) and [schema](https://github.com/OvertureMaps/schema/issues) repositories. If you have a suggestion for a new dataset or if you have data you'd like to contribute to Overture, you can email us at data@overturemaps.org. We’d love to hear from you. diff --git a/blog/2025-09-24-release-notes.mdx b/blog/2025-09-24-release-notes.mdx index b1a809b12..786606baf 100644 --- a/blog/2025-09-24-release-notes.mdx +++ b/blog/2025-09-24-release-notes.mdx @@ -136,7 +136,7 @@ az://overturemapswestus2.blob.core.windows.net/registry/ s3://overturemaps-us-west-2/registry/ ``` - +{/* truncate */} ## Theme-specific updates diff --git a/blog/2025-10-22-release-notes.mdx b/blog/2025-10-22-release-notes.mdx index 7ab20b147..86a4aeca9 100644 --- a/blog/2025-10-22-release-notes.mdx +++ b/blog/2025-10-22-release-notes.mdx @@ -87,7 +87,7 @@ s3://overturemaps-us-west-2/registry/ ``` - +{/* truncate */} ## Theme-specific updates diff --git a/blog/2025-11-19-release-notes.mdx b/blog/2025-11-19-release-notes.mdx index 423d24442..f34a5a10c 100644 --- a/blog/2025-11-19-release-notes.mdx +++ b/blog/2025-11-19-release-notes.mdx @@ -72,7 +72,7 @@ s3://overturemaps-us-west-2/registry/ ``` - +{/* truncate */} ## Theme-specific updates diff --git a/blog/2025-12-17-release-notes.mdx b/blog/2025-12-17-release-notes.mdx index 09c546bd2..57e1c7217 100644 --- a/blog/2025-12-17-release-notes.mdx +++ b/blog/2025-12-17-release-notes.mdx @@ -108,7 +108,7 @@ s3://overturemaps-us-west-2/registry/ ``` - +{/* truncate */} ## Theme-specific updates diff --git a/blog/2026-01-21-release-notes.mdx b/blog/2026-01-21-release-notes.mdx index 828dbaada..181d47813 100644 --- a/blog/2026-01-21-release-notes.mdx +++ b/blog/2026-01-21-release-notes.mdx @@ -67,7 +67,7 @@ s3://overturemaps-us-west-2/registry/ ``` - +{/* truncate */} ## Theme-specific updates diff --git a/blog/2026-02-11-stac.mdx b/blog/2026-02-11-stac.mdx index 23943e387..06d2b0a2e 100644 --- a/blog/2026-02-11-stac.mdx +++ b/blog/2026-02-11-stac.mdx @@ -44,7 +44,7 @@ Huge thanks to Ben Clark for getting Overture started on our STAC journey back i ::: - +{/* truncate */} ## Why We Needed This diff --git a/blog/2026-02-18-release-notes.mdx b/blog/2026-02-18-release-notes.mdx index 43a0ba412..cff2705d4 100644 --- a/blog/2026-02-18-release-notes.mdx +++ b/blog/2026-02-18-release-notes.mdx @@ -81,7 +81,7 @@ s3://overturemaps-us-west-2/registry/ s3://overturemaps-extras-us-west-2/tiles/2026-02-18.0/ ``` - +{/* truncate */} ## Theme-specific updates diff --git a/blog/2026-03-12-explorer-got-pretty.mdx b/blog/2026-03-12-explorer-got-pretty.mdx index 1510ba4a3..8085d0033 100644 --- a/blog/2026-03-12-explorer-got-pretty.mdx +++ b/blog/2026-03-12-explorer-got-pretty.mdx @@ -28,7 +28,7 @@ That was the right call for a launch. But as Explorer has matured and more peopl - +{/* truncate */} :::danger[Shoutout!] diff --git a/blog/2026-03-18-release-notes.mdx b/blog/2026-03-18-release-notes.mdx index dd8c019a0..362f58364 100644 --- a/blog/2026-03-18-release-notes.mdx +++ b/blog/2026-03-18-release-notes.mdx @@ -87,7 +87,7 @@ s3://overturemaps-us-west-2/registry/ s3://overturemaps-extras-us-west-2/tiles/2026-03-18.0/ ``` - +{/* truncate */} ## Theme-specific updates diff --git a/blog/2026-04-15-release-notes.mdx b/blog/2026-04-15-release-notes.mdx index 68c111e19..0137b1595 100644 --- a/blog/2026-04-15-release-notes.mdx +++ b/blog/2026-04-15-release-notes.mdx @@ -79,7 +79,7 @@ s3://overturemaps-us-west-2/registry/ s3://overturemaps-extras-us-west-2/tiles/2026-04-15.0/ ``` - +{/* truncate */} ## Theme-specific updates diff --git a/docs/examples/athena-aws.mdx b/docs/examples/athena-aws.mdx index 4ac49a24f..4f873e770 100644 --- a/docs/examples/athena-aws.mdx +++ b/docs/examples/athena-aws.mdx @@ -79,7 +79,7 @@ You can access Overture data in a particular release like this: More information on using Athena is available in the [Amazon Athena User Guide](https://docs.aws.amazon.com/athena/latest/ug/what-is.html). - +*/} diff --git a/docs/examples/build-a-map.mdx b/docs/examples/build-a-map.mdx index 8c7ba54fa..664606e33 100644 --- a/docs/examples/build-a-map.mdx +++ b/docs/examples/build-a-map.mdx @@ -27,7 +27,7 @@ Overture data is released in the cloud-native format [GeoParquet](https://geopar - +{/* Places */} The places data theme represents business and points of interest in the real world. Read more about the places data schema in the [documentation](https://docs.overturemaps.org/guides/places/). @@ -54,7 +54,7 @@ The places data theme represents business and points of interest in the real wor - +{/* Placenames */} The [divisions theme](https://docs.overturemaps.org/guides/divisions/) contains named administrative units (countries, regions, counties, cities, etc.) and their boundaries. To add labels for populated places to the map, we query the divisions theme to get the primary name for each locality. @@ -79,7 +79,7 @@ The [divisions theme](https://docs.overturemaps.org/guides/divisions/) contains - +{/* Buildings */} @@ -107,7 +107,7 @@ Overture contains billions of buildings distributed across hundreds of GeoParque - +{/* Roads */} @@ -136,7 +136,7 @@ The Overture transportation theme has two types: `connectors` and `segments`. To - +{/* Base */} diff --git a/docusaurus.config.js b/docusaurus.config.js index daae2268e..8cab384b4 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -81,8 +81,8 @@ const config = { onBrokenMarkdownLinks: 'throw', }, mdx1Compat: { - comments: true, - admonitions: true, + comments: false, + admonitions: false, headingIds: true, }, }, From 7bc73040ad8044ab77fb7a97383421d0d998d558 Mon Sep 17 00:00:00 2001 From: John McCall Date: Wed, 22 Apr 2026 14:37:59 -0400 Subject: [PATCH 2/5] Update docusaurus.config.js Signed-off-by: John McCall --- docusaurus.config.js | 5 ----- 1 file changed, 5 deletions(-) diff --git a/docusaurus.config.js b/docusaurus.config.js index 8cab384b4..e66b93f99 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -80,11 +80,6 @@ const config = { hooks: { onBrokenMarkdownLinks: 'throw', }, - mdx1Compat: { - comments: false, - admonitions: false, - headingIds: true, - }, }, trailingSlash: true, From a6609eb91940f317e2bda2a2a7e41eebecd4c8dd Mon Sep 17 00:00:00 2001 From: John McCall Date: Wed, 22 Apr 2026 14:49:44 -0400 Subject: [PATCH 3/5] Update index.md Signed-off-by: John McCall --- docs/schema/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/schema/index.md b/docs/schema/index.md index 402ff3a78..6220d66a4 100644 --- a/docs/schema/index.md +++ b/docs/schema/index.md @@ -7,7 +7,7 @@ description: Pydantic schemas for Overture Maps data pagination_label: Schema Reference Overview --- -# Overture Maps Schema {#top-level-properties} +# Overture Maps Schema {/* #top-level-properties */} :::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). From 91efdf735d7b209cbf20412cd88f886242e1f4ee Mon Sep 17 00:00:00 2001 From: John McCall Date: Wed, 22 Apr 2026 14:57:13 -0400 Subject: [PATCH 4/5] Update .markdownlint.json Signed-off-by: John McCall --- .markdownlint.json | 1 + 1 file changed, 1 insertion(+) diff --git a/.markdownlint.json b/.markdownlint.json index df06133b2..3e38c4a25 100644 --- a/.markdownlint.json +++ b/.markdownlint.json @@ -14,6 +14,7 @@ "MD033": false, "MD034": false, "MD036": false, + "MD037": false, "MD040": false, "MD041": false, "MD046": false, From ac74fd7d40aa3e88862099d72f272278ecb7998a Mon Sep 17 00:00:00 2001 From: John McCall Date: Wed, 22 Apr 2026 15:03:22 -0400 Subject: [PATCH 5/5] Update schema docs links and heading Update references to the schema docs and clean up the schema index heading. The blog post now links to the canonical /schema/ page instead of the old /schema/reference/#top-level-properties anchor, and docs/schema/index.md removes an inline anchor/comment from the H1 to simplify the heading text. Signed-off-by: John McCall --- blog/2025-09-24-release-notes.mdx | 2 +- docs/schema/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/blog/2025-09-24-release-notes.mdx b/blog/2025-09-24-release-notes.mdx index 786606baf..6a9513e23 100644 --- a/blog/2025-09-24-release-notes.mdx +++ b/blog/2025-09-24-release-notes.mdx @@ -66,7 +66,7 @@ To create a purely CDLA-licensed dataset, filter out all records where the sourc ### New schema properties -This month we added a new `license` sub-property within the `sources` property to more clearly link entities to the licensing information for their source data. This change affects all Overture themes, as `sources` is [a top-level property](https://docs.overturemaps.org/schema/reference/#top-level-properties) in the Overture schema. +This month we added a new `license` sub-property within the `sources` property to more clearly link entities to the licensing information for their source data. This change affects all Overture themes, as `sources` is [a top-level property](https://docs.overturemaps.org/schema/) in the Overture schema. In the places theme, we added a new `operating_status` property, with all values set to "open". In future releases, we plan to update this property with data that indicates whether a place is "open", "permanently_closed", or "temporarily_closed". diff --git a/docs/schema/index.md b/docs/schema/index.md index 6220d66a4..2842ddc5b 100644 --- a/docs/schema/index.md +++ b/docs/schema/index.md @@ -7,7 +7,7 @@ description: Pydantic schemas for Overture Maps data pagination_label: Schema Reference Overview --- -# Overture Maps Schema {/* #top-level-properties */} +# 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).