Re: References for the Note

Hi Shawn and all,

+1 from me too.

Thanks.

Kindest Regards,
Laura

On 2/16/16, Rochford, John <john.rochford@umassmed.edu> wrote:
> +1
>
> From: Jim Allan [mailto:jimallan@tsbvi.edu]
> Sent: Tuesday, February 16, 2016 10:32 AM
> To: Shawn Henry <shawn@w3.org>
> Cc: public-low-vision-a11y-tf <public-low-vision-a11y-tf@w3.org>
> Subject: Re: References for the Note
>
> Agree.
> References[1] for items in Requirements that need references. Research[2]
> for all the things we find.  A few (or some) might get used in References
> 1. https://www.w3.org/WAI/GL/low-vision-a11y-tf/wiki/References
> 2. https://www.w3.org/WAI/GL/low-vision-a11y-tf/wiki/Research
>
> On Mon, Feb 15, 2016 at 6:52 AM, Shawn Henry
> <shawn@w3.org<mailto:shawn@w3.org>> wrote:
> LVTF folks,
>
> Much of the information in our draft Note "Accessibility Requirements for
> People with Low Vision" should have sources indicated. Some sentences have
> multiple points that should have sources.
>
> If we were to include sources within the document in W3C reference style
> [W3C-Ref], it would significantly clutter the document and decrease
> readability for everyone (not specifically people with low vision :). For
> example, see the second paragraph of <https://www.w3.org/2001/06/manual/> --
> and consider that we would have multiple sources per sentence.
>
> Also, many of the points in the Note have multiple good references. If the
> references were listed in the document, we would need to spend time and
> energy deciding which to include in the doc.
>
> One approach would be to put the sources in a separate page. (We could put
> them in a wiki page for now so it is easy to edit, and move them to a WAI
> web page that is more stable when the Note is complete.)
> This would avoid clutter in the main doc (and save us the energy of refining
> to a limited number of references for each point).
>
> This approach is currently drafted. The Note Introduction
> <http://w3c.github.io/low-vision-a11y-tf/requirements.html#introduction>
> says:
> "_References_ provides sources for the information in this document"
>
> A References page is started at:
>         <https://www.w3.org/WAI/GL/low-vision-a11y-tf/wiki/References>
> (We could still keep the listings limited to the more appropriate
> authoritative, original, and international references -- not just list all
> that we find.)
>
> Thoughts on this approach?
>
> ~Shawn
>
> [W3C-Ref] https://www.w3.org/2001/06/manual/#References
>
>
>
> --
> Jim Allan, Accessibility Coordinator
> Texas School for the Blind and Visually Impaired
> 1100 W. 45th St., Austin, Texas 78756
> voice 512.206.9315    fax: 512.206.9264  http://www.tsbvi.edu/
> "We shape our tools and thereafter our tools shape us." McLuhan, 1964
>


-- 
Laura L. Carlson

Received on Tuesday, 16 February 2016 17:33:29 UTC