From 2a65ee96c7f6bed0004c6a2bcebf3850a9c06d02 Mon Sep 17 00:00:00 2001 From: Dana Bauer Date: Mon, 21 Sep 2026 09:10:32 -0400 Subject: [PATCH] add new issue templates and delete old discussion templates Signed-off-by: Dana Bauer --- .github/DISCUSSION_TEMPLATE/Addresses.yaml | 28 ---- .../DISCUSSION_TEMPLATE/Admin-Boundaries.yaml | 28 ---- .github/DISCUSSION_TEMPLATE/Base.yaml | 28 ---- .github/DISCUSSION_TEMPLATE/Buildings.yaml | 28 ---- .github/DISCUSSION_TEMPLATE/GERS.yaml | 28 ---- .github/DISCUSSION_TEMPLATE/Places.yaml | 28 ---- .../DISCUSSION_TEMPLATE/Transportation.yaml | 28 ---- .github/ISSUE_TEMPLATE/data_bug.yml | 134 +++++++++++++++++ .../new_data_source_proposal.yml | 137 ++++++++++++++++++ 9 files changed, 271 insertions(+), 196 deletions(-) delete mode 100644 .github/DISCUSSION_TEMPLATE/Addresses.yaml delete mode 100644 .github/DISCUSSION_TEMPLATE/Admin-Boundaries.yaml delete mode 100644 .github/DISCUSSION_TEMPLATE/Base.yaml delete mode 100644 .github/DISCUSSION_TEMPLATE/Buildings.yaml delete mode 100644 .github/DISCUSSION_TEMPLATE/GERS.yaml delete mode 100644 .github/DISCUSSION_TEMPLATE/Places.yaml delete mode 100644 .github/DISCUSSION_TEMPLATE/Transportation.yaml create mode 100644 .github/ISSUE_TEMPLATE/data_bug.yml create mode 100644 .github/ISSUE_TEMPLATE/new_data_source_proposal.yml diff --git a/.github/DISCUSSION_TEMPLATE/Addresses.yaml b/.github/DISCUSSION_TEMPLATE/Addresses.yaml deleted file mode 100644 index e6673c2..0000000 --- a/.github/DISCUSSION_TEMPLATE/Addresses.yaml +++ /dev/null @@ -1,28 +0,0 @@ -title: "[addresses] " -labels: ["addresses"] -body: - - type: textarea - id: what-happened - attributes: - label: Category Feedback - description: - placeholder: Tell us what you see - value: "Add details \n - Expected behaviour you didn't see \n - Unexpected behaviour \n - suggested functionality \n - Steps to reproduce the problem" - validations: - required: true - - type: dropdown - id: TF-Groups - attributes: - label: Dependency with other categories, if any. - multiple: true - options: - - No Dependency - - Admin - - Address - - Base - - Data Platform - - Dev Advocacy - - GERs - - Schema - - Transportation - ### Thanks for your submission diff --git a/.github/DISCUSSION_TEMPLATE/Admin-Boundaries.yaml b/.github/DISCUSSION_TEMPLATE/Admin-Boundaries.yaml deleted file mode 100644 index 3877fb7..0000000 --- a/.github/DISCUSSION_TEMPLATE/Admin-Boundaries.yaml +++ /dev/null @@ -1,28 +0,0 @@ -title: "[admin-boundaries] " -labels: ["Admin"] -body: - - type: textarea - id: what-happened - attributes: - label: Category Feedback - description: - placeholder: Tell us what you see - value: "Add details \n - Expected behaviour you didn't see \n - Unexpected behaviour \n - suggested functionality \n - Steps to reproduce the problem" - validations: - required: true - - type: dropdown - id: TF-Groups - attributes: - label: Dependency with other categories, if any. - multiple: true - options: - - No Dependency - - Admin - - Address - - Base - - Data Platform - - Dev Advocacy - - GERs - - Schema - - Transportation - ### Thanks for your submission diff --git a/.github/DISCUSSION_TEMPLATE/Base.yaml b/.github/DISCUSSION_TEMPLATE/Base.yaml deleted file mode 100644 index 8dc8d4e..0000000 --- a/.github/DISCUSSION_TEMPLATE/Base.yaml +++ /dev/null @@ -1,28 +0,0 @@ -title: "[Base] " -labels: ["Base"] -body: - - type: textarea - id: what-happened - attributes: - label: Category Feedback - description: - placeholder: Tell us what you see - value: "Add details \n - Expected behaviour you didn't see \n - Unexpected behaviour \n - suggested functionality \n - Steps to reproduce the problem" - validations: - required: true - - type: dropdown - id: TF-Groups - attributes: - label: Dependency with other categories, if any. - multiple: true - options: - - No Dependency - - Admin - - Address - - Base - - Data Platform - - Dev Advocacy - - GERs - - Schema - - Transportation - ### Thanks for your submission diff --git a/.github/DISCUSSION_TEMPLATE/Buildings.yaml b/.github/DISCUSSION_TEMPLATE/Buildings.yaml deleted file mode 100644 index 81b73f0..0000000 --- a/.github/DISCUSSION_TEMPLATE/Buildings.yaml +++ /dev/null @@ -1,28 +0,0 @@ -title: "[Buildings] " -labels: ["Buildings"] -body: - - type: textarea - id: what-happened - attributes: - label: Category Feedback - description: - placeholder: Tell us what you see - value: "Add details \n - Expected behaviour you didn't see \n - Unexpected behaviour \n - suggested functionality \n - Steps to reproduce the problem" - validations: - required: true - - type: dropdown - id: TF-Groups - attributes: - label: Dependency with other categories, if any. - multiple: true - options: - - No Dependency - - Admin - - Address - - Base - - Data Platform - - Dev Advocacy - - GERs - - Schema - - Transportation - ### Thanks for your submission diff --git a/.github/DISCUSSION_TEMPLATE/GERS.yaml b/.github/DISCUSSION_TEMPLATE/GERS.yaml deleted file mode 100644 index 808d247..0000000 --- a/.github/DISCUSSION_TEMPLATE/GERS.yaml +++ /dev/null @@ -1,28 +0,0 @@ -title: "[GERS] " -labels: ["GERS"] -body: - - type: textarea - id: what-happened - attributes: - label: Category Feedback - description: - placeholder: Tell us what you see - value: "Add details \n - Expected behaviour you didn't see \n - Unexpected behaviour \n - suggested functionality \n - Steps to reproduce the problem" - validations: - required: true - - type: dropdown - id: TF-Groups - attributes: - label: Dependency with other categories, if any. - multiple: true - options: - - No Dependency - - Admin - - Address - - Base - - Data Platform - - Dev Advocacy - - GERs - - Schema - - Transportation - ### Thanks for your submission diff --git a/.github/DISCUSSION_TEMPLATE/Places.yaml b/.github/DISCUSSION_TEMPLATE/Places.yaml deleted file mode 100644 index ce67738..0000000 --- a/.github/DISCUSSION_TEMPLATE/Places.yaml +++ /dev/null @@ -1,28 +0,0 @@ -title: "[Places] " -labels: ["Places"] -body: - - type: textarea - id: what-happened - attributes: - label: Category Feedback - description: - placeholder: Tell us what you see - value: "Add details \n - Expected behaviour you didn't see \n - Unexpected behaviour \n - suggested functionality \n - Steps to reproduce the problem" - validations: - required: true - - type: dropdown - id: TF-Groups - attributes: - label: Dependency with other categories, if any. - multiple: true - options: - - No Dependency - - Admin - - Address - - Base - - Data Platform - - Dev Advocacy - - GERs - - Schema - - Transportation - ### Thanks for your submission diff --git a/.github/DISCUSSION_TEMPLATE/Transportation.yaml b/.github/DISCUSSION_TEMPLATE/Transportation.yaml deleted file mode 100644 index 2f7f325..0000000 --- a/.github/DISCUSSION_TEMPLATE/Transportation.yaml +++ /dev/null @@ -1,28 +0,0 @@ -title: "[Transportation] " -labels: ["Transportation"] -body: - - type: textarea - id: what-happened - attributes: - label: Category Feedback - description: - placeholder: Tell us what you see - value: "Add details \n - Expected behaviour you didn't see \n - Unexpected behaviour \n - suggested functionality \n - Steps to reproduce the problem" - validations: - required: true - - type: dropdown - id: TF-Groups - attributes: - label: Dependency with other categories, if any. - multiple: true - options: - - No Dependency - - Admin - - Address - - Base - - Data Platform - - Dev Advocacy - - GERs - - Schema - - Transportation - ### Thanks for your submission diff --git a/.github/ISSUE_TEMPLATE/data_bug.yml b/.github/ISSUE_TEMPLATE/data_bug.yml new file mode 100644 index 0000000..aed068a --- /dev/null +++ b/.github/ISSUE_TEMPLATE/data_bug.yml @@ -0,0 +1,134 @@ +name: Data Bug Report +description: Report a problem with a feature in an Overture data release. +labels: ["bug"] +body: + - type: markdown + attributes: + value: | + Please provide all the information requested. The more precisely you can point us to the feature, the faster we can trace it to its source. + If the data is correct but Explorer displays or downloads it wrong, please report it in the Explorer repo instead. + + - type: input + id: release + attributes: + label: Release + description: Which data release did you find this in? + placeholder: "YYYY-MM-DD.N" + validations: + required: true + + - type: dropdown + id: theme + attributes: + label: Theme + options: + - addresses + - base + - buildings + - divisions + - places + - transportation + - Not sure + validations: + required: true + + - type: input + id: feature-type + attributes: + label: Feature type + description: For example, building, segment, place, division_area. + validations: + required: false + + - type: input + id: gers-id + attributes: + label: GERS ID + description: The feature's `id` value. Include more than one if the bug involves several features. + placeholder: ex. 08f194dbad9210d503ccbefa0de75b4d + validations: + required: false + + - type: textarea + id: location + attributes: + label: Location + description: An Overture Explorer URL, coordinates (lon, lat), or a bounding box. Required if you don't have a GERS ID. + placeholder: ex. https://explore.overturemaps.org/#16.34/51.049194/3.728993 + validations: + required: true + + - type: dropdown + id: category + attributes: + label: What kind of problem is it? + multiple: true + options: + - Incorrect geometry + - Incorrect or missing attribute + - Incorrect or missing name + - Wrong category or classification + - Missing feature + - Duplicate feature + - Feature doesn't exist in the real world + - Broken or unexpected GERS ID behavior + - Other + validations: + required: true + + - type: textarea + id: actual + attributes: + label: What's wrong + description: Describe what you see in the data. Include the relevant attribute values or a screenshot if helpful. + validations: + required: true + + - type: textarea + id: expected + attributes: + label: What you expected + description: What should the data say or look like? + validations: + required: true + + - type: textarea + id: evidence + attributes: + label: Evidence + description: How do you know? Ground truth, imagery, an official source, local knowledge, or another dataset. + validations: + required: false + + - type: textarea + id: sources + attributes: + label: Source attribution + description: Paste the feature's `sources` property if you have it. This tells us which upstream dataset the problem came from. + render: json + validations: + required: false + + - type: textarea + id: query + attributes: + label: How you accessed the data + description: The query, tool, or download method you used (DuckDB, Athena, overturemaps-py, Explorer, etc.). + render: sql + validations: + required: false + + - type: checkboxes + id: checks + attributes: + label: Before submitting + options: + - label: I searched existing issues and didn't find this one. + required: true + - label: I confirmed the problem is in the latest release, or I noted the release above. + required: false + + - type: markdown + attributes: + value: | + Thanks for the issue, our team will look into it as soon as possible! \ No newline at end of file diff --git a/.github/ISSUE_TEMPLATE/new_data_source_proposal.yml b/.github/ISSUE_TEMPLATE/new_data_source_proposal.yml new file mode 100644 index 0000000..9471be5 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/new_data_source_proposal.yml @@ -0,0 +1,137 @@ +name: Data Source Proposal +description: Suggest an open dataset that could improve Overture Maps data. +title: "[Data Source Proposal]: " +labels: ["data-sources"] + +body: + - type: markdown + attributes: + value: | + Thanks for suggesting a data source! We review every proposal, but we can't promise to add every dataset, and adding one can take a long time. Overture is a small team, and each new source needs licensing review, schema mapping, and matching against the data we already have. + + If you want your data to reach Overture sooner, these routes are often faster: + - **Roads, buildings, and boundaries:** contribute to [OpenStreetMap](https://www.openstreetmap.org), which Overture uses as a source for these themes. + - **Addresses:** contribute to [OpenAddresses](https://openaddresses.io). + - **Buildings and other authoritative GIS data:** contribute through Esri Community Maps. + + Please provide all the information requested. Proposals missing a license or source URL are likely to stall. + + - type: input + id: dataset-name + attributes: + label: Dataset name + description: A short, descriptive name. + placeholder: ex. Delaware County Building Footprints 2025 + validations: + required: true + + - type: input + id: source-url + attributes: + label: Source URL + description: Where can we access the data, or learn more about it? + placeholder: ex. https://www.example.gov/open-data/buildings + validations: + required: true + + - type: dropdown + id: relationship + attributes: + label: Your relationship to this data + options: + - I publish or maintain it + - I work for the organization that publishes it + - I use it + - Other + validations: + required: true + + - type: dropdown + id: theme + attributes: + label: Overture theme + description: Which theme would this data improve? Choose more than one if needed. See the [schema reference](https://docs.overturemaps.org/schema/) for what each theme covers. + multiple: true + options: + - Addresses + - Base + - Buildings + - Divisions + - Places + - Transportation + - Not sure + validations: + required: true + + - type: input + id: coverage + attributes: + label: Geographic coverage + description: What area does the data cover? + placeholder: ex. Delaware County, Pennsylvania, USA + validations: + required: true + + - type: textarea + id: dataset-description + attributes: + label: What the data would add + description: Describe the dataset and how it would improve Overture. For example, does it fill a coverage gap, add detail, update stale data, or add a new kind of feature? + validations: + required: true + + - type: input + id: license + attributes: + label: License + description: Use the identifier from the [SPDX License List](https://spdx.org/licenses/) if you can. Enter "Other" or "Unknown" if not. + placeholder: ex. CC-BY-4.0, ODbL-1.0, CC0-1.0 + validations: + required: true + + - type: textarea + id: other-license-details + attributes: + label: Other license details + description: If you entered "Other," paste the license text or a link to it. Include any attribution requirements or terms of use. + validations: + required: false + + - type: dropdown + id: in-osm + attributes: + label: Is this data already in OpenStreetMap? + options: + - "Yes" + - Partly + - "No" + - Not sure + validations: + required: false + + - type: textarea + id: additional-metadata + attributes: + label: Format, updates, and other details + description: Anything else that would help us evaluate the data, such as file format, update frequency, how it was collected, known quality issues, or a link to documentation. + placeholder: | + Format: GeoParquet + Updated: Annually + Collection method: Derived from 2024 aerial imagery + validations: + required: false + + - type: checkboxes + id: checks + attributes: + label: Before submitting + options: + - label: I searched existing proposals and didn't find this dataset. + required: true + - label: I understand that submitting a proposal doesn't guarantee Overture will add the data. + required: true + + - type: markdown + attributes: + value: | + Thanks for the proposal! Our team will review it and follow up in this issue. \ No newline at end of file