davidgasquez.com / handbook
this repo has no description
4
fork

Configure Feed

Select the types of activity you want to include in your feed.

docs: 📚 Expand guidelines on accessibility and documentation

Expanded guidelines on dataset accessibility to discourage the use of obscure licenses. Enhanced documentation section to include derived works. Added emphasis on maintaining historical dataset versions. Updated inspiration sources with Frictionless and Croissant references.

David Gasquez aab59dd4 b0aef6cd

+4 -3
+4 -3
Open Data.md
··· 130 130 131 131 ### Consumption 132 132 133 - - **Accessible**. Datasets are **files**. Datasets are static assets living somewhere. Don't get in the middle with libraries or gated databases. 134 - - **Documentation**. Surface derived work (e.g: reports, other datasets, ...). 133 + - **Accessible**. Datasets are **files**. Datasets are static assets living somewhere. Don't get in the middle with libraries, gated databases or [obscure licenses](https://www.heltweg.org/posts/how-to-make-sure-no-one-cares-about-your-open-data/). 134 + - **Documentation**. Surface derived work (e.g: reports, other datasets, ...) and not only the raw data with minimal metadata. 135 135 - **Embedded Visualizations**. Know what's in there before downloading it. 136 136 - **Sane Defaults**. Suggest basic charts (bars, lines, time series, clustering). Multiple [views](https://tech.datopian.com/views/). 137 137 - **Exploratory**. Allow drill downs and customization. Offer a [simple way](https://lite.datasette.io/) for people to query/explore the data. 138 138 - **Dynamic**. Use only the data you need. No need to pull 150GB. 139 139 - **Default APIs**. For some datasets, allowing REST API / GraphQL endpoints might be useful. Same with providing an SQL interface. 140 + - **Don't break history**. If a dataset is updated, the [old versions should still be accessible](https://www.heltweg.org/posts/how-to-make-sure-no-one-cares-about-your-open-data/). 140 141 141 142 ## Frequently Asked Questions 142 143 ··· 331 332 332 333 #### Datafile 333 334 334 - Inspired by [ODF](https://docs.kamu.dev/odf/spec/). 335 + Inspired by [ODF](https://docs.kamu.dev/odf/spec/), Frictionless and [Croissant](https://github.com/mlcommons/croissant). 335 336 336 337 ```YAML 337 338 name: "My Dataset"