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

Added file extension recommendation #212

Merged
merged 3 commits into from
May 13, 2024
Merged

Conversation

cholmes
Copy link
Member

@cholmes cholmes commented May 6, 2024

Adds a recommendation to use .parquet for the file extension, as discussed in #211

From what I could tell the core parquet specification does not require a specific file extension, so it didn't seem good to require it.

I did not include 'justification' in the text, like a line about how it's not required by the core specification but that some readers may expect it. I figure we can just refer to the discussion of the issue if people want to understand.

I also stopped short of including the .geo.parquet recommendation from @hobu. I started to write it, but then didn't find any specific recommendation in https://copc.io/, so it seemed maybe a little overspecified? Happy to add it, but was also thinking we could just mention it in a blog post and put up some examples of it. Could also have validators issue a 'warning' and recommend it when people use .geoparquet.

It does feel like the spec could use a bit of reorganization, and it's probably time for a table of contents at the top. I just put this at the very bottom, which does feel quite buried, but the other option was to stick it at the very top. I figured I'd get this in (and maybe #115) and then try a PR that just re-organizes.

Closes #211

@cholmes cholmes added this to the 1.1 milestone May 6, 2024
@cholmes cholmes mentioned this pull request May 6, 2024
format-specs/geoparquet.md Outdated Show resolved Hide resolved
Co-authored-by: Matthias Mohr <matthias@mohr.ws>
format-specs/geoparquet.md Outdated Show resolved Hide resolved
Co-authored-by: Kyle Barron <kylebarron2@gmail.com>
@jorisvandenbossche jorisvandenbossche merged commit fe3687d into main May 13, 2024
2 checks passed
@jorisvandenbossche jorisvandenbossche deleted the cholmes/file-extension branch May 13, 2024 07:19
@jorisvandenbossche
Copy link
Collaborator

Thanks @cholmes

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Clarify recommended file extension
4 participants