15:04:16 RRSAgent has joined #dpub-loc 15:04:16 logging to http://www.w3.org/2016/02/17-dpub-loc-irc 15:05:04 Topic: Use Cases 15:05:13 ben: agenda: 1st topic use case 15:05:20 ... Romain, any update on the UC? 15:05:53 romain: nothing new, didn't have the time to work on it 15:06:00 Topic: ivan's musings 15:06:05 ben: ok, then we can go through Ivan's document 15:06:13 https://github.com/w3c/dpub-pwp-loc/blob/gh-pages/drafts/ivans-musings.md 15:06:41 bill: didn't have the chance to catch up on all this yet 15:07:05 ben: we can go over it during this call, and see if we have any extra issues 15:07:28 ... although we don't have Ivan or Leonard with us today 15:07:44 ... let's not get too much into the details 15:08:17 ... any comments ? 15:09:41 romain: I have a comment 15:10:23 ... not sure about the idea that the canonical locator can be different from Lu or Lp 15:10:43 ben: the idea was that a publisher doesn't have to provide an unpcked version 15:10:57 ... but if there is one unpacked Lu, it can be the same as L 15:11:11 bill: the problem is that it has to resolve to something 15:11:32 ... the fundamental is that the locator has to resolve to a state 15:11:45 ben: the pub doesn't have to be published unpacked 15:12:18 the doc says "if Lu doesn't exist, then L resolves to Lp or goes via Lp to resolve to the resource" 15:13:01 Daniel_Weck has joined #dpub-loc 15:13:11 rom: my issue is that the spec doesn't say "if Lu exists then L must be Lu", I think we should consider it 15:13:46 ben: if you publish the book on a file server that is not your publishing URL, the locator can be a CDN URL 15:14:21 ... maybe we can file it as an issue on the repo and further discuss it with Ivan 15:14:54 ACTION: ben to file an issue about "L = Lu when Lu exists" 15:15:38 https://github.com/w3c/dpub-pwp-loc/blob/gh-pages/drafts/ivans-musings.md 15:16:51 daniel: I haven't caught up on the latest discussion. 15:17:08 ... it looks like we need some kind of identity in terms of locator, that's the canonical locator 15:17:41 ... related to EPUB BFF as well. in the context of alignment with OWP, we're looking at how to represent an exploded / unpackaged EPUB. 15:18:04 ... the diff is that resources are not expected to be ditsributed on several locations 15:18:19 ... still catching up on the discussion 15:19:11 ben: maybe that's an extra case that we should look into once we have the current use cases agreed upon? 15:19:51 daniel: in EPUB we have the concept of "external resources", reserved for audio/video media at the moment, referenceable via external URL 15:20:04 ... RS are expected to provide an on/off toggle 15:20:22 ... here we're talking about any kind of resources, including content document 15:20:29 ... I thought it was already under consideration 15:20:50 romain: yes, it is under consideration in the existing UCs 15:21:43 ben: I suggest we don't go furhter in the document if there are no other comments? 15:21:53 ... let's go over the 2 questions 15:22:17 ... Q1: What is the answer of S to a HTTP Get http://book.org/published-books/1 request? 15:22:44 ... Ivan's proposal is that it returns at least the metadata about the PWP 15:23:03 ... the req can of course also return the packed PWP or unpacked, depending on the statwe 15:23:11 s/statwe/state/ 15:23:34 ... then when you have this metadata (M) you can use it to fetch resources inside the PWP 15:24:33 .... another question was where this metadata s/b, but the important part is that it *should* be available 15:25:22 daniel: the URL is a locator and just as a URI needs to be referenced to a resource, there is a content type 15:25:42 ... is the question: "what is the media type exepected from such query?" 15:25:58 ... in a RESTful API the URL would consistently return the same content type 15:26:31 ... the URL w/b dereferenced into a data set, not necessarily a representation of the publication but data about the publication 15:27:12 ben: when you send a get req to the canonical locator you receive a PWP, but this information will also include the metadata about the PWP 15:27:19 ... comparable to the manifest in EPUB 15:27:33 dave: it seems the server has a lot of work to do here 15:27:52 ... even if I point to the unpacked PWP which would have the manifest as JSON 15:28:33 ... if there is several renditions, etc, it would have to present a UI to select among them, display the various choices. is that how it's expected to work? 15:28:54 ben: in the simple case it just has a link header with Lu and Lp 15:29:08 ... with this list of links you can access the one you want 15:29:34 daniel: I have a slight bias in favor of simple sever / complex client rather than the other way 15:30:33 ... content negotiation based on (sophisticated) HTTP headers sounds counter intuitive 15:30:58 ... to me a URL should always return the same content type 15:31:54 ... I would much rather use some kind of conventions 15:33:03 romain: I absolutely agree 15:33:27 daniel: in fact it simpler server / simpler client, it would make a simpler system 15:33:48 bill: I'm not a technical guy, but I certainly agree that a simple server sounds essential 15:34:00 ... PWP must be able to be transmitted everywhere 15:34:38 ... and the obvious: not every web page is a PWP. you may have to do something to make it a PWP, and it's the client that can handle this specificity 15:35:24 daniel: we should be able to upload a bunch of files on a sever and the RS can implement something based on that 15:35:51 ... there has to be a lowest comon denominator, it's key 15:35:58 tzviya has joined #dpub-loc 15:36:08 ben: if we have some kind of default settings 15:36:37 ... like you publish some PWP on a location, you have JSON, you packed is always at book.pwp, etc 15:36:48 ... a more complex case would be to override those default settings 15:37:13 daniel: I would be concerned to introduce language in a spec that would give the impression that a particular naming convention should be followed 15:37:15 https://domain.com/book.pwp 15:37:34 https://domain.com/book/ 15:37:47 ... to humans the URL above gives the impression that it returns a packaged doc 15:37:57 ... it's actually a matter of server configuration 15:38:16 ... we're not trying to bind a URL convention to a content type 15:38:53 https://domain.com/book/manifest.json 15:39:20 ... this URL above is the entry point to the PWP, the RS will know what to do with it 15:39:37 ... the path convention used to differentiate the packaged/unpackeged state is completely differnt 15:39:50 ... does the canonical URL has to be a parent of either or both state? 15:40:34 ... in one of my comments we talk about in the doc 15:43:36 in EPUB: META-INF/container.xml is the main entry point for exploded content, but does not contain information about where to get the packed EPUB. 15:44:12 daniel: what's missing there is that the entry point does not contain info on where to get the zipped version of the publication 15:44:36 ... it looks like the manifest.json would contain links to both Lu or Lp 15:45:50 so: M = Mmanifest + Mlinks 15:46:13 rdetour: two things: the manifest, which describes the internal of the PWP, 15:46:36 .... and extra metadata, basically Lp and Lu (which are unknown at authoring time when the manifest is created) 15:46:50 ... the canonical locator should return both the manifest and Lu+Lp 15:47:00 q+ to talk about next steps for this grou 15:47:08 ... or maybe, Lm + Lu + Lp ("Lm" being the link to the manifest) 15:47:52 bill: what you say is that we must specify the behavior of the URL, not necessarilty the syntax of the URL 15:47:56 daniel: yes 15:48:08 q? 15:48:45 ... we live in a world where everything is linked, naming convention is not going to cut it 15:49:10 tzviya: I was away last week, I caught up with Ivan earlier today. 15:49:10 (linked and typed) 15:49:21 ... it sounds we have a general agreement here 15:49:52 ... what do you think of trying to write something up closer to "spec language"? 15:50:05 daniel: we need to make sure we revisit Ivan's document 15:50:16 ... some things may contradict what we just said 15:50:33 ... e.g. there are no syntactical conventions 15:52:43 romain: I think we have consensus about the canonical locator providing a way to return Lu and Lp and the manifest 15:53:05 .... but not sure there is a consensus on the mechanism (e.g. HTTP headers, links, conneg?) 15:53:33 dave: what I'd like to see is a flow chart that describes all the cases 15:53:39 ... maybe even a cartoon :) 15:54:24 tsviya: we don't necessarily sth as formal as a spec draft, but something to share with the group, within 10 days 15:54:50 bill: what you want is a summary: "here's what we agree on, here's what still needs discussion" 15:55:37 ben: it seems that 90% is agreed on, then the mechanism needs to be discussed 15:55:57 ... I'll try to make that 15:56:23 ... any other comments? 15:56:42 ... (silence) end of the meeting 15:56:50 rrsagent, make logs public 15:57:02 rrsagent, make minutes 15:57:02 I have made the request to generate http://www.w3.org/2016/02/17-dpub-loc-minutes.html tzviya 16:56:17 tzviya has joined #dpub-loc 18:01:01 rdeltour has joined #dpub-loc 18:03:04 tzviya has joined #dpub-loc 18:57:11 tzviya has joined #dpub-loc