diff --git a/README.md b/README.md
index 4ef27ca..7915656 100644
--- a/README.md
+++ b/README.md
@@ -1,16 +1,16 @@
-<a className="gh-badge" href="https://datahub.io/core/currency-codes"><img src="https://badgen.net/badge/icon/View%20on%20datahub.io/orange?icon=https://datahub.io/datahub-cube-badge-icon.svg&label&scale=1.25" alt="badge" /></a>
-
+<a className="gh-badge" href="https://datahub.io/core/currency-codes"><img src="https://badgen.net/badge/icon/View%20on%20datahub.io/orange?icon=https://datahub.io/datahub-cube-badge-icon.svg&label&scale=1.25" alt="badge" /></a>
+
 List of currencies and their 3 digit codes as defined by [ISO 4217][iso-4217]. The data
 provided here is the consolidation of Table A.1 "Current currency & funds code list" and
 Table A.3 "Historic denominations".
 
-Note that the [ISO page][iso-4217] offers pay-for PDFs but also links to [http://www.currency-iso.org/en/home/tables.html](http://www.currency-iso.org/en/home/tables.html) which does provide them in machine readable form freely.
+Note that the [ISO page][iso-4217] offers pay-for PDFs but also links to [SIX Group's data standards page][iso-4217] which provides them in machine readable form freely.
 
-[iso-4217]: https://www.six-group.com/en/products-services/financial-information/data-standards.html
+[iso-4217]: https://www.six-group.com/en/products-services/financial-information/market-reference-data/data-standards.html
 
 ## Data
 
-The data provided (see data/codes.csv) in this data package provides a
+The data provided (see data/codes-all.csv) in this data package provides a
 consolidated list of currency (and funds) codes by combining these two
 separate tables:
 
@@ -22,9 +22,9 @@ separate tables:
 
 ## Preparation
 
-The script requires recode package to be istalled. Install it by running:
+The script requires `xmllint` (from the `libxml2-utils` package). Install it by running:
 
-`sudo apt install recode`
+`sudo apt install libxml2-utils`
 
 Run the following script to download and convert the data from XML to
 CSV:
@@ -37,11 +37,6 @@ cd scripts/
 The raw XML files are stored in `./archive`. The cleaned data are
 `./data/codes-all.csv`.
 
-## Version
-
-The current tables have a published date of 28 March 2014 (as indicated
-in the XML files).
-
 ## License
 
 Placing in the Public Domain under the Public Domain Dedication and License.
diff --git a/datapackage.json b/datapackage.json
index a9d7315..e61e73e 100644
--- a/datapackage.json
+++ b/datapackage.json
@@ -1,10 +1,11 @@
 {
   "name": "currency-codes",
   "title": "ISO 4217 Currency Codes",
+  "description": "ISO 4217 currency codes: current currencies (Table A.1) and historic denominations (Table A.3), sourced from SIX Interbank Clearing Ltd on behalf of ISO.",
   "licenses": [
     {
       "name": "ODC-PDDL-1.0",
-      "path": "http://opendatacommons.org/licenses/pddl/",
+      "path": "https://opendatacommons.org/licenses/pddl/",
       "title": "Open Data Commons Public Domain Dedication and License v1.0"
     }
   ],
@@ -18,8 +19,9 @@
   "sources": [
     {
       "name": "SIX Interbank Clearing Ltd (on behalf of ISO)",
-      "email": "office@currency-iso.org",
-      "title": "SIX Interbank Clearing Ltd (on behalf of ISO)"
+      "title": "SIX Interbank Clearing Ltd (on behalf of ISO)",
+      "path": "https://www.six-group.com/en/products-services/financial-information/data-standards.html",
+      "email": "office@currency-iso.org"
     }
   ],
   "contributors": [
@@ -37,6 +39,7 @@
     {
       "path": "data/codes-all.csv",
       "name": "codes-all",
+      "description": "Consolidated list of ISO 4217 current and historic currency codes, one row per country–currency pair.",
       "mimetype": "text/csv",
       "size": "16863",
       "schema": {
@@ -60,20 +63,20 @@
           {
             "name": "NumericCode",
             "title": "Numeric Code",
-            "type": "number",
-            "description": "3 digit numeric code"
+            "type": "string",
+            "description": "3 digit numeric code (zero-padded, e.g. '008')"
           },
           {
             "name": "MinorUnit",
             "title": "Minor Unit",
             "type": "string",
-            "description": ""
+            "description": "Number of digits after the decimal separator; '-' for currencies with no minor unit defined"
           },
           {
             "name": "WithdrawalDate",
             "title": "Withdrawal Date",
             "type": "string",
-            "description": "Date currency withdrawn (values can be ranges or months"
+            "description": "Date the currency was withdrawn; values may be a year-month (YYYY-MM) or a date range (e.g. '1990-07 to 1990-09'); empty for current currencies"
           }
         ]
       }