Finish transition to v2

CHANGELOG.md

@@ -0,0 +1,138 @@
+### Version 2.0
+
+- Add `football.json`. Thanks to @eitanlees!
+- Add `penguins.json`.
+- Add `seattle-weather-hourly-normals.csv`.
+- Update `weather.csv` and `seattle-weather.csv` with better encoded weather condition, indicating more rain. Thanks to @visnup!
+- Update co2-concentration data and add seasonally adjusted CO2 field.
+- Switch to ISO 8601 dates in `seattle-weather.csv`.
+- Rename `weball26.json` to `political-contributions.json`.
+- Convert `birdstrikes.json` to `birdstrikes.csv` and use ISO 8601 dates.
+- Convert `movies.json` to use column names with spaces use ISO 8601 dates.
+- Remove `climate.json`.
+- Replace `seattle-temps.csv` with more general `seattle-weather-hourly-normals.csv`.
+- Remove `sf-temps.csv`.
+- Remove `graticule.json`. Use graticule generator instead.
+- Remove `points.json`.
+- Remove `iris.json`. Use `penguins.json` instead.
+
+### Version 1.31
+
+- Strip BOM from `windvectors.csv`.
+
+### Version 1.30
+
+- Update `seattle-temps` with better sourced data.
+- Update `sf-temps` with better sourced data.
+
+### Version 1.29
+
+- Add `ohlc.json`. Thanks to @eitanlees!
+
+### Version 1.28
+
+- Add `annual-precip.json`. Thanks to @mattijn!
+
+### Version 1.27
+
+- Add `volcano.json`.
+
+### Version 1.26
+
+- Add `uniform-2d.json`.
+
+### Version 1.22
+
+- Add `windvectors.csv`. Thanks to @jwoLondon!
+
+### Version 1.20
+
+- Add `us-unemployment.csv`. Thanks to @palewire!
+
+### Version 1.19
+
+- Remove time in `weather.csv`.
+
+### Version 1.18
+
+- Fix typo in city name in `us-state-capitals.json`
+
+### Version 1.17
+
+- Made data consistent with respect to origin by making them originated from a Unix platform.
+
+### Version 1.16
+
+- Add `co2-concentration.csv`.
+
+### Version 1.15
+
+- Add `earthquakes.json`.
+
+### Version 1.14
+
+- Add `graticule.json`, London borough boundaries, borough centroids and tube (metro) rail lines.
+
+### Version 1.13
+
+- Add `disasters.csv` with disaster type, year and deaths.
+
+### Version 1.12
+
+- Add 0 padding in zipcode dataset.
+
+### Version 1.11
+
+- Add U district cuisine data
+
+### Version 1.10
+
+- Add weather data for Seattle and New York.
+
+### Version 1.9
+
+- Add income, zipcodes, lookup data, and a dataset with three independent geo variables.
+
+### Version 1.8
+
+- Remove all tabs in `github.csv` to prevent incorrect field name parsing.
+
+### Version 1.7
+
+* Dates in `movies.json` are all recognized as date types by datalib.
+* Dates in `crimea.json` are now in ISO format (YYYY-MM-DD).
+
+### Version 1.6
+
+* Fix `cars.json` date format.
+
+### Version 1.5
+
+* Add [Gapminder Health v.s. Income](data/gapminder-health-income.csv) dataset.
+* Add generated Github contributions data for punch card visualization.
+
+### Version 1.4
+
+* Add Anscombe's Quartet dataset.
+
+### Version 1.3
+
+* Change date format in weather data so that it can be parsed in all browsers. Apparently YYYY/MM/DD is fine. Can also omit hours now.
+
+### Version 1.2
+
+* Decode origins in cars dataset.
+* Add Unemployment Across Industries in US.
+
+### Version 1.1.1
+
+* Fixed the date parsing on the CrossFilter datasets -- an older version of the data was copied over on initial import. A script is now available via `npm run flights N` to re-sample `N` records from the original `flights-3m.csv` dataset.
+
+### Version 1.1
+
+* Add `seattle-weather` dataset. Transformed with https://gist.github.com/domoritz/acb8c13d5dadeb19636c.
+
+### Version 1.0, October 8, 2015
+
+* Initial import from Vega and Vega-Lite.
+* Change field names in `cars.json` to be more descriptive (`hp` to `Horsepower`).

README.md

