Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Switch camelCase to snake_case in schema conventions doc #129

Merged
merged 1 commit into from
Feb 27, 2024

Conversation

vcschapp
Copy link
Collaborator

@vcschapp vcschapp commented Feb 23, 2024

Description

Brief description of the business purpose and effect of the pull request.

Following up on PR #127, this PR makes a change that was missed in the previous one, updating the schema conventions document to bring it in line with the new snake_case convention.

Reference

List of relevant links to GitHub issues, PRs, and other documentation.

  1. https://github.com/OvertureMaps/schema-wg/issues/272
  2. https://wiki.overturemaps.org/x/SQGAAQ
  3. Switch from camelCase to snake_case #127

Testing

Brief description of the testing done for this change showing why you are confident it works as expected and does not introduce regressions. Provide sample output data where appropriate.

N/A - Just a markdown documentation change.

Checklist

Checklist of tasks commonly-associated with schema pull requests. Please review the relevant checklists and ensure you do all the tasks that are required for the change you made.

  1. Add relevant examples.
  2. Add relevant counterexamples.
  3. Update in-schema documentation using plain English written in complete sentences, if an update is required.
  4. Update Docusaurus documentation, if an update is required.
  5. Review change with Overture technical writer to ensure any advanced documentation needs will be taken care of, unless the change is trivial and would not affect the documentation.

Documentation Website

Update the hyperlink below to put the pull request number in.

Docs preview for this PR.

@vcschapp vcschapp self-assigned this Feb 23, 2024
@vcschapp vcschapp added documentation Improvements or additions to documentation schema labels Feb 23, 2024
@@ -4,7 +4,7 @@
2. [GeoJSON](https://geojson.org/) is used as a canonical geospatial format
i.e. GeoJSON provides us a mental model and language to express data constructions, without being the data format in which the Overture data is published
## Schema notation conventions
- camelCase is used for all property names as described in the [Google JSON Style Guide](https://google.github.io/styleguide/jsoncstyleguide.xml)
- `snake_case` is used for all property names, string enumeration members, and string-valued enumeration equivalents
- boolean properties have a prefix verb "is" or "has" in a way that grammatically makes sense
e.g.
hasStreetLights=true
Copy link
Collaborator

Choose a reason for hiding this comment

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

let's snake_case this example as well

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Ohhh man. Thanks.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Fixed.

jwass
jwass previously approved these changes Feb 23, 2024
@vcschapp vcschapp merged commit 5aadbff into dev Feb 27, 2024
2 checks passed
@vcschapp vcschapp deleted the snake_case_convention branch February 27, 2024 01:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation schema
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants