#344: Web Publications review

Visit on Github.

Opened Feb 15, 2019

こんにちはTAG!

I'm requesting a TAG review of:

Further details (optional):

You should also know that this group works in conjunction with Publishing Business Group. The PWG recently changed direction a bit as outlined in this blog post. I am opening a separate ticket for a review of the inital draft of audio books.

We'd prefer the TAG provide feedback as (please select one):

  • open issues in our Github repo for each point of feedback
  • open a single issue in our Github repo for the entire review
  • leave review feedback as a comment in this issue and @-notify [github usernames]

/cc @iherman @GarthConboy @wareid

Discussions

2019-03-19

Minutes

torgo: Should we bump this one to next week as well?

dbaron: I did a quick review, added a comment in the issue. So far I've read the requirements and explainer, not the spec. Interested in how the spec deals with issue around URLs and origins and packaging. Another week seems good.

torgo: I will also try and read the spec before the next call.

2019-05-01

Minutes

David: Read explainer, use cases and spec, probably in that order. Use cases document seemed scary. But then the spec seemed much less scary. So perhaps the use cases document should be revised? Perhaps not?

David: The concept of a canonical identifier was interesting. Might not be the URL from which you're accessing it. Quasi URN type thing but they're using a URL.

David: Use of JSON-LD - may be interpreted as JSON or may be ... processed into a graph? Would like to be explicit that it's intended to be read purely as JSON.

Dan: Where is this comment?

David: In the 3rd paragraph in the long comment, and the third bullet point in my earlier comment.

Dan: I need to catch up on your comments.

Tess: I read it on a plane, and my impression was that it was very thorough.

David: I disliked their use of WebIDL's partial everywhere, and I don't think I like partial in general because it's like a goto but in reverse.

Tess: Yeah it's more or less a syntactic sigil that you're doing monkeypatching.

David: In each section they monkeypatch the previous section.

Dan: Need to message Hadley since she's on the issue as well. Seems like we may be almost ready to close this off.

David: They wished to have comments in advance of their f2f which is next Monday and Tuesday.

Dan: Well, we have left comments. We should leave additional comments individually if we have them. Let's revisit on the 8th and see whether anything comes back from them as a result of the f2f.

David: I should also file an issue with them.

Dan: Marking as pending external feedback

2019-05-08

Minutes

[i'm due to talk to Tzviya tomorrow about both of the above