cloudnativegeo / cloud-optimized-geospatial-formats-guide

https://guide.cloudnativegeo.org
Creative Commons Attribution 4.0 International
121 stars 17 forks source link

Add glossary #68

Closed kylebarron closed 8 months ago

kylebarron commented 9 months ago

Change list

For https://github.com/cloudnativegeo/cloud-optimized-geospatial-formats-guide/discussions/65

github-actions[bot] commented 9 months ago

PR Preview Action v1.4.4 :---: :rocket: Deployed preview to https://cloudnativegeo.github.io/cloud-optimized-geospatial-formats-guide/pr-preview/pr-68/ on branch gh-pages at 2023-10-10 21:26 UTC

kylebarron commented 9 months ago

@jedsundwall your review on this would be interesting too, since I tried to make the descriptions not too technical!

jedsundwall commented 9 months ago

@kylebarron, I'm going to defer to you and @wildintellect on the nuances here. The glossary looks great to me and it's a very solid attempt at collecting our community's technical terms into one place and making them more accessible. If you can pass @wildintellect's edits, I'll be happy to merge.

kylebarron commented 8 months ago

Did we use all these terms in the existing docs already?

We've probably used most of them, and I think it's fine for the glossary to be a superset of terms used in the documentation. I.e. if cloud-optimized points to cloud points to aws and gcp, then it makes sense to have all of those defined in the glossary beyond just cloud-optimized. But having them separated out means it's possible to add permalinks to the relevant sections directly in the future