Fwd: Comments on our Note

Hello everyone,
Here is comments from Ivan concerning our DPUB a11y Note.  We will discuss tomorrow during our accessibility DPUB call.
Thanks

Charles LaPierre
Technical Lead, Diagram and Born Accessible
charlesl@benetech.org



> Begin forwarded message:
> 
> From: Ivan Herman <ivan@w3.org>
> Subject: Re: Comments on our Note
> Date: January 24, 2016 at 4:53:57 AM PST
> To: Charles LaPierre <charlesl@benetech.org>, Deborah Kaplan <dkaplan@safaribooksonline.com>
> 
> Charles, Deborah,
> 
> thanks for this! I had only a cursory look at the document, let me give you my possibly very high level comments. Some of those are editorial, some of those are more on the content; just as they came to my mind…
> 
> • I am not sure what your plans are with Appendix A. When you say 'Future Work', does it mean that you want to get into those areas and, potentially, extend what is currently in section 2, or that, well, it should be done at some point by somebody, but you do not plan to do it now? I hope it is the former:-). If so, it may be wiser to publish this document as a Working Draft, instead of a Note, and publish it as a Note (ie, something that is considered to be more final) when all those items are already included.
> 
> • How much contacts have you had with the WAI groups on this document? It may be worth asking them for a review before publishing; alternatively, if we decide to publish a draft first and a final note later, we could ask them to comment on the official Working Draft.
> 
> • On your question on formality or not, I personally do not see an issue. This is not a Recommendation, ie, the style and level of the formalism chosen is entirely up to the editors and the IG.
> 
> • I do not think we should leave the various tables and spreadsheets on Google for the final editing. With all due respect to Google, there is no commitment that an of those documents will be accessible on the Web in a few years; just as they discontinues Google Code, it is in their right to discontinue Google Docs. I would prefer to have these on W3C space, which has (via MIT) the commitment to keep things on the Web as they are until, well, the Web exists:-). Whether you want to move these tables onto the IG Wiki, whether you want to produce some sort of a presentable file of the tables that are placed alongside, and referred from, the document, or whether you want to put them into the report as HTML tables: it is really your choice, either of these are acceptable.
> 
> • Editorially, I think it would be a good idea to make the explicit suggestions jump out more visibly. Using bold, another colour, whatever; it is again your choice.
> 
> • I was wondering about 2.7. Did you talk about this with the ARIA people? Maybe it would be worth doing ASAP. The ARIA WG plans to publish ARIA 1.1 within a short time, it may be the time to get this done or get feedback. Alternatively, we may be adding a different ARIA attribute in the DPUB ARIA module. In any case, it would be worth taking that stuff separately…
> 
> • For the references (WCAG, etc) it may be better to follow the W3C TR styles to use a bibliography/references' list at the end of the document and link to the real document from there. A bit like academic papers do. This is just to be in line with other documents. Respec has some handy tricks for that, actually, so it is easy to do just by referring to the document in a special way in the document and the rest is done automatically...
> 
> There may be some minor editorial things to be done on the HTML/respec source (eg, I do not think it is worth producing an ePUB version of a Draft, although it can be done, it is worth adding references to the github issues' list, that sort of things), but we can do that later, it is not urgent. And I am of course happy to help you on those if needed.
> 
> I hope this helps!
> 
> Ivan
> 
>> On 22 Jan 2016, at 21:02, Charles LaPierre <charlesl@benetech.org <mailto:charlesl@benetech.org>> wrote:
>> 
>> Hi Ivan,
>> So we are getting close to finishing up our Note for the A11Y DPUB W3C Note and would like to see what you think.
>> 
>> http://w3c.github.io/dpub-accessibility/ <http://w3c.github.io/dpub-accessibility/>
>> 
>> We may have a bit more word smithing to do in the pagination section and we have a placeholder for the WCAG Gap analysis that we started working on originally but the rest is pretty much done.
>> We would like you to do a once over and let us know what you think, since this is a Note it is less formal so I hope what we have done makes sense to you.  We also need to know if we can from this Note link to our Google Spreadsheet work on our WCAG Gap analysis or do you think we need to move all that work into some Wiki or GitHub page?
>> Here is the links to that original work which we want to reference in this Note.
>> 
>> Now obviously we wouldn’t allow any editing but Just sending this to you as is.
>> 
>> Thanks
>> 
>> https://docs.google.com/spreadsheets/d/125hGDyBfr8fHtN0kRr_yKgXrrEXqFLAHIQhUcoGGLnU/edit?usp=sharing <https://docs.google.com/spreadsheets/d/125hGDyBfr8fHtN0kRr_yKgXrrEXqFLAHIQhUcoGGLnU/edit?usp=sharing>
>> 
>> https://docs.google.com/spreadsheets/d/1WOfpEVnZYHqfjgJp7roNE_xaJN-Y3u6PxkauaKgyNqc/edit?usp=sharing <https://docs.google.com/spreadsheets/d/1WOfpEVnZYHqfjgJp7roNE_xaJN-Y3u6PxkauaKgyNqc/edit?usp=sharing>
>> 
>> https://docs.google.com/spreadsheets/d/1FEIlzg2SLqxu6TERZRV_lkgROZj6t-6VFwDAlp4HqNc/edit?usp=sharing <https://docs.google.com/spreadsheets/d/1FEIlzg2SLqxu6TERZRV_lkgROZj6t-6VFwDAlp4HqNc/edit?usp=sharing>
>> 
>> https://docs.google.com/spreadsheets/d/1DLFcn19nTYKs_AI3b6DmtetQviVYu-OoEJsrqCLWeZs/edit?usp=sharing <https://docs.google.com/spreadsheets/d/1DLFcn19nTYKs_AI3b6DmtetQviVYu-OoEJsrqCLWeZs/edit?usp=sharing>
>> 
>> https://docs.google.com/spreadsheets/d/1fL9REi-bEvzvL17I4QQWkgNUPAMyIOlndG-Yg3DolrQ/edit?usp=sharing <https://docs.google.com/spreadsheets/d/1fL9REi-bEvzvL17I4QQWkgNUPAMyIOlndG-Yg3DolrQ/edit?usp=sharing>
>> 
>> https://docs.google.com/spreadsheets/d/14TaifBye_leDtbQnKA8bkinpl7icGuyvMqxlmVJSY2M/edit?usp=sharing <https://docs.google.com/spreadsheets/d/14TaifBye_leDtbQnKA8bkinpl7icGuyvMqxlmVJSY2M/edit?usp=sharing>
>> 
>> https://docs.google.com/spreadsheets/d/1Lz2xA_d9080A2_eWcTc03n4RPRiy6wNJKHDeYj7cchc/edit?usp=sharing <https://docs.google.com/spreadsheets/d/1Lz2xA_d9080A2_eWcTc03n4RPRiy6wNJKHDeYj7cchc/edit?usp=sharing>
>> 
>> https://docs.google.com/spreadsheets/d/1z3zFxYW7Cyfp33H0GUNJHwWRvwJW5Zy4M05oitdynHc/edit?usp=sharing <https://docs.google.com/spreadsheets/d/1z3zFxYW7Cyfp33H0GUNJHwWRvwJW5Zy4M05oitdynHc/edit?usp=sharing>
>> 
>> https://docs.google.com/spreadsheets/d/1s5SWFm3DyS0BQGw6fn7HtkMAcWJUz-bITiwh-kv6Z8k/edit?usp=sharing <https://docs.google.com/spreadsheets/d/1s5SWFm3DyS0BQGw6fn7HtkMAcWJUz-bITiwh-kv6Z8k/edit?usp=sharing>
>> 
>> https://docs.google.com/spreadsheets/d/1w31-7xnKrDJzItbJdrTJZEf1CP3FfazuKmvB-Zwygjw/edit?usp=sharing <https://docs.google.com/spreadsheets/d/1w31-7xnKrDJzItbJdrTJZEf1CP3FfazuKmvB-Zwygjw/edit?usp=sharing>
>> 
>> https://docs.google.com/spreadsheets/d/1k2fCfRJmoUwzwTqd7ewWPbFUZ0TV1VF_ZjIPSf-ZBVU/edit?usp=sharing <https://docs.google.com/spreadsheets/d/1k2fCfRJmoUwzwTqd7ewWPbFUZ0TV1VF_ZjIPSf-ZBVU/edit?usp=sharing>
>> 
>> Thanks again.
>> 
>> 
>> Charles LaPierre
>> Sr. Software Engineer
>> charlesl@benetech.org <mailto:charlesl@benetech.org>
>> 
>> 
>> 
> 
> 
> ----
> Ivan Herman, W3C
> Digital Publishing Lead
> Home: http://www.w3.org/People/Ivan/ <http://www.w3.org/People/Ivan/>
> mobile: +31-641044153
> ORCID ID: http://orcid.org/0000-0003-0782-2704 <http://orcid.org/0000-0003-0782-2704>
> 
> 
> 
>