z390development / z390

z390 Portable Mainframe Assembler and Emulator Project
GNU General Public License v2.0
39 stars 15 forks source link

RPI 1620: Document link accessability issues - time and date section #193

Open adelosa opened 3 years ago

adelosa commented 3 years ago

Raised by Liz Cook 2017/08/15 page www.z390.org/z390_Standard_Timestamp_Support.htm links to timeanddate.com from local time zone. Unfortunately, that site isn't very accessible for the sight impaired. Would you consider adding a link to a more accessible version like www.thetimenow.com/worldclock.php which is WCAG 2.0 compatible?

adelosa commented 3 years ago

So I just reviewed the page link http://www.z390.org/z390_Standard_Timestamp_Support.htm and while the content is facinating if you are into time, I'm not sure the detail belongs as part of the z390 manuals. If the content belongs anywhere, its probably in the SVC services doc (see https://z390development.github.io/z390/svc_services/) Any views on what parts of this content should be saved. My view is that there is no content that makes sense for the z390 manual so I am inclined to move forward without it.. but I am new here, so would love to get views from @jyganci @abekornelis and @dsh33782.

abekornelis commented 3 years ago

It is indeed very informative, but only a very small amount of it is specific for z390. I would suggest to move that information to the description of the TIME macro (macro services and/or SVC services manuals). It would be interesting to know Don's opinion about this, though.

dsh33782 commented 3 years ago

Abe, all

I am very interested in making the z390 project WCAG 2.1 compliant which should include changing any link to websites which are not compliant if possible:

https://www.w3.org/WAI/standards-guidelines/wcag/

Being a 76 year old person with low vision due to long term aggressive glaucoma,

I am particularly interested in the section on color perception. I need high contrast to see text and when I use white on black accessibility settings, a lot of websites do not comply and some are not visible at all. Here is a little from guidelines:

1.4.1Use of Color

Level A

Color is not used as the only visual means of conveying information, indicating an action, prompting a response, or distinguishing a visual element.

Note 1: This success criterion addresses color perception specifically. Other forms of perception are covered in Guideline 1.3 including programmatic access to color and other visual presentation coding.

Don Higgins

@.> @.

http://www.don-higgins.net/ www.donhiggins.org

