From ac65fdc09b69f1c2aea32233d60829c2f76b3bb1 Mon Sep 17 00:00:00 2001 From: Matt Garrish Date: Thu, 31 Aug 2017 11:07:45 -0400 Subject: [PATCH] updates description of canonical identifier to new wording in issue #56 --- index.html | 31 ++++++++++++++++++------------- 1 file changed, 18 insertions(+), 13 deletions(-) diff --git a/index.html b/index.html index 1ececca..265542a 100644 --- a/index.html +++ b/index.html @@ -374,19 +374,24 @@

Language

Canonical Identifier

-

A Web Publication's canonical identifier is an identifier that designates and resolves to - the preferred version of the Web Publication. The canonical identifier SHOULD be an address, but, - if not, it MUST be possible to make a one-to-one mapping to an address (e.g., a DOI can be resolved to a - URL via a DOI resolver).

- -

The canonical identifier differs from the mandatory address in its permanence. A Web Publication's address - could change, for example, but the canonical identifier is expected to still provide a way of locating - the new location (e.g., a DOI registry could be updated with the new URL).

- -

When assigned, the canonical identifier needs to be unique to one and only one Web Publication. Ensuring - uniqueness is outside the scope of this specification, however. The actual uniqueness achievable depends - on such factors as the conventions of the identifier scheme used and the degree of control over - assignment of identifiers.

+

A Web Publication's + canonical identifier is a unique identifier that resolves to the preferred version of the Web + Publication. The canonical identifier SHOULD be an address, but, if not, it MUST be possible to + make a one-to-one mapping to an address (e.g., a DOI can be resolved to a URL via a DOI resolver).

+ +

If a Web Publication is hosted at more than one address, this identifier allows a user agent to identify + the shared relationship between the versions and to determine which of the available addresses is + primary.

+ +

The canonical identifier is also intended to provide a measure of permanence above and beyond the Web + Publication's address. Even if a Web Publication is permanently relocated to a new address, for example, + the canonical identifier will provide a way of locating the new location (e.g., a DOI registry could be + updated with the new URL, or a redirect could be added to the URL of the canonical identifier).

+ +

When assigned, the canonical identifier needs to be unique to one and only one Web Publication, + independent of its address(es). Ensuring uniqueness is outside the scope of this specification, however. + The actual uniqueness achievable depends on such factors as the conventions of the identifier scheme used + and the degree of control over assignment of identifiers.

If the canonical identifier is a URL, it can be used as the target of a "canonical" link [[!rfc6596]] (e.g., a [[html]] link element whose rel attribute has