15:42:33 RRSAgent has joined #epub 15:42:33 logging to https://www.w3.org/2022/09/12-epub-irc 15:42:35 RRSAgent, make logs Public 15:42:37 please title this meeting ("meeting: ..."), ivan 15:42:51 ivan has changed the topic to: Meeting Agenda 2022-09-12: https://www.w3.org/mid/ee036f44b6542bbf52f8383636a81b76@w3.org 15:42:52 Chair: dauwhe, wendy, shinya 15:42:52 Date: 2022-09-12 15:42:52 Agenda: https://www.w3.org/mid/ee036f44b6542bbf52f8383636a81b76@w3.org 15:42:52 Meeting: EPUB 3 Working Group F2F, 1st Day 15:42:52 Regrets+ ToshiakiKoike 15:45:29 dauwhe has joined #epub 15:52:16 present+ 15:54:04 present+ 15:54:24 tzviya has joined #epub 15:54:31 shiestyle has joined #epub 15:55:21 wendyreid has joined #epub 15:55:54 duga has joined #epub 15:55:56 present+ 15:56:03 present+ 15:56:13 present+ 15:56:18 present+ 15:57:02 bkardell_ has joined #epub 15:57:37 Zakim, who is here? 15:57:37 Present: dauwhe, ivan, wendyreid, duga, tzviya, shiestyle 15:57:39 On IRC I see bkardell_, duga, wendyreid, shiestyle, tzviya, dauwhe, RRSAgent, Zakim, ivan, romain, github-bot, Github, npd, hober, jcraig, florian 15:58:27 AvneeshSingh has joined #epub 15:58:44 present+ gregorio, dan 15:59:19 guests+ david_singer 15:59:25 MasakazuKitahara has joined #epub 15:59:36 present+ 15:59:56 present+ 16:00:03 rickj_ has joined #epub 16:00:07 present+ 16:00:11 present+ 16:00:28 present+ charles 16:02:40 dhall has joined #epub 16:02:42 AramZS has joined #epub 16:03:17 gpellegrino has joined #epub 16:03:24 dlazin has joined #epub 16:03:49 present+ 16:04:04 present+ 16:06:09 CharlesL has joined #epub 16:06:37 present+ 16:07:40 present+ daihei 16:07:58 GeorgeK has joined #epub 16:08:27 present+ 16:09:30 scribe+ 16:09:58 mgarrish has joined #epub 16:10:10 present+ 16:10:12 CharlesL: RIP Ben, We will deeply miss you 16:10:35 wendyreid: Different format today 16:10:39 CEPC https://www.w3.org/Consortium/cepc 16:10:43 ... will be a presentation from Ivan 16:10:52 present+ mattg 16:10:58 ... Then we will focus on tests, including running them 16:11:27 JohnRoque has joined #EPUB 16:11:43 ivan: [Sharing slides on screen] 16:11:58 ... brief overview of where we are 16:12:32 https://www.w3.org/2022/Talks/EPUB-IH/?full 16:12:40 ... odd group, since we are not starting from a blank slate 16:12:57 ... WG is starting with a long history of work and requirements 16:13:13 nbarron__ has joined #EPUB 16:13:51 ... 2017 is the starting point of W3C work on epub, but was already on version 3.1 16:14:36 ... First job was to "fix" 3.1 with 3.2 16:15:28 ... Now we are on 3.3 on Rec track 16:15:31 Victor_ has joined #EPUB 16:16:20 Bill_Kasdorf____ has joined #epub 16:16:21 ... Had to go through horizontal reviews, need tests, plus some editorial things 16:16:39 present+ 16:17:08 ... we do require all 3.2 documents to be valid 3.3 documents (in our charter) 16:17:40 ... And epubcheck is coming with 3.3 support 16:18:13 ... beta release of epubcheck is already available 16:18:30 https://github.com/w3c/epubcheck/releases 16:18:54 ... limited new features (webp and opus media types, and dir attribute in package) 16:20:05 ... epub:type should not be used for a11y anymore, use aria instead 16:20:36 ... Editorial changes - major reorg 16:21:01 ... It wasn't obvious where to find things in the old organization 16:21:43 ... there wasn't clear delineation of author requirements and reading system requirements 16:22:00 ... Very hard for authors to read through it all and figure out what they should do 16:22:36 ... New organization breaks out core (for creators), reading systems, and a11y 16:23:42 ... very thorough review which led to improvements in the spec 16:24:54 ... some clarification of what we meant (eg URI handling) plus some entirely new sections 16:25:10 ... Privacy and security sections added 16:25:18 kc has joined #epub 16:26:44 ... during these reviews we pulled some things out as they weren't really used and were an attack vector 16:27:17 ... interoperability wasn't very clear, mainly just vague comments 16:27:36 ... IDPF had some old tests, but they were for a different purpose 16:27:44 ... created a new test suite for epub 16:28:10 ... We are *not* duplicating existing suites (eg html, svg, css) 16:28:54 ... No need to test them, since reading systems are typically built on browser engines which are already tested 16:29:06 ... Focus only on epub specific features 16:29:32 ... each test focuses on a single normative statement 16:29:47 ... Currently around 150 tests today 16:29:57 mateus has joined #epub 16:30:19 kc has left #epub 16:30:26 ... If we can't get two implementations, then we have a problem (more to come) 16:30:41 ... Tests have a pretty table with details of each test 16:31:06 https://github.com/w3c/epub-tests 16:31:07 ... spec and tests are mutually linked (tests point at spec, spec points at test) 16:31:12 JoHan has joined #epub 16:31:16 https://w3c.github.io/epub-tests/ 16:32:01 ... [showing mathml test as example] 16:32:17 Yuyu has joined #epub 16:34:06 ... another example, language, which has no impact on the text of the content, just the metadata 16:35:30 ... tests uses the quote element 16:36:02 ... just two examples of what tests look like 16:36:21 ... we will have a final report 16:37:00 ... just sample data now, but we need to fill it out with real data 16:37:17 ... so what happens to statements in the core spec? How do we test those? 16:37:25 ... epubcheck is the answer 16:37:50 ... Will take all the epubcheck tests and make a report from those 16:38:01 ... What about a11y and metadata? 16:38:09 ... Will depend on usage 16:38:25 ... need enough organizations using them 16:38:42 ... What about unimplemented features? 16:38:49 ... That will be a topic for this f2f 16:39:14 ... Some features were added because they sounded good at the time and hoped someone would implement it 16:39:24 ... sometimes that worked, sometimes it didn't 16:40:04 ... currently called "under-implemented" 16:40:27 ... Risky to use, epubcheck accepts them, but they do not pass the CR tests 16:40:55 ... Usually in W3C it is more straightforward - just remove the feature 16:41:05 ... but our charter binds us to backwards compat 16:41:19 ... So no 3.2 document can be rejected in 3.3 16:41:32 ... Unusual, but basically our only option 16:41:58 ... Deprecated features are essentially removed, there are no tests for these 16:42:16 q+ 16:42:18 ... There are also legacy features for epub 2 support 16:42:28 ... same as deprecated, no tests 16:42:29 ack CharlesL 16:42:49 CharlesL: We didn't add any new features, correct? 16:43:14 ivan: Only added new features when they were absolutely needed (eg dir attribute) 16:43:21 ... and some in security and privacy 16:43:41 Daihei has joined #epub 16:43:52 ... examples of underimplemented features 16:44:10 ... rendition:flow turns off pagination 16:44:16 ... RS do implement this 16:44:29 ... but RS do it at user request, not author request 16:45:11 ... If all RS ignore the author request then we may need to mark as under implements 16:45:19 ... fallbacks is a trickier case 16:46:12 ... Given a chain of media types, RS should pick what they can support 16:46:20 ... May not have many implementations 16:47:05 ... some features are already removed due to no usage and no implementations 16:48:03 ... 3.3 is here, technical changes are generally done 16:48:12 ... start using it for content now 16:48:35 myles has joined #epub 16:48:51 ... final standard will be published winter next year 16:49:08 ... please run the tests and return a report 16:49:38 ... That's all! 16:50:01 wendyreid: Questions? Comments? 16:50:13 dauwhe: That was awesome, thank you! 16:50:50 present+ 16:51:02 wendyreid: Intros. Will not be scribing this bit. 16:53:47 jeff has joined #epub 16:57:13 present+ mateus 16:59:02 present+ yuyu 17:03:18 CharlesL has joined #epub 17:08:00 ivan has joined #epub 17:08:09 dsinger has joined #epub 17:08:26 present+ David Hall (dhall - Apple) 17:09:13 ivan_ has joined #epub 17:16:53 dsinger has joined #epub 17:17:09 duga has joined #epub 17:17:18 nbarron has joined #epub 17:18:21 gpellegrino has joined #epub 17:18:37 dsinger_ has joined #epub 17:19:22 SymonFlaming has joined #epub 17:20:43 john has joined #epub 17:21:02 scribe+ 17:21:23 Judy has joined #epub 17:21:35 https://docs.google.com/spreadsheets/d/13wgptApSVbQbYzi2L5VXe3D_1QLzJOTGySUAtOxn4sA/edit#gid=0 17:21:38 wendyreid: today we'll continue the meeting focusing on testing 17:21:58 ... there are still few tests that needs to been written 17:21:59 https://w3c.github.io/epub-tests/ 17:22:01 Daihei has joined #epub 17:22:19 ... then we have to run the tests! 17:22:54 ... the goal is to finish the creation of the tests and start testing the apps 17:23:49 ivan_: while writing tests I've run them locally on my mac 17:24:06 wendyreid: the other part is to be sure that the tests are clear 17:24:23 q+ 17:25:09 ... and understandable 17:25:23 ... tomorrow we want to discuss the results of today 17:25:41 ... to understand if some tests have to be revisited 17:25:59 ... check if there are features that are under-implemented 17:26:06 ack gpellegrino 17:26:10 q+ 17:26:51 gpellegrino: Do we need to compile the test results into a JSON file? 17:27:07 dlazin: Yes, that would be the easiest way 17:27:34 gpellegrino: Second question, most reading systems do tweaks on the files before giving them to end users, if we sideload we might get different results? 17:28:16 ivan_: We are testing the correctness of the recommendation, if during the publication process, user agent A does something to the file, compared to the author's version, we have no way of controlling that 17:28:51 https://w3c.github.io/epub-tests/contributing 17:29:37 duga: we may fail with sideloading 17:30:05 q+ 17:30:10 ... but we may get results if we pass the file trough the publisher pipeline 17:30:34 ack duga 17:30:48 q+ 17:31:47 Victor_Lopes has joined #EPUB 17:31:58 ivan_: what happens when a file is sideloaded? 17:32:15 duga: the file goes to a completely different pipeline 17:32:15 this is true for us (VitalSource Bookshelf) as well. Sideloading vs. publisher loading are different processes, and have some feature issues associated with them 17:32:32 ivan_: from my point of view those are two different implementations 17:33:07 ... in theory I could run all the tests on my mac on Apple Books 17:33:45 ack mgarrish 17:33:49 q+ 17:33:49 q+ 17:33:51 ... so I think ideally that the test results from an engine should come from the engine itself 17:34:46 mgarrish: since there are a lot of tests, do we have a short-list of tests that may be "problematic", so we can start with those? 17:34:58 q+ 17:35:00 ack CharlesL 17:35:08 ack duga 17:35:21 duga: is there a repository for the files? 17:35:27 wendyreid: it's in the github repo 17:36:15 ... it would be easier to have a sub set of tests, but at the same time I think one goal is to have a feedback on how and where EPUB features work 17:36:19 q+ 17:36:42 ack wendyreid 17:36:44 ack rickj_ 17:36:50 ... so having a table with the results I think would be useful 17:37:22 q+ 17:37:39 q+ 17:37:43 ack GeorgeK 17:37:53 rickj_: in the early days of epubtest.org we had problems with maintaining it updated 17:37:56 ack ivan_ 17:38:01 q+ GeorgeK 17:38:13 ivan_: for sure it is complicated to maintain it updated 17:38:22 q+ to respond to rickj_ 17:38:51 ... normally in W3C when a WG ends we create a new maintenance WG for updating the results 17:39:24 mauriceyork has joined #epub 17:40:31 rickj_: the JSON file should contain the version number of the app and the date of the testing 17:40:49 ack tzviya 17:40:49 tzviya, you wanted to respond to rickj_ 17:41:02 ivan_: we have a granularity to track implementations on different systems 17:41:57 q+ 17:42:01 ack wendyreid 17:42:12 tzviya: I share Rick's concerns, but we can't continue the specs without the tests. Eventually those will become historical document of the implementations in this year 17:42:22 dlazin_ has joined #epub 17:42:26 https://w3c.github.io/epub-tests/contributing#implementation-report-files 17:42:36 ack GeorgeK 17:42:48 CharlesL_ has joined #epub 17:43:15 wendyreid: can we use the JSON metadata so tell if the files where sideloaded or pass through the publishers' pipeline 17:43:39 q+ 17:43:49 ack Judy 17:43:50 q+ 17:44:02 present+ judy 17:44:02 GeorgeK: maybe we have the possibility to test if the reading system is accessible, for example testing MathML 17:44:38 Judy: I think there are WGs that do accessibility testing on they're specs 17:44:48 ack ivan_ 17:45:19 ivan_: I think is up to us to check implementations that are accessible 17:45:21 q+ 17:46:00 ... at this moment our first concern is to test the specs as they are 17:46:02 ack wendyreid 17:47:23 wendyreid: Maybe we may have a separate feedback for accessibility, also accessibility testing is not always a yes/no test 17:47:39 q+ 17:47:40 ... I think we should focus first on general testing 17:47:42 ack ivan_ 17:49:00 To prepare an implementation report (ideally for "your" reading system), copy the xx-template.json file here: https://github.com/w3c/epub-tests/tree/main/reports 17:49:20 ivan_: we may add to some tests some descriptions for defining what we aspect from screenreader consuption of the content 17:49:42 q+ 17:49:56 AramZS has joined #epub 17:49:59 ack tzviya 17:50:02 Once committed, your RS will appear as a column at https://w3c.github.io/epub-tests/results#implementations-results 17:50:38 tzviya: I think for the vast majority of tests we don't need it since we're based on HTML specs 17:50:51 ... so we don't have to test it for accessibility 17:51:15 q+ 17:51:20 ack gpellegrino 17:51:40 q+ 17:51:44 gpellegrino: My proposal would be to add an additional field to say whether it's been tested with a screen reader 17:51:55 ivan_: Add an additional field in results 17:52:18 ack mgarrish 17:52:46 mgarrish: I agree with tzviya: we should not re-testing the web technologies for accessibility 17:52:59 ... I would focus on EPUB specific features 17:53:57 And in general, instructions here: https://w3c.github.io/epub-tests/contributing 17:54:05 Victor_Lopes has joined #EPUB 17:54:39 wendyreid: ok, I think we can start testing 17:54:41 This is mentioned in that documentation, but the needed (unwritten) tests are https://tinyurl.com/epub-tests 17:54:53 ... dlazin_ has put all the info in the IRC 17:55:18 q+ 17:55:26 ack dhall 17:55:48 dhall: how do we submit the results? Using PRs? 17:56:31 wendyreid: yes, using PRs 17:56:36 https://github.com/w3c/epub-tests 18:06:06 For iOS/Apple Books, you can airdrop an .EPUB and it will ask if you want to open in the Books application. 18:06:51 present- 18:07:20 dsinger has joined #epub 18:07:27 mauriceyork has joined #epub 18:10:51 present+ 18:11:23 PR for empty implementation reports: https://github.com/w3c/epub-tests/pull/202 18:16:37 JoHan has joined #epub 18:16:52 Committed now, so if you fork https://github.com/w3c/epub-tests/tree/main/reports, you can start filling out the major platforms' implementation reports. Have fun! 18:17:48 The current proposal is that, to get us to 2 implementations ASAP, we federate the work of testing Apple, Google, Kobo, and Thorium. (Kobo not committed yet; Wendy is working on it.) 18:18:35 So please call out which tests you're going to run (say "I will do all the cnt-* tests for Apple Books on macOS") and we can all merge our work together. 18:19:48 mgarrish has joined #epub 18:20:19 And, in the spirit of that ... I will do all the cnt-* tests for Apple Books on macOS :) 18:24:42 gpellegrino has joined #epub 18:26:43 To map between test *titles* and IDs, see https://w3c.github.io/epub-tests/ 18:32:19 Hearing conversation around cnt-svg-css - a missing .epub? 18:33:17 Oh never mind, I'm seeing it now. 18:35:42 I can attempt the cnt-* tests for Apple Books on iOS 18:36:56 Thanks, dhall! 18:37:07 Here's the PR for my first batch, as an example: https://github.com/w3c/epub-tests/pull/204 18:37:32 mauricey_ has joined #epub 18:37:46 And yes, alphabetization in Finder is funny, so if you're on a Mac (and maybe other platforms) you may find the .epubs are alphabetized in a funny way relative to the folders. 18:39:07 I will now do all the css-* tests for Apple Books on macOS :) 18:40:42 I can start with all the pub-cmt-* for Thorium on macOS 18:40:57 Suggestion: Add test name ("cnt-css-fonts") to test documents themselves. 18:42:27 it turns out epubcheck doesn't like it when the epub is encrypted :) 18:45:55 AramZS has joined #epub 18:49:17 wrote a test of zip encryption of the container. Having trouble with my GitHub tokens... I'll do a PR when I get that sorted out. 18:50:17 iOS cnt-* tests all pass. Now to get my GitHub account setup properly to push and create PR... 18:50:34 *Apple Books tests that is. 18:51:27 @dlazin_ it seems I don't have push permissions on the gh repo. shall I use a fork instead or can you easily add all wg members to it? 18:53:43 myles has joined #epub 18:56:39 zakim, end meeting 18:56:39 As of this point the attendees have been dauwhe, ivan, wendyreid, duga, tzviya, shiestyle, gregorio, dan, MasakazuKitahara, romain, AvneeshSingh, rickj_, charles, gpellegrino, 18:56:43 ... dlazin, CharlesL, daihei, GeorgeK, mgarrish, mattg, Bill_Kasdorf____, mateus, yuyu, David, Hall, (dhall, -, Apple), judy, dhall 18:56:43 RRSAgent, please draft minutes 18:56:43 I have made the request to generate https://www.w3.org/2022/09/12-epub-minutes.html Zakim 18:56:45 I am happy to have been of service, ivan_; please remember to excuse RRSAgent. Goodbye 18:56:49 Zakim has left #epub 18:58:05 rrsagent, bye 18:58:05 I see no action items