From: Abe Kornelis @.> Sent: Wednesday, June 2, 2021 3:50 AM To: z390development/z390 @.> Cc: dsh33782 @.>; Mention @.> Subject: Re: [z390development/z390] RPI 1620: Document link accessability issues - time and date section (#193)

It is indeed very informative, but only a very small amount of it is specific for z390. I would suggest to move that information to the description of the TIME macro (macro services and/or SVC services manuals). It would be interesting to know Don's opinion about this, though.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/z390development/z390/issues/193#issuecomment-852822018 , or unsubscribe https://github.com/notifications/unsubscribe-auth/AHJYRRXJERD4ELKDZZV7DDLTQXPDRANCNFSM42SI2LSQ . https://github.com/notifications/beacon/AHJYRRQZZ6OPHJ4CO7EDVQTTQXPDRA5CNFSM42SI2LS2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOGLKQQAQ.gif

dsh33782 commented 3 years ago

Anthony, all

I agree the z390 project scope does not include teaching all about timestamps so we can leave it out just like I think we should skip teaching about other tools such as Eclipse and Notepad++.

I do think it would be great if we included recommended reference links to tools and standards we support. We could even include email contacts for those willing to help others by answering questions about tools and standards.

Don Higgins

@.> @.

http://www.don-higgins.net/ www.donhiggins.org

From: Anthony Delosa @.> Sent: Wednesday, June 2, 2021 1:57 AM To: z390development/z390 @.> Cc: dsh33782 @.>; Mention @.> Subject: Re: [z390development/z390] RPI 1620: Document link accessability issues - time and date section (#193)

So I just reviewed the page link http://www.z390.org/z390_Standard_Timestamp_Support.htm and while the content is facinating if you are into time, I'm not sure the detail belongs as part of the z390 manuals. If the content belongs anywhere, its probably in the SVC services doc (see https://z390development.github.io/z390/svc_services/) Any views on what parts of this content should be saved. My view is that there is no content that makes sense for the z390 manual so I am inclined to move forward without it.. but I am new here, so would love to get views from @jyganci https://github.com/jyganci @abekornelis https://github.com/abekornelis and @dsh33782 https://github.com/dsh33782 .

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/z390development/z390/issues/193#issuecomment-852756582 , or unsubscribe https://github.com/notifications/unsubscribe-auth/AHJYRRXJYI2G2S662OHNLV3TQXBY7ANCNFSM42SI2LSQ . https://github.com/notifications/beacon/AHJYRRUFMJQSFYG76QJHCQ3TQXBY7A5CNFSM42SI2LS2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOGLKAQZQ.gif

abekornelis commented 3 years ago

Don,

you're not the only person with eyesight problems. I support your suggestion to the extent that we make all new content accessible according to the guidelines.

I'd like to know how Anthony feels about this. And I'd be curious to learn whether or not this will take a lot of effort.

Kind regards, Abe

Op 02/06/2021 om 12:11 schreef dsh33782:

Abe, all

I am very interested in making the z390 project WCAG 2.1 compliant which should include changing any link to websites which are not compliant if possible:

https://www.w3.org/WAI/standards-guidelines/wcag/

Being a 76 year old person with low vision due to long term aggressive glaucoma,

I am particularly interested in the section on color perception. I need high contrast to see text and when I use white on black accessibility settings, a lot of websites do not comply and some are not visible at all. Here is a little from guidelines:

1.4.1Use of Color

Level A

Color is not used as the only visual means of conveying information, indicating an action, prompting a response, or distinguishing a visual element.

Note 1: This success criterion addresses color perception specifically. Other forms of perception are covered in Guideline 1.3 including programmatic access to color and other visual presentation coding.

Don Higgins

@.> @.

http://www.don-higgins.net/ www.donhiggins.org

From: Abe Kornelis @.> Sent: Wednesday, June 2, 2021 3:50 AM To: z390development/z390 @.> Cc: dsh33782 @.>; Mention @.> Subject: Re: [z390development/z390] RPI 1620: Document link accessability issues - time and date section (#193)

It is indeed very informative, but only a very small amount of it is specific for z390. I would suggest to move that information to the description of the TIME macro (macro services and/or SVC services manuals). It would be interesting to know Don's opinion about this, though.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/z390development/z390/issues/193#issuecomment-852822018 , or unsubscribe https://github.com/notifications/unsubscribe-auth/AHJYRRXJERD4ELKDZZV7DDLTQXPDRANCNFSM42SI2LSQ . https://github.com/notifications/beacon/AHJYRRQZZ6OPHJ4CO7EDVQTTQXPDRA5CNFSM42SI2LS2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOGLKQQAQ.gif

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/z390development/z390/issues/193#issuecomment-852901063, or unsubscribe https://github.com/notifications/unsubscribe-auth/AMFZ4UIYMLYCI7OZCYLTK5LTQX7VNANCNFSM42SI2LSQ.

jyganci commented 3 years ago

The timestamp information is very interesting, and as Abe said, informative. How about moving it into an Appendix to the SVC services manual and provide a link to it where the TIME macro is described?

Regards,

John Ganci

On Wed, Jun 2, 2021 at 2:50 AM Abe Kornelis @.***> wrote:

It is indeed very informative, but only a very small amount of it is specific for z390. I would suggest to move that information to the description of the TIME macro (macro services and/or SVC services manuals). It would be interesting to know Don's opinion about this, though.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/z390development/z390/issues/193#issuecomment-852822018, or unsubscribe https://github.com/notifications/unsubscribe-auth/AOAPAJ2M3KXN77FZSC44P53TQXPDRANCNFSM42SI2LSQ .

dsh33782 commented 3 years ago

Abe, all

Thanks for your support. Two examples of commonly used tools that do not conform to color and contrast settings include Eclipse and Microsoft Expression Web 4. For both of these I have to turn off white on black Windows 10 settings in order to see some of the controls on the screen.

Don Higgins

@.> @.

http://www.don-higgins.net/ www.donhiggins.org

From: Abe Kornelis @.> Sent: Wednesday, June 2, 2021 10:00 AM To: z390development/z390 @.> Cc: dsh33782 @.>; Mention @.> Subject: Re: [z390development/z390] RPI 1620: Document link accessability issues - time and date section (#193)

Don,

you're not the only person with eyesight problems. I support your suggestion to the extent that we make all new content accessible according to the guidelines.

I'd like to know how Anthony feels about this. And I'd be curious to learn whether or not this will take a lot of effort.

Kind regards, Abe

Op 02/06/2021 om 12:11 schreef dsh33782:

Abe, all

I am very interested in making the z390 project WCAG 2.1 compliant which should include changing any link to websites which are not compliant if possible:

https://www.w3.org/WAI/standards-guidelines/wcag/

Being a 76 year old person with low vision due to long term aggressive glaucoma,

I am particularly interested in the section on color perception. I need high contrast to see text and when I use white on black accessibility settings, a lot of websites do not comply and some are not visible at all. Here is a little from guidelines:

1.4.1Use of Color

Level A

Color is not used as the only visual means of conveying information, indicating an action, prompting a response, or distinguishing a visual element.

Note 1: This success criterion addresses color perception specifically. Other forms of perception are covered in Guideline 1.3 including programmatic access to color and other visual presentation coding.

Don Higgins

@. <mailto:@.> > @. <mailto:@.>

http://www.don-higgins.net/ www.donhiggins.org http://www.donhiggins.org

From: Abe Kornelis @. <mailto:@.> > Sent: Wednesday, June 2, 2021 3:50 AM To: z390development/z390 @. <mailto:@.> > Cc: dsh33782 @. <mailto:@.> >; Mention @. <mailto:@.> > Subject: Re: [z390development/z390] RPI 1620: Document link accessability issues - time and date section (#193)

It is indeed very informative, but only a very small amount of it is specific for z390. I would suggest to move that information to the description of the TIME macro (macro services and/or SVC services manuals). It would be interesting to know Don's opinion about this, though.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/z390development/z390/issues/193#issuecomment-852822018 , or unsubscribe https://github.com/notifications/unsubscribe-auth/AHJYRRXJERD4ELKDZZV7DDLTQXPDRANCNFSM42SI2LSQ . https://github.com/notifications/beacon/AHJYRRQZZ6OPHJ4CO7EDVQTTQXPDRA5CNFSM42SI2LS2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOGLKQQAQ.gif

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/z390development/z390/issues/193#issuecomment-852901063, or unsubscribe https://github.com/notifications/unsubscribe-auth/AMFZ4UIYMLYCI7OZCYLTK5LTQX7VNANCNFSM42SI2LSQ.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/z390development/z390/issues/193#issuecomment-853052286 , or unsubscribe https://github.com/notifications/unsubscribe-auth/AHJYRRW6PDVVGZLQMX4DD5DTQY2MPANCNFSM42SI2LSQ . https://github.com/notifications/beacon/AHJYRRVQJ2HKR4HDR2ID5Q3TQY2MPA5CNFSM42SI2LS2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOGLMIW7Q.gif