Address feedback: revise dataset and sources comments

SOURCES.md

@@ -209,25 +209,45 @@ Selected rail lines simplified from `tfl_lines.json` at https://github.com/oobri
 
 ## `monarchs.json`
 
-A chronological dataset of English and British monarchs from Elizabeth I (1558) through George IV (1830). Each entry includes:
+A chronological list of English and British monarchs from Elizabeth I through George IV. 
+### Data Structure
+Each entry includes:
 
 - `name`: The ruler's name or identifier (e.g., "W&M" for William and Mary, "Cromwell" for the period of interregnum)
-- `start`: The year their rule began
+- `start`: The year their rule began.
 - `end`: The year their rule ended
 - `index`: A [zero-based sequential number](https://en.wikipedia.org/wiki/Zero-based_numbering) assigned to each entry, representing the chronological order of rulers
-- `commonwealth`: A Boolean flag (true) for the period from 1649 to 1660. This field is omitted for all other entries. The *commonwealth* field name is retained for backwards compatibility with existing visualizations, despite covering the broader period known as interregnum, including the Commonwealth of England (1649-1653), the Protectorate under Oliver and Richard Cromwell (1653-1659), and the brief period of instability leading to the Restoration in 1660.
+- `commonwealth`: A Boolean flag (true) for the period from 1649 to 1660. This field is omitted for all other entries. 
 
-The accuracy of this data can be verified against the [kings & queens](https://www.royal.uk/kings-and-queens-1066
-) and [interregnum](https://www.royal.uk/interregnum-1649-1660
-) [official website of the British royal family](https://www.royal.uk) pages of the official Web site of the British royal family (retrieved in Aug. 2024). Content on the site is protected by Crown Copyright. Under the [UK Government Licensing Framework](https://www.nationalarchives.gov.uk/information-management/re-using-public-sector-information/uk-government-licensing-framework/crown-copyright/), most Crown copyright information is available under the [Open Government Licence v3.0](https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/).
+### Known Inaccuracies  and Special Notes
 
+#### Start and end dates
+The dataset contains two intentional inaccuracies to maintain compatibility with the [Wheat and Wages](https://vega.github.io/vega/examples/wheat-and-wages/) example visualization: 
+1. the start date for the reign of Elizabeth I is shown as 1565, instead of 1558; 
+2. the end date for the reign of George IV is shown as 1820, instead of 1830. 
+
+These discrepancies align the `monarchs.json` dataset with the start and end dates of the `wheat.json` dataset used i the visualization.
+
+#### William & Mary's Reign
 The entry "W&M" represents the joint reign of William III and Mary II. While the dataset shows their reign as 1689-1702, the official Web site of the British royal family indicates that Mary II's reign ended in 1694, though William III continued to rule until 1702.
 
-The original dataset in this repository was revised in Aug. 2024 with the following corrections:
+#### Interregnum Period
+The `commonwealth` field is used to flag the period from 1649 to 1660, which includes the Commonwealth of England, the Protectorate, and the period leading to the Restoration. While historically more accurate to call this the "interregnum," the field name of `commonwealth` from the original dataset is retained for backwards compatibility.
+
+#### Recent updates
 
-* Elizabeth I's reign now correctly starts in 1558 (previously 1565),  and her name is updated to include the [regnal number](https://en.wikipedia.org/wiki/Regnal_number) "I"
+The dataset was revised in Aug. 2024 with the following corrections:
+
+* Elizabeth I's name is updated to include the [regnal number](https://en.wikipedia.org/wiki/Regnal_number) "I"
 * James II's reign now ends in 1688 (previously 1689)
-* George IV's reign now ends in 1830 (previously 1820)
+
+
+ ### Data Source and Licensing
+ Source data has been verified against the [kings & queens](https://www.royal.uk/kings-and-queens-1066
+) and [interregnum](https://www.royal.uk/interregnum-1649-1660
+) [official website of the British royal family](https://www.royal.uk) pages of the official Web site of the British royal family (retrieved in Aug. 2024). Content on the site is protected by Crown Copyright. Under the [UK Government Licensing Framework](https://www.nationalarchives.gov.uk/information-management/re-using-public-sector-information/uk-government-licensing-framework/crown-copyright/), most Crown copyright information is available under the [Open Government Licence v3.0](https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/).
+
+
 
 ## `movies.json`
 

data/monarchs.json

@@ -1,5 +1,5 @@
 [
-{"name":"Elizabeth I","start":1558,"end":1603,"index":0},
+{"name":"Elizabeth I","start":1565,"end":1603,"index":0},
 {"name":"James I","start":1603,"end":1625,"index":1},
 {"name":"Charles I","start":1625,"end":1649,"index":2},
 {"name":"Cromwell","start":1649,"end":1660,"commonwealth":true,"index":3},
@@ -10,5 +10,5 @@
 {"name":"George I","start":1714,"end":1727,"index":8},
 {"name":"George II","start":1727,"end":1760,"index":9},
 {"name":"George III","start":1760,"end":1820,"index":10},
-{"name":"George IV","start":1820,"end":1830,"index":11}
+{"name":"George IV","start":1820,"end":1820,"index":11}
 ]