16:21:13 RRSAgent has joined #pwg 16:21:13 logging to https://www.w3.org/2019/11/11-pwg-irc 16:21:17 rrsagent, set log public 16:21:17 Meeting: Publishing Working Group Telco 16:21:17 Chair: wendy 16:21:17 Date: 2019-11-11 16:21:17 Agenda: https://lists.w3.org/Archives/Public/public-publ-wg/2019Nov/0003.html 16:21:17 ivan has changed the topic to: Meeting Agenda 2019-11-11: https://lists.w3.org/Archives/Public/public-publ-wg/2019Nov/0003.html 16:21:18 Regrets+ luc, bigbluehat, rdeltour 16:29:32 laurent has joined #pwg 16:50:52 mateus has joined #pwg 16:54:31 mgarrish has joined #pwg 16:57:02 present+ 16:57:33 ivan+ 16:58:30 present+ 16:59:16 present+ 16:59:22 scribe: mateus 17:00:00 BenSchroeter has joined #pwg 17:00:10 present+ 17:00:35 dkaplan3 has joined #pwg 17:01:14 present+ 17:01:18 Avneesh has joined #pwg 17:01:30 present+ 17:01:59 marisa has joined #pwg 17:02:03 present+ 17:02:07 marisa has joined #pwg 17:02:16 rkwright has joined #pwg 17:02:27 present+ 17:02:31 wendyreid: let's get started! 17:02:36 present+ 17:02:41 laurent has joined #pwg 17:02:41 https://www.w3.org/publishing/groups/publ-wg/Meetings/Minutes/2019/2019-11-04-pwg 17:02:51 present+ 17:02:53 ... approving minutes... 17:03:01 resolved: last week's minutes accepted 17:03:06 present+ 17:03:06 ... minutes approved! 17:03:19 ... plan for today is to talk about getting to CR 17:03:24 https://github.com/w3c/publ-wg/wiki/%5BPublishing-WG%5D-CR-Transition-for-pub-manifest-and-audiobooks 17:03:34 ... posting a link... first major thing is the transition document that we are currently working on 17:03:38 Topic: Road to CR 17:03:47 ... major part we need to discuss and finalize is our test plan 17:04:05 ... need not necessarily hard tests, but clear strategies for how audiobooks and pub manifest documents will be tested 17:04:09 gpellegrino has joined #pwg 17:04:17 present+ 17:04:31 Bill_Kasdorf has joined #pwg 17:04:32 ... we should finalize the text we have here, hoping we get people to help with the task of writing tests and finalizing before the end of the year 17:04:38 ... ivan, anything missing? 17:04:45 present+ 17:05:00 George has joined #pwg 17:05:05 ivan: one more thing... not just what to test and how, but how we ourselves will produce reports for the testing... 17:05:18 ... can't produce purely manually... there are ways to speed it up and automatize it 17:05:25 present+ George 17:05:25 ... but depends very much on what we test and how 17:05:34 ... not something to decide today, but something to think about 17:05:45 franco has joined #pwg 17:05:48 present+ 17:05:56 wendyreid: i don't see Tim Cole here today, but he was very kind to show what Web Annotations did for testing 17:06:18 ... we can use the structure from Web Platform tests... it also provides a visual way to prove how well testing is going 17:06:33 ... might be our best option, might just need to make that clear in the transition document 17:06:43 ... we could also produce a test suite people can reference 17:06:54 q+ 17:06:55 q? 17:07:00 ... i think that's the best way 17:07:03 ack tzviya 17:07:13 Yay, Tzviya!!! 17:07:43 josh has joined #pwg 17:07:54 q+ 17:07:57 LarsColibrio has joined #pwg 17:07:57 ack ivan 17:08:00 present+ 17:08:03 tzviya: i don't see Lars... who has implemented audiobooks in his reading system (Colibrio)... and he said he can help... so that can be a part of the plan... with Tim and Lars working on automated testing, we have a solid team 17:08:20 https://github.com/iherman/PubManifest/tree/master/tests 17:08:22 CharlesL has joined #pwg 17:08:29 present+ 17:08:42 ivan: one other thing that may be helpful... i did an implementation of the pub manifest algorithm and collected a number of tests (linked) which are all small manifests that could be a good start with that specific part of the testing 17:08:53 ... have organized it in completely ad hoc manner for myself, but that can be changed 17:09:29 wendyreid: just noticed that LarsColibrio joined... do you want to say hi? 17:09:44 ... seems like you're muted 17:10:05 LarsColibrio: hello everyone [some garbled audio in background] 17:10:43 q+ 17:10:48 ack dauwhe 17:10:50 wendyreid: LarsColibrio is here... have already spoken to him about testing... also gotten word of another implementer who is interested and who will want to test, too 17:10:57 q+ 17:11:01 ack George 17:11:02 guest+ Lars_Wallin 17:11:33 dauwhe: how do we know that these sorts of tests pass? 17:12:03 George: what is the relationship between these tests and an architecture that would make it easy to move this forward? 17:12:24 q+ 17:12:24 Good idea George, I would say that you will get this for free basically 17:13:03 q+ 17:13:14 ack ivan 17:13:19 ack dauwhe 17:13:21 q+ 17:13:21 wendyreid: need to cover the statements made in the specification, pass/fail basis... failures can point us to things we may not have realized would be problematic... some other kinds of tests could be written in such a way that they meet the requirements of the spec 17:14:02 dauwhe: looking at ivan's tests, they are mostly manifests that exhibit properties of pub manifests, but when i think of html/css tests, it passes if there's a 'green square'.... it's obvious whats passes and fails... 17:14:29 ... but i can't tell here... i guess i can point a UA at these manifests and verify that it works, but that is not clear from this json-ld file 17:14:32 ack ivan 17:14:40 I would like to suggest that we use our implementation as base for the testing algorithms 17:15:03 Our code should be a 1:1 implementation with the spec 17:15:14 q+ 17:15:22 ivan: to be clear, what i have there grew out of testing my own implementation... and i do not claim to do more than that... i have a separate yaml file, too... there is a description of the tests there, but i don't claim it's more than that... we have to work on it 17:16:12 ... to be more generic and answer George's question... the infrastructure and tests are closely related... and that being said, we have to realize that an EPUB checker or audiobook checker will test whether a specific manifest is correct or not... the goal of the CR phase is to test whether the spec is ok or not... 17:16:31 ... whether there are no problems with how the spec is formulated, and whether the statements can be implemented in the first place 17:17:10 ack dauwhe 17:17:12 ... it's securing that the spec we produce is okay... in this sense, the implementation i and mattg did, are useful because they revealed inconsistencies in the algorithm 17:17:38 garth has joined #pwg 17:17:50 present+ Garth 17:17:55 dauwhe: ivan, it's important to make the distinction between the tests we need for CR, about implementation, vs. validating structure like EPUBCheck... that's a cautionary tale of excellent validation that doesn't necessarily correspond to support in user agents 17:18:26 ... want to avoid tests depending too much on internal states of user agents... hoping the tests for audiobook are very concrete--"given this manifest, the user experiences the following" 17:19:09 wendyreid: that's my hope too... one thing for the manifest to be processed, and another thing for the user to experience the audiobook on a consistent basis... don't need to provide a lot of user input for those needs to be met... 17:19:15 What you are discussing now guys are not spec tests ;) 17:19:16 ... we tried to make that clear 17:19:25 q+ 17:19:39 Spec tests need to be unit oriented 17:19:45 ack tzviya 17:19:55 ... it sounds like we will need to clarify use the webplatform test model and how 17:20:16 q? 17:20:48 tzviya: reading Lars' comments... let's make sure we keep the distinction between spec tests and other tests clear 17:21:07 wendyreid: does anyone have experience writing web platform tests that i don't know and have overlooked? 17:21:21 I wish all these people could just leave the room I'm in (an a11y meetup in Stockholm) πŸ˜‹ 17:21:31 https://web-platform-tests.org/ 17:21:33 George: do you know about ACT (tests for accessibility)... rec for writing tests for accessibility 17:21:57 Checkout the link :) 17:22:01 wendyreid: i'll look over those... 17:22:15 https://www.w3.org/TR/act-rules-format/ 17:22:43 present+ rachel 17:22:50 ... alright, i think we've exhausted this topic... will make some changes to the CR document this week; send me ideas and comments and i can incorporate them as needed 17:23:05 Will do Wendy. I have a bunch of ideas πŸ‘ 17:23:14 q? 17:23:16 ... next thing is the matter of shipping LPF concurrently with pub manifest and audiobooks 17:23:19 Topic: LPF publish with PM and Audiobooks 17:23:33 ... laurent, can you comment on how close LPF is to publishing? 17:23:52 I thought you called it LPP which would be an awesome name 😁 17:24:28 laurent: yes, we left the spec almost done, but on the two minor verifications to do, one related to respec warning that i want to work on with ivan... and the other thing is i need to add better links from LPF to web publication and publication manifest specs 17:25:15 ... but for the text itself we left it with no new comments... seems good... and would like it to be published as a companion for the audiobook spec, because when we speak to audiobook producers, the first thing they want is a packaging mechanism 17:25:20 q+ 17:25:25 wendyreid: awesome 17:25:25 ack ivan 17:25:38 ivan: first, mattg is probably a better expert on respec than me 17:26:01 q+ to ask for lpf refresher 17:26:32 ack tzviya 17:26:32 tzviya, you wanted to ask for lpf refresher 17:26:33 ... the other thing is that we should make it clear that once we have acceptance of director, LPF will need to go through a different path because it has not been published yet... needs to be published by the webmaster with a shortname etc. 17:26:35 We have a LPF implementation as well if that helps 17:26:51 tzviya: quick reminder of requirements for LPF... do we require it as the packaging format? 17:26:55 wendyreid: no 17:27:02 q+ 17:27:05 ack laurent 17:27:22 tzviya: remind me what the difference between LPF and [??] is? 17:27:36 s/[??]/ZIP 17:28:12 The name is sub optimal 17:28:39 Lightweight Publication Packaging would be much more true to its purpose 17:28:58 scribe+ dauwhe 17:29:22 ivan: we need a formal vote about the fact we want to publish, and under what name and shortname 17:29:45 wendyreid: we did our naming battles months ago, and I do not want to revisit those dark times 17:30:23 Proposed: Publish the Lightweight Packaging Format note with the name Lightweight Packaging Format, and the shortname LPF 17:30:24 Sorry Wendy to be a drag, but LPF is seriously ambiguous. It's kinda in the "global namespace" 17:30:34 gpellegrino has joined #pwg 17:30:38 And it is not a Lightweight Packaging Format 17:30:50 That would imply that you can package anything 17:31:18 Nope 17:31:28 Its only publication.json 17:31:40 +1 (with note that Audiobooks isn’t too useful without LPF) [and lets not reopen this discussion] 17:31:44 wendyreid: we did talk about this extensively months ago 17:31:48 if we change the publication.json to manifest.json 17:31:52 ... the issue have been closed 17:31:52 😁 17:31:54 LPP 17:32:01 +1, and we shouldn't reopen. 17:32:07 +1 17:32:09 +1 17:32:13 0 17:32:14 0 17:32:14 +1 (agree not to reopen) 17:32:14 0 17:32:15 +1 17:32:18 -1 17:32:18 Reminder that the perfect is the enemy of the good 17:32:29 0 17:32:31 0 17:32:38 0 17:32:43 0 17:32:46 q+ 17:32:47 0 17:32:48 0 17:32:50 But i'm not in the WG so πŸ˜‹ 17:32:51 ack dauwhe 17:33:16 q+ 17:33:20 q+ 17:33:24 q+ 17:33:30 ack dkaplan 17:33:39 dkaplan3: that's a lot of zeros; we're short a lot of people 17:33:41 q+ 17:33:46 ... maybe we should reopen by email 17:34:14 ... but I want to remind old-timers that we have a pattern of bikeshedding things for months, and then revisiting 17:34:26 ... I would encourage people to not block things that are not blockers 17:34:38 ... if there were good easy answers, we would have found them 17:34:53 ack ivan 17:34:57 ... just remember why we are negative about bikeshedding 17:35:11 ivan: I agree with Dave, perhaps doing this by email 17:35:26 ... there's a rule that any resolution can be revisited within 5 days 17:35:46 ... so we could resolve today and ask for objections/comments via email, and know before the next meeing 17:35:53 dauwhe: works for me 17:35:57 πŸ‘ 17:36:05 q? 17:36:06 ack rkwright 17:36:11 rkwright: Deborah and Ivan stated my case 17:36:24 q+ 17:36:28 ... I'm uncomfortable both with the reduced attendance due to holiday, and lots of 0s 17:36:31 ack mg 17:36:38 mgarrish: I don't want to bikeshed again 17:36:56 +1 mat 17:37:02 ... if we said why we're calling it lightweight, that would be better, but we don't explain 17:37:02 ack laurent 17:37:09 Should have been +1 Matt 17:37:26 q? 17:37:28 laurent: there are many zeros, and it would be good to have comments from those explaining why 17:37:35 ... what are people not sure about 17:37:54 q+ 17:37:55 for me it's the lack of the word "publication." Publication Packaging Format would be clearer. 17:38:07 wendyreid: I'll send an email explaining the issues to vote on, and I would ask 0 and -1s provide short explanations of why they are voting that way 17:38:14 q+ 17:38:15 q? 17:38:17 ... is it a problem with the name, etc.? 17:38:18 ack garth 17:38:20 Lightweight Publication Packaging is good guys 17:38:25 garth: I was gonna comment, I was a plus 1 17:38:32 ... I thought that vote was just on the name 17:38:52 ack josh 17:39:18 josh: I don't necessarily like taking a vote on armistice day/veteran's day 17:39:19 present+ josh 17:39:31 ... I don't like having to explain a zero... for me it's "I don't care" 17:39:45 ... I'm abstaining because I'm deferring to the better judgment of others 17:39:59 wendyreid: that's fine, that's an OK thing to say 17:40:13 ... I just want to make sure we have all the info out there. Consensus is good. I want to know. 17:40:28 everyone: we're ok with being ok about being ok 17:40:29 Topic: Move to CR 17:40:33 q+ 17:40:37 ack ivan 17:41:03 ivan: what I would propose to do... we don't have anything more to change on the doc 17:41:25 ... let's make it clear, in the email that you will send out, in a week from now we plan to make a vote on CR 17:41:35 ... people should look at the docs, as they are now final 17:41:46 ... we can publish as /TR/ WD 17:42:04 ... people should look at the docs and the wiki, and prepare properly for a vote next week 17:42:42 wendyreid: I'll send an email outlining everything we have to vote on 17:42:56 ... and respond to the email with any concerns you have 17:43:04 ... or you can even just contact the chairs 17:43:08 ... or log issues in github 17:43:20 ... let's get to CR! 17:43:22 Yay πŸš€ 17:43:39 wendyreid: is there any other business? 17:43:40 Good work! 17:43:52 yes to baby pictures 17:46:14 dkaplan3 has left #pwg 17:46:18 CharlesL has left #pwg 17:50:17 lars@colibrio.com 17:50:39 https://demo.colibrio.com/?publication_url=https://s3.eu-north-1.amazonaws.com/catalog.colibrio.com/flatland_with_toc.lpf 17:57:19 rrsagent, draft minutes 17:57:19 I have made the request to generate https://www.w3.org/2019/11/11-pwg-minutes.html ivan 17:57:19 zakim, bye 17:57:19 rrsagent, bye 17:57:19 I see no action items 17:57:19 leaving. As of this point the attendees have been tzviya, dauwhe, mateus, BenSchroeter, mgarrish, dkaplan, wendyreid, rkwright, marisa, laurent, Avneesh, gpellegrino, 17:57:19 Zakim has left #pwg