From 01aad50f9dacb37ca7044288cbe6b7ee7a26107c Mon Sep 17 00:00:00 2001 From: fria <138676274+friadev@users.noreply.github.com> Date: Mon, 4 Nov 2024 20:51:09 -0600 Subject: [PATCH 01/12] Add Accessibility Page --- docs/meta/accessibility.md | 7 +++++++ mkdocs.yml | 1 + 2 files changed, 8 insertions(+) create mode 100644 docs/meta/accessibility.md diff --git a/docs/meta/accessibility.md b/docs/meta/accessibility.md new file mode 100644 index 0000000000..76bc97f5b8 --- /dev/null +++ b/docs/meta/accessibility.md @@ -0,0 +1,7 @@ +--- +title: Accessibility +description: A guide for contributors on creating accessible content. +--- + +At Privacy Guides, we strive to make our website as accessible as possible so we can reach everyone with our message. + diff --git a/mkdocs.yml b/mkdocs.yml index b67a82985d..a94d5d67fe 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -461,6 +461,7 @@ nav: - "meta/brand.md" - "meta/translations.md" - !ENV [NAV_TECHNICAL_GUIDES, "Technical Guides"]: + - "meta/accessibility.md" - "meta/uploading-images.md" - "meta/git-recommendations.md" - "meta/commit-messages.md" From 3edf49c68c1034164964da2f3947a8affbb44735 Mon Sep 17 00:00:00 2001 From: fria <138676274+friadev@users.noreply.github.com> Date: Mon, 4 Nov 2024 21:03:06 -0600 Subject: [PATCH 02/12] add link to wcag --- docs/meta/accessibility.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/meta/accessibility.md b/docs/meta/accessibility.md index 76bc97f5b8..5ae89ada22 100644 --- a/docs/meta/accessibility.md +++ b/docs/meta/accessibility.md @@ -5,3 +5,4 @@ description: A guide for contributors on creating accessible content. At Privacy Guides, we strive to make our website as accessible as possible so we can reach everyone with our message. +Try to follow the [WCAG guidelines](https://www.wcag.com) as closely as possible when contributing to the site. \ No newline at end of file From ce4c08abe03b93350544b455bc88c4f9727b3894 Mon Sep 17 00:00:00 2001 From: fria <138676274+friadev@users.noreply.github.com> Date: Mon, 4 Nov 2024 21:14:10 -0600 Subject: [PATCH 03/12] add color contrast checker --- docs/meta/accessibility.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/meta/accessibility.md b/docs/meta/accessibility.md index 5ae89ada22..875e665cf8 100644 --- a/docs/meta/accessibility.md +++ b/docs/meta/accessibility.md @@ -5,4 +5,6 @@ description: A guide for contributors on creating accessible content. At Privacy Guides, we strive to make our website as accessible as possible so we can reach everyone with our message. -Try to follow the [WCAG guidelines](https://www.wcag.com) as closely as possible when contributing to the site. \ No newline at end of file +Try to follow the [WCAG guidelines](https://www.wcag.com) as closely as possible when contributing to the site. + +You can use this [color contrast checker](https://webaim.org/resources/contrastchecker/) to verify colors meet the guidelines. \ No newline at end of file From 2a11e9f140d4ed76b5781a2d46d909e466a01d90 Mon Sep 17 00:00:00 2001 From: fria <138676274+friadev@users.noreply.github.com> Date: Mon, 4 Nov 2024 21:32:36 -0600 Subject: [PATCH 04/12] add info --- docs/meta/accessibility.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/meta/accessibility.md b/docs/meta/accessibility.md index 875e665cf8..0f37b3c653 100644 --- a/docs/meta/accessibility.md +++ b/docs/meta/accessibility.md @@ -7,4 +7,14 @@ At Privacy Guides, we strive to make our website as accessible as possible so we Try to follow the [WCAG guidelines](https://www.wcag.com) as closely as possible when contributing to the site. -You can use this [color contrast checker](https://webaim.org/resources/contrastchecker/) to verify colors meet the guidelines. \ No newline at end of file +You can use this [color contrast checker](https://webaim.org/resources/contrastchecker/) to verify colors meet the guidelines. + +Make sure to use html/markdown elements instead of images/emojis when possible, for example for checkboxes you should use + +`- [x]` which will render as + +- [x] + +Don't use + +:white_check_mark: \ No newline at end of file From 0135344e34ab75ed65c503bf6e03cdde05a3292a Mon Sep 17 00:00:00 2001 From: fria <138676274+friadev@users.noreply.github.com> Date: Tue, 5 Nov 2024 00:17:51 -0600 Subject: [PATCH 05/12] fix --- docs/meta/accessibility.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/meta/accessibility.md b/docs/meta/accessibility.md index 0f37b3c653..e010da5a57 100644 --- a/docs/meta/accessibility.md +++ b/docs/meta/accessibility.md @@ -13,7 +13,7 @@ Make sure to use html/markdown elements instead of images/emojis when possible, `- [x]` which will render as -- [x] +- [x] Don't use From 7c8044eb445394e4e0c93e903caaf084eddd7004 Mon Sep 17 00:00:00 2001 From: fria <138676274+friadev@users.noreply.github.com> Date: Tue, 5 Nov 2024 00:25:20 -0600 Subject: [PATCH 06/12] spacing --- docs/meta/accessibility.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/meta/accessibility.md b/docs/meta/accessibility.md index e010da5a57..037eb384cb 100644 --- a/docs/meta/accessibility.md +++ b/docs/meta/accessibility.md @@ -15,6 +15,7 @@ Make sure to use html/markdown elements instead of images/emojis when possible, - [x] + Don't use :white_check_mark: \ No newline at end of file From 039cb86330f3dae446536e4e6b79a54dcee13603 Mon Sep 17 00:00:00 2001 From: fria <138676274+friadev@users.noreply.github.com> Date: Thu, 21 Nov 2024 12:44:07 -0600 Subject: [PATCH 07/12] add logo info --- docs/meta/accessibility.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/meta/accessibility.md b/docs/meta/accessibility.md index 037eb384cb..43de012977 100644 --- a/docs/meta/accessibility.md +++ b/docs/meta/accessibility.md @@ -5,6 +5,8 @@ description: A guide for contributors on creating accessible content. At Privacy Guides, we strive to make our website as accessible as possible so we can reach everyone with our message. +## Guidelines + Try to follow the [WCAG guidelines](https://www.wcag.com) as closely as possible when contributing to the site. You can use this [color contrast checker](https://webaim.org/resources/contrastchecker/) to verify colors meet the guidelines. @@ -18,4 +20,12 @@ Make sure to use html/markdown elements instead of images/emojis when possible, Don't use -:white_check_mark: \ No newline at end of file +:white_check_mark: + +This will be easier for things like screenreaders to interpret. + +## Company Logos + +Sometimes a company logo will not show up well in either light mode or dark mode. In these cases, try to find a version of the logo that looks good in both light and dark modes or see if they have different versions of the logo for light and dark mode. + +It never hurts to contact the developers and ask if you can't find the proper logos. \ No newline at end of file From af6e6d3baf44b132ff33d70ba64f75a98e7f6f5c Mon Sep 17 00:00:00 2001 From: fria <138676274+friadev@users.noreply.github.com> Date: Thu, 21 Nov 2024 12:45:41 -0600 Subject: [PATCH 08/12] spacing --- docs/meta/accessibility.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/meta/accessibility.md b/docs/meta/accessibility.md index 43de012977..36a97b008e 100644 --- a/docs/meta/accessibility.md +++ b/docs/meta/accessibility.md @@ -18,6 +18,7 @@ Make sure to use html/markdown elements instead of images/emojis when possible, - [x] + Don't use :white_check_mark: From db120fe4ead9cc0db53d40922b428da0a77dd1d4 Mon Sep 17 00:00:00 2001 From: fria <138676274+friadev@users.noreply.github.com> Date: Thu, 21 Nov 2024 12:48:54 -0600 Subject: [PATCH 09/12] wording --- docs/meta/accessibility.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/meta/accessibility.md b/docs/meta/accessibility.md index 36a97b008e..4f7e9f88b3 100644 --- a/docs/meta/accessibility.md +++ b/docs/meta/accessibility.md @@ -3,7 +3,7 @@ title: Accessibility description: A guide for contributors on creating accessible content. --- -At Privacy Guides, we strive to make our website as accessible as possible so we can reach everyone with our message. +At Privacy Guides, we strive to make our website as accessible as possible so we can reach as many people as possible. ## Guidelines From 01f7ca62c03bfcb120f6e36c114239d44a4527d4 Mon Sep 17 00:00:00 2001 From: fria <138676274+friadev@users.noreply.github.com> Date: Thu, 21 Nov 2024 12:51:48 -0600 Subject: [PATCH 10/12] fix checkmark --- docs/meta/accessibility.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/docs/meta/accessibility.md b/docs/meta/accessibility.md index 4f7e9f88b3..71db15a5bd 100644 --- a/docs/meta/accessibility.md +++ b/docs/meta/accessibility.md @@ -15,13 +15,11 @@ Make sure to use html/markdown elements instead of images/emojis when possible, `- [x]` which will render as -- [x] - - +- [x] Check Don't use -:white_check_mark: +:white_check_mark: Check This will be easier for things like screenreaders to interpret. From adcb0a703ee405c29d440e0c1289ded896c19d5e Mon Sep 17 00:00:00 2001 From: fria <138676274+friadev@users.noreply.github.com> Date: Thu, 21 Nov 2024 12:54:01 -0600 Subject: [PATCH 11/12] fix repetitive wording --- docs/meta/accessibility.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/meta/accessibility.md b/docs/meta/accessibility.md index 71db15a5bd..dafa7c32ff 100644 --- a/docs/meta/accessibility.md +++ b/docs/meta/accessibility.md @@ -3,7 +3,7 @@ title: Accessibility description: A guide for contributors on creating accessible content. --- -At Privacy Guides, we strive to make our website as accessible as possible so we can reach as many people as possible. +At Privacy Guides, we strive to make our website as accessible as possible so we can reach as many people as we can. ## Guidelines From ccbc41963b9e75405d8b22f8d4a75a1ea726e5e3 Mon Sep 17 00:00:00 2001 From: fria <138676274+friadev@users.noreply.github.com> Date: Thu, 21 Nov 2024 12:56:01 -0600 Subject: [PATCH 12/12] add more clarification on logos --- docs/meta/accessibility.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/meta/accessibility.md b/docs/meta/accessibility.md index dafa7c32ff..884e088603 100644 --- a/docs/meta/accessibility.md +++ b/docs/meta/accessibility.md @@ -25,6 +25,8 @@ This will be easier for things like screenreaders to interpret. ## Company Logos -Sometimes a company logo will not show up well in either light mode or dark mode. In these cases, try to find a version of the logo that looks good in both light and dark modes or see if they have different versions of the logo for light and dark mode. +Sometimes a company logo will not show up well in either light mode or dark mode. In these cases, try to find a version of the logo that looks good in both light and dark modes or see if they have a light mode version and a dark mode of their logo. + +Try to stick to official logos instead of making your own, although in cases where there is no althernative logos from unofficial sources are acceptable. It never hurts to contact the developers and ask if you can't find the proper logos. \ No newline at end of file