Consolidation of the draft #33
Conversation
iherman
commented
Aug 15, 2017
iherman
commented
- Refer to the publishing and linking document for references (see resolution)
- Usage, in preference, of URL-s (see resolution). This also include the incorporation (manually) of the changes in PR Normalize URL references #31.
- Reconciling the terminology section, after taking on board PRs update identifier, address, canonical definitions #28 and Identifiers and locators - 1st draft (partial) #17
- Incorporated the content of the separate document as discussed on the meeting at 2017-08-14 (see resolution). In doing so, some earlier explanations on identifiers have been removed and/or moved elsewhere, to avoid duplication.
- Refreshed the list of participants in the acknowledgement section.
* Refer to the publishing and linking document for references (see [resolution](https://www.w3.org/publishing/groups/publ-wg/Meetings/Minutes/2017/2017-08-07-minutes#resolution3)) * Usage, in preference, of URL-s (see [resolution](https://www.w3.org/publishing/groups/publ-wg/Meetings/Minutes/2017/2017-08-14-minutes#resolution3)). This also include the incorporation (manually) of the changes in PR #31. * Reconciling the terminology section, after taking on board PRs #28 and #17 * Incorporated the content of the [separate document](https://rawgit.com/w3c/wpub/manifest-consensus-proposal/index-manifest-proposal.html#abstract-versus-concrete-manifest) as discussed on the [meeting at 2017-08-14](https://www.w3.org/publishing/groups/publ-wg/Meetings/Minutes/2017/2017-08-14-minutes) (see [resolution](https://www.w3.org/publishing/groups/publ-wg/Meetings/Minutes/2017/2017-08-14-minutes#resolution2)). In doing so, some earlier explanations on identifiers have been removed and/or moved elsewhere, to avoid duplication. * Refreshed the list of participants in the acknowledgement section.
|
This is just a draft consolidation. It will need lots of care from @mattgarrish ! |
|
The text can be seen rendered through proper HTML (and respec) at: https://rawgit.com/w3c/wpub/6f47335caf1c02fb97b4be100f2f5fd366bf3c70/index.html |
index.html
Outdated
| <dt><dfn>URL</dfn></dt> | ||
| <dd> | ||
| <p> | ||
| In this specification, the general term URL is used as defined and used in other W3C specification like HTML [[html51]], and is defined by the relevant WhatWG document [[url]]. |
There was a problem hiding this comment.
- editorial comments:
s/is used as defined and used/is used as/s/in other W3C specification/in other W3C specifications/s/the relevant WhatWG document/the URL Standard from WhatWG/
- the ref to the URL standard is normative, so it should be
[[!URL]], no? - shouldn't we use an unversionned reference to the HTML spec? (https://www.w3.org/TR/html/).
There was a problem hiding this comment.
Thanks. Comments on comments:
- I have changed to "Standard from WhatWG", we shall see what the W3C publishing rules will say about this.
- The reference to URL is in a non-normative section, hence the reference itself cannot be normative (per pubrules...)
Otherwise done.
There was a problem hiding this comment.
The reference to URL is in a non-normative section, hence the reference itself cannot be normative (per pubrules...)
ah, of course :) thanks!
index.html
Outdated
| <p> | ||
| In this specification, the general term URL is used as defined and used in other W3C specification like HTML [[html51]], and is defined by the relevant WhatWG document [[url]]. | ||
| In particular, such a URL allows for the usage of characters from Unicode following [[rfc3987]]. | ||
| See <a href="https://www.w3.org/TR/html51/references.html#biblio-url">the note in the HTML5 document</a> for further details. |
There was a problem hiding this comment.
same question about using an unversionned reference
|
Regenerated a new preview, to include the changes for @rdeltour https://rawgit.com/w3c/wpub/816fee6c3c8ba834dd0e22adc11e380e69950cae/index.html |
minor typo corrections
|
One general comment is to try and reduce the acronymizing of the document. WP, UA, TOC might make typing easier, but they don't enhance the readability. I also don't see adding "Web Publication" before some of the terms adds anything, and only leads to trying to shorten (A Web Publication has an address, for example, or do we intend to write somewhere about the Web Publication's Web Publication Address?) I would argue, in fact, that the "WP" definitions (Canonical Identifier, Identifier and Address) don't belong in the terminology at all, but should be defined where they are first used, especially since canonical identifier introduces normative requirements into terminology. We're not creating these terms, only explaining their relationship to a web publication. But these nits can all be smoothed out later. I don't have anything to add to the substance of the PR. |
