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

Refactor hard-to-maintain lists #1203

Open
m-mohr opened this issue Dec 6, 2022 · 1 comment
Open

Refactor hard-to-maintain lists #1203

m-mohr opened this issue Dec 6, 2022 · 1 comment
Milestone

Comments

@m-mohr
Copy link
Collaborator

m-mohr commented Dec 6, 2022

In the best practices we have lists of relation types, media types etc. With the slow release cycle of the main spec, this is getting outdated quickly and it's relatively hard to maintain the list. I'd propose to clean-up the list and maintain it separately. For example, the list of relation types seems for some still relatively "unmature" (origin seems to be the card4l extension), but we list them regardless in the main spec, which is weird.

Similarly, I'd propose to remove the list of stable extensions from the extensions page and instead just link to stac-extensions.github.io.

@m-mohr m-mohr mentioned this issue Dec 6, 2022
4 tasks
@cboettig
Copy link

cboettig commented Jun 2, 2023

👍 Thanks @m-mohr !

Would love to see a more extensive, probably crowd-sourced list of what people are using for media types for different assets. https://github.com/radiantearth/stac-spec/blob/master/best-practices.md#common-media-types-in-stac is a nice start but obviously hardly scratches the surface of types.

Meanwhile, are their any guidelines for winging this? I'm not hopeful that we'll ever get registered MIME types for most of these (how long have we been waiting for parquet to get a MIME type??) I'm currently trying to document some vector objects that use flatgeobuf, and ESRI's shapefile and geodatabase formats; wondering if the GDAL driver names might provide a reasonable basis of reference: https://gdal.org/drivers/vector/index.html , e.g. application/x-<DRIVER SHORT NAME> maybe?

Or maybe that's a fools errand and we're better off omitting the type field and just providing a human-readable explanation of the file format using title or description fields?

@m-mohr m-mohr added this to the 1.1 milestone Jul 11, 2023
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

No branches or pull requests

2 participants