Add href guarantee for elements, bump minor version of package (#1169)

README.md

@@ -76,6 +76,7 @@ Data curation brings the following guarantees.
 ### Elements extracts
 
 - All Web IDL interfaces referenced by elements exist in Web IDL extracts.
+- All elements link back to their definition in the spec.
 
 ### Events extracts
 

packages/elements/README.md

@@ -17,7 +17,7 @@ elements.listAll().then(all => {
 });
 ```
 
-For each spec, value is an object with a `spec` property that describes the specification, and an `elements` property that lists elements defined in the spec, as an array of objects with `name`, `interface` and `obsolete` properties. The `interface` property is not present for elements that do not implement an interface:
+For each spec, value is an object with a `spec` property that describes the specification, and an `elements` property that lists elements defined in the spec, as an array of objects with `name`, `interface`, `href`, and `obsolete` properties. The `interface` property is not present for elements that do not implement an interface:
 
 ```js
 const elements = require('@webref/elements');
@@ -38,10 +38,13 @@ elements.listAll().then(all => {
 });
 ```
 
+The `href` property is the URL to the definition of the element in the specification. The property is always set.
+
 The `obsolete` property is a boolean flag, only present (and set to `true`) for elements that are obsolete.
 
 
 # Guarantees
 
 The following guarantees are provided by this package:
 - All Web IDL interfaces exist in the latest version of the [`@webref/idl` package](https://www.npmjs.com/package/@webref/idl) at the time the `@webref/elements` package is released.
+- All elements link back to their definition in the spec.

packages/elements/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@webref/elements",
   "description": "Markup elements of the Web platform and associated Web IDL interfaces",
-  "version": "2.2.3",
+  "version": "2.3.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/w3c/webref.git"