@@ -2,15 +2,22 @@
 
 [![npm version](https://img.shields.io/npm/v/vega-datasets.svg)](https://www.npmjs.com/package/vega-datasets)
 [![Build Status](https://github.com/vega/vega-datasets/workflows/Test/badge.svg)](https://github.com/vega/vega-datasets/actions)
+[![](https://data.jsdelivr.com/v1/package/npm/vega-datasets/badge?style=rounded)](https://www.jsdelivr.com/package/npm/vega-datasets)
 
-Collection of datasets used in Vega and Vega-Lite examples. This data lives at https://github.com/vega/vega-datasets.
+Collection of datasets used in Vega and Vega-Lite examples. This data lives at https://github.com/vega/vega-datasets and https://cdn.jsdelivr.net/npm/vega-dataset.
 
 Common repository for example datasets used by Vega related projects. Keep changes to this repository minimal as other projects (Vega, Vega Editor, Vega-Lite, Polestar, Voyager) use this data in their tests and for examples.
 
-The list of sources is in [sources.md](https://github.com/vega/vega-datasets/blob/master/sources.md).
+The list of sources is in [SOURCES.md](https://github.com/vega/vega-datasets/blob/master/SOURCES.md).
 
 To access the data in Observable, you can import `vega-dataset`. Try our [example notebook](https://observablehq.com/@vega/vega-datasets). To access these datasets from Python, you can use the [Vega datasets python package](https://github.com/jakevdp/vega_datasets). To access them from Julia, you can use the [VegaDatasets.jl julia package](https://github.com/davidanthoff/VegaDatasets.jl).
 
+## Versioning
+
+We use semantic versioning. However, since this package serve datasets we have additional rules about how we version data.
+
+We do not change data in patch releases except to resolve formatting issues. Minor releases may change the data but only update datasets in ways that do not change field names or file names. Minor releases may also add datasets. Major versions may change file names, file contents, and remove or update files. 
+
 ## How to use it
 
 ### NPM
@@ -45,136 +52,10 @@ console.log(cars);
 
 ### HTTP
 
-You can also get the data directly via HTTP served by GitHub like:
+You can also get the data directly via HTTP served by GitHub or jsDelivr (a fast CDN) like:
 
-https://vega.github.io/vega-datasets/data/cars.json
+https://vega.github.io/vega-datasets/data/cars.json or with a fixed version (recommended) such as https://cdn.jsdelivr.net/npm/vega-datasets@1.31/data/cars.json.
 
 ## Development process
 
 Install dependencies with `yarn`. To make a release, create a new tagged version with `yarn version` and then push the tag. The CI will automatically make a release. 
-
-## Changelog
-
-### Version 2.0
-
-- Update `weather.csv` and `seattle-weather.csv` with better encoded weather condition, indicating more rain.
-- Remove `graticule.json`.
-- Add `football.json`.
-- Add `penguins_size.csv`.
-
-### Version 1.30
-
-- Update `seattle-temps` with better sourced data.
-- Update `sf-temps` with better sourced data.
-
-### Version 1.29
-
-- Add `ohlc.json`. Thanks to @eitanlees!
-
-### Version 1.28
-
-- Add `annual-precip.json`. Thanks to @mattijn!
-
-### Version 1.27
-
-- Add `volcano.json`.
-
-### Version 1.26
-
-- Add `uniform-2d.json`.
-
-### Version 1.22
-
-- Add `windvectors.csv`. Thanks to @jwoLondon!
-
-### Version 1.20
-
-- Add `us-unemployment.csv`. Thanks to @palewire!
-
-### Version 1.19
-
-- Remove time in `weather.csv`.
-
-### Version 1.18
-
-- Fix typo in city name in `us-state-capitals.json`
-
-### Version 1.17
-
-- Made data consistent with respect to origin by making them originated from a Unix platform.
-
-### Version 1.16
-
-- Add `co2-concentration.csv`.
-
-### Version 1.15
-
-- Add `earthquakes.json`.
-
-### Version 1.14
-
-- Add `graticule.json`, London borough boundaries, borough centroids and tube (metro) rail lines.
-
-### Version 1.13
-
-- Add `disasters.csv` with disaster type, year and deaths.
-
-### Version 1.12
-
-- Add 0 padding in zipcode dataset.
-
-### Version 1.11
-
-- Add U district cuisine data
-
-### Version 1.10
-
-- Add weather data for Seattle and New York.
-
-### Version 1.9
-
-- Add income, zipcodes, lookup data, and a dataset with three independent geo variables.
-
-### Version 1.8
-
-- Remove all tabs in `github.csv` to prevent incorrect field name parsing.
-
-### Version 1.7
-
-* Dates in `movies.json` are all recognized as date types by datalib.
-* Dates in `crimea.json` are now in ISO format (YYYY-MM-DD).
-
-### Version 1.6
-
-* Fix `cars.json` date format.
-
-### Version 1.5
-
-* Add [Gapminder Health v.s. Income](data/gapminder-health-income.csv) dataset.
-* Add generated Github contributions data for punch card visualization.
-
-### Version 1.4
-
-* Add Anscombe's Quartet dataset.
-
-### Version 1.3
-
-* Change date format in weather data so that it can be parsed in all browsers. Apparently YYYY/MM/DD is fine. Can also omit hours now.
-
-### Version 1.2
-
-* Decode origins in cars dataset.
-* Add Unemployment Across Industries in US.
-
-### Version 1.1.1
-
-* Fixed the date parsing on the CrossFilter datasets -- an older version of the data was copied over on initial import. A script is now available via `npm run flights N` to re-sample `N` records from the original `flights-3m.csv` dataset.
-
-### Version 1.1
-
-* Add `seattle-weather` dataset. Transformed with https://gist.github.com/domoritz/acb8c13d5dadeb19636c.
-
-### Version 1.0, October 8, 2015
-
-* Initial import from Vega and Vega-Lite.
-* Change field names in `cars.json` to be more descriptive (`hp` to `Horsepower`).