From c06a8820c42c753979e12e0e489935543cc73b53 Mon Sep 17 00:00:00 2001 From: MattGarrish Date: Wed, 19 Dec 2018 08:12:04 -0400 Subject: [PATCH 1/5] clarify pep is required and remove parenthetical about content of the page --- index.html | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/index.html b/index.html index 7f74afd..d79e204 100644 --- a/index.html +++ b/index.html @@ -742,9 +742,10 @@

Resources

Primary Entry Page

-

The primary entry page is a key [[!HTML]] document required of every Web Publication. It - represents the preferred starting resource for discovery of the Web - Publication and enables discovery of the manifest.

+

Every Web Publication MUST include a primary entry page which MUST be returned when + accessing the Web Publication's address. The primary entry page represents the preferred + starting resource for discovery of the Web Publication, and enables + discovery of the manifest.

Although any resource can link to the Web Publication manifest, the primary entry page typically introduces the publication and provides access to the content. It might contain all the content, in @@ -755,9 +756,8 @@

Primary Entry Page

It is not required that the primary entry page be included in the default reading order, nor that it be the first document listed when it is included. This specification leaves the exact nature of the document intentionally underspecified to provide - flexibility for different approaches (e.g., the primary entry page could be a marketing document for - the Web Publication instead of a specific page of content). If a default reading order is not - provided, however, the primary entry page will be used as the default entry.

+ flexibility for different approaches. If a default reading order is not provided, however, user + agents will use the primary entry page as the default entry.

The primary entry page is the only resource in which a manifest can be embedded. To ensure discovery of the manifest, the primary entry page MUST provide a Date: Wed, 19 Dec 2018 08:16:29 -0400 Subject: [PATCH 2/5] minor language tweaks --- index.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index d79e204..2e03fb7 100644 --- a/index.html +++ b/index.html @@ -742,9 +742,9 @@

Resources

Primary Entry Page

-

Every Web Publication MUST include a primary entry page which MUST be returned when - accessing the Web Publication's address. The primary entry page represents the preferred - starting resource for discovery of the Web Publication, and enables +

Every Web Publication MUST include a primary entry page, which is the resource that MUST + be returned when accessing the Web Publication's address. The primary entry page represents + the preferred starting resource for the Web Publication, and enables discovery of the manifest.

Although any resource can link to the Web Publication manifest, the primary entry page typically From 49efa9b431c9101f38564469d977b58629467de8 Mon Sep 17 00:00:00 2001 From: MattGarrish Date: Wed, 19 Dec 2018 08:52:48 -0400 Subject: [PATCH 3/5] clarify pep in reading order --- index.html | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/index.html b/index.html index 2e03fb7..b4b7e41 100644 --- a/index.html +++ b/index.html @@ -757,7 +757,7 @@

Primary Entry Page

>default reading order, nor that it be the first document listed when it is included. This specification leaves the exact nature of the document intentionally underspecified to provide flexibility for different approaches. If a default reading order is not provided, however, user - agents will use the primary entry page as the default entry.

+ agents will create one using the primary entry page.

The primary entry page is the only resource in which a manifest can be embedded. To ensure discovery of the manifest, the primary entry page MUST provide a Generating a Canonical Manifest -

  • () if manifest["readingOrder"] is - undefined, let u be the value of document.URL, and add
    +
  • () if + manifest["readingOrder"] is undefined, let u be the value + of document.URL, and add
    "readingOrder": [{"type": ["LinkedResource"], "url": u}]
    to the manifest
    From cb0c1cf5e7b5a1cfa6f61c6a76b2bacab54ee537 Mon Sep 17 00:00:00 2001 From: MattGarrish Date: Wed, 19 Dec 2018 09:53:32 -0400 Subject: [PATCH 4/5] additional clarifications --- index.html | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/index.html b/index.html index b4b7e41..5df1c2b 100644 --- a/index.html +++ b/index.html @@ -742,10 +742,10 @@

    Resources

    Primary Entry Page

    -

    Every Web Publication MUST include a primary entry page, which is the resource that MUST - be returned when accessing the Web Publication's address. The primary entry page represents - the preferred starting resource for the Web Publication, and enables - discovery of the manifest.

    +

    The primary entry page represents the preferred starting resource for a Web Publication and enables discovery of its manifest. It is the + resource that is returned when accessing the Web Publication's address, and MUST be included + either in the default reading order or resource list.

    Although any resource can link to the Web Publication manifest, the primary entry page typically introduces the publication and provides access to the content. It might contain all the content, in From 0f1cda39d1324f5bc40ec62c4f91b0a759c8bdd9 Mon Sep 17 00:00:00 2001 From: MattGarrish Date: Wed, 19 Dec 2018 10:27:17 -0400 Subject: [PATCH 5/5] minor grammar tweak --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 5df1c2b..be99ee7 100644 --- a/index.html +++ b/index.html @@ -745,7 +745,7 @@

    Primary Entry Page

    The primary entry page represents the preferred starting resource for a Web Publication and enables discovery of its manifest. It is the resource that is returned when accessing the Web Publication's address, and MUST be included - either in the default reading order or resource list.

    + in either the default reading order or the resource list.

    Although any resource can link to the Web Publication manifest, the primary entry page typically introduces the publication and provides access to the content. It might contain all the content, in