Re: draft text for charter

> On 7 Mar 2017, at 11:22, Avneesh Singh <avneesh.sg@gmail.com> wrote:
> 
> Dear All,
> 
> I am copying the scope staement from the latest commit of Ivan.
> As per the text, it is looking fine to me. But I also have a concern that if one statement in scope will be out of bullet points like this, then some people will again start process of finding another place for it.
> Thoughts welcome..

I think your fear is justified; put it another way, that paragraph, put separately, seems to be a bit out of context. I must admit I have a preference, personally, to have this paragraph among the bullet items instead (as originally planned).

That being said, I am afraid we are dangerously close to bike-shedding.

Ivan


> 
> 2. Scope
> 
> For the purpose of this document, A Web Publication (WP) is a collection of one or more constituent resources, organized together in a uniquely identifiable grouping that may be presented using standard Open Web Platform technologies. A Web Publication is not just a collection of links—the act of publishing involves obtaining resources and organizing them into a publication, which must be “manifested” by having files on a Web server. Thus the publisher provides an origin for the WP, and a URL that can uniquely identify that manifestation. A Web Publication must provide a number of features whose detailed specification is in the scope of this Working Group. While some of the detailed requirements have already been documented elsewhere, the most important and high level characteristics, that must be translated into specifications are:
> • A Web Publication may be portable, and be hosted at some other origin. However, it must preserve information about its original origin and identity, so that references to a portable copy can be reconciled with the original publication, and so that the other origin can make informed choices about how much trust to grant to the publication.
> • A Web Publication may be packaged by having all its constituent resources combined into a single file. The package must include the unique identifier of the manifestation—a Web Publication’s origin is essential information if it is to becomes portable. The act of packaging must be reversible; one must be able to recover the original structure and organization.
> • It must be possible to make Web Publications accessible to a broad range of readers with different needs and capabilities.
> • A Web Publication must be available and functional while the user is offline. A user should, as much as possible, have a seamless experience of interacting with a Web Publication regardless of their network connection. We make no distinction between online and offline when defining Web Publications.
> • A Web Publication, having an identity and nature beyond its constituent resources, will have metadata that describes the publication as a whole. We also introduce the abstract concept of a manifest, which serves to carry information about the constituent resources of the publication. The metadata and manifest will also incorporate information about the sequence and presentation of the content.
> •A Web Publication must provide access to a range metainformation including (but not restricted to): ◦table of content, default or alternate reading order
> ◦security and authentication data
> ◦metadata like author(s), title, unique identification
> 
> 
> Recommendation-track deliverables will contain mechanisms to make Web Publications accessible to a broad range of readers with different needs and capabilities. This includes general WCAG and WAI requirements of the W3C; additional extended requirements will be identified as conformance requirements in the Working Group’s normative specifications. Profiles of Web Publications may be defined with more stringent accessibility requirements.
> 
> With regards
> Avneesh
> -----Original Message----- From: Avneesh Singh
> Sent: Tuesday, February 28, 2017 14:18
> To: Ivan Herman
> Cc: Deborah Kaplan ; public-dpub-accessibility@w3.org
> Subject: Re: draft text for charter
> 
> 
>> On 28 Feb 2017, at 06:07, Avneesh Singh <avneesh.sg@gmail.com> wrote:
>> 
>> Ivan wrote:
>> [[
>> The Working Group will incorporate accessibility considerations into the
>> Working Group's deliverables. Recommendation-track deliverables  will
>> contain mechanisms to make Web Publications accessible to a broad range of
>> readers with different needs and capabilities.
>> ]]
>> 
>> may be considered to be superfluous in the charter. The reason is that this is a requirement for any W3C recommendation, mainly when talking about user-facing specifications like this. In other words, this does not add anything to what is already a default requirement, does it?
>> 
>> Avneesh: This is retained from the old text mainly due to the concerns of changing things too much after getting to a consensus on mailing list. This was a concern raised by Leonard in DPUB call 2 weeks ago.
>> 
>> 
> 
> Yep, you're right, I forgot about this. I was simply looking at the proposal
> text.
> 
> Maybe what we should do is to then propose the whole text, but explicitly
> raise my reservation as part of the discussion next week Monday. Would that
> work?
> 
> Avneesh: Looks as a good plan to me. Accessibility group members can chime
> in if any one disagrees.
> 
> 
>> For me, the important point is:
>> 
>> [[
>> ...additional extended requirements will be
>> identified as conformance requirements in the Working Group’s normative
>> specifications. Profiles of Web Publications may be defined with more
>> stringent accessibility requirements.
>> ]]
>> 
>> because it shows that we _may_ have extra requirements and we intend to put these into the spec as well. For me, _that_ is the important point...
>> 
>> Avneesh: This is the core of the message that we intend to give. There would be requirements that are not covered by WCAG/WAI/ARIA, and we need to work on them in digital publishing working group, to ensure that it is possible to make WP/EPUB 4 publications  accessible.
> 
> Absolutely. That text, possibly with word-smithing, is the essential part
> that, IMHO, MUST be part of the charter.
> 
> I think we are in a wild agreement:-)
> 
> Avneesh: Yes.
> 
> 
> With regards
> Avneesh
>>> On 27 Feb 2017, at 17:47, deborah.kaplan <deborah.kaplan@suberic.net> wrote:
>>> 
>>> I am fine with this text. It's longer than I thought Ivan wanted it to
>>> be,  but if he thinks it's aan acceptable length I think it's relatively
>>> clear while also being explicit  about the fact that we will incorporate
>>> accessibility requirements in any recommendation-track deliverables,,
>>> and the fact that we will be coordinating with other groups.
>> 
>> 
>> Well… it is a little bit too long, compared to the rest of the charter. That, by itself, may be ok, however (if I play devil's advocate, the following text:
>> 
>> [[
>> The Working Group will incorporate accessibility considerations into the
>> Working Group's deliverables. Recommendation-track deliverables  will
>> contain mechanisms to make Web Publications accessible to a broad range of
>> readers with different needs and capabilities.
>> ]]
>> 
>> may be considered to be superfluous in the charter. The reason is that this is a requirement for any W3C recommendation, mainly when talking about user-facing specifications like this. In other words, this does not add anything to what is already a default requirement, does it?
>> 
>> For me, the important point is:
>> 
>> [[
>> ...additional extended requirements will be
>> identified as conformance requirements in the Working Group’s normative
>> specifications. Profiles of Web Publications may be defined with more
>> stringent accessibility requirements.
>> ]]
>> 
>> because it shows that we _may_ have extra requirements and we intend to put these into the spec as well. For me, _that_ is the important point...
>> 
>> 
>>> 
>>> My only issue  is the following:
>>> 
>>> "The Digital Publishing Working Group will coordinate with the WCAG Working
>>> Group to integrate accessibility requirements created as part of its
>>> recommendation-track deliverables into generalized technology."
>>> 
>>> I don't think we should be limiting ourselves to coordinating with WCAG.
>>> I would prefer  "will coordinate with the WCAG Working Group, as well as
>>> any other  working groups as needed, to integrate …"
>> 
>> This may be vague, what about "wg-s concerned with accessibility', or something like that?
>> 
>> Ivan
>> 
>> 
>>> 
>>> Deborah
>>> 
>>> On Mon, 27 Feb 2017, Avneesh Singh wrote:
>>> 
>>>> Dear all,
>>>> 
>>>> A reminder, we need to complete the text for accessibility soon. Please provide your comments so that it can be published with next update of charter.
>>>> 
>>>> 
>>>> With regards
>>>> Avneesh
>>>> -----Original Message----- From: Avneesh Singh
>>>> Sent: Tuesday, February 21, 2017 12:34
>>>> To: George Kerscher ; 'Ivan Herman'
>>>> Cc: 'Deborah Kaplan' ; public-dpub-accessibility@w3.org
>>>> Subject: Re: draft text for charter
>>>> 
>>>> Dear accessibility group,
>>>> 
>>>> After our call yesterday, George has merged the old accessibility text that
>>>> was proposed by Matt with the new text added by Ivan in the branch.
>>>> I will also like to mention that in the branch created by Ivan, the
>>>> accessibility text is placed at more than one places. The first paragraph
>>>> was placed by Ivan in the scope statement, and other part was placed at the
>>>> places where the charter talked about coordination with ARIA and WCAG.
>>>> We are fine with this split, and the new text snippet is the rewrite of only
>>>> the scope statements.
>>>> 
>>>> New text for scope statement:
>>>> The Working Group will incorporate accessibility considerations into the
>>>> Working Group's deliverables. Recommendation-track deliverables  will
>>>> contain mechanisms to make Web Publications accessible to a broad range of
>>>> readers with different needs and capabilities. This includes general WCAG
>>>> and WAI requirements of the W3C; additional extended requirements will be
>>>> identified as conformance requirements in the Working Group’s normative
>>>> specifications. Profiles of Web Publications may be defined with more
>>>> stringent accessibility requirements.
>>>> 
>>>> And following is the text in coordination section:
>>>> The Digital Publishing Working Group will coordinate with the WCAG Working
>>>> Group to integrate accessibility requirements created as part of its
>>>> recommendation-track deliverables into generalized technology. One or more
>>>> pipeline of the requirements will be maintained to manage diverse turnaround
>>>> times of the W3C groups.
>>>> 
>>>> With regards
>>>> Avneesh
>> 
>> 
>> ----
>> Ivan Herman, W3C
>> Publishing@W3C Technical Lead
>> Home: http://www.w3.org/People/Ivan/
>> mobile: +31-641044153
>> ORCID ID: http://orcid.org/0000-0003-0782-2704
>> 
>> 
> 
> 
> ----
> Ivan Herman, W3C
> Publishing@W3C Technical Lead
> Home: http://www.w3.org/People/Ivan/
> mobile: +31-641044153
> ORCID ID: http://orcid.org/0000-0003-0782-2704
> 
> 
> 
> 


----
Ivan Herman, W3C
Publishing@W3C Technical Lead
Home: http://www.w3.org/People/Ivan/
mobile: +31-641044153
ORCID ID: http://orcid.org/0000-0003-0782-2704