Skip to content

Commit f9a2715

Browse files
HLeithnerHLeithner
authored
Merge branch 'main' into testing-docs
2 parents 4f540b1 + 4062056 commit f9a2715

File tree

15 files changed

+483
-10
lines changed

15 files changed

+483
-10
lines changed

‎.drone.yml‎

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ steps:
2222
from_secret: developer_host
2323
sftp_user:
2424
from_secret: sftp_user
25+
GITHUB_TOKEN:
26+
from_secret: github_token
2527
commands:
2628
- mkdir -p ~/.ssh
2729
- eval $(ssh-agent -s)
@@ -30,17 +32,21 @@ steps:
3032
- chmod 600 ~/.ssh/id_rsa
3133
- ssh-add
3234
- rclone config create server sftp host $developer_host user $sftp_user port 22
33-
- rclone -v sync build server:public_html
35+
- if [ -z "$${DRONE_PULL_REQUEST}" ]; then export TARGET=public_html; else export TARGET=wildcard.manual.joomlacode.org/sites/pr-$${DRONE_PULL_REQUEST}; fi
36+
- rclone -v sync build server:$TARGET
37+
- chmod +x test.sh
38+
- if [ ! -z "$${DRONE_PULL_REQUEST}" ]; then /bin/add_github_status.sh "Preview" "Generated preview for this pull request" "http://pr-$${DRONE_PULL_REQUEST}.manual.joomlacode.org" ; fi;
3439
when:
3540
branch:
36-
- main
41+
main
3742
status:
3843
- success
3944
event:
4045
- push
46+
- pull_request
4147

4248
---
4349
kind: signature
44-
hmac: 348c8ac11879e5515a5b167c9af1a7d6bba2f3bd66408a291f4f9f6ff27d8204
50+
hmac: 3d1303abd175ffda3aec141c6ea71d541f50f3c3e0752a68330fde5560386a58
4551

4652
...

‎README.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,11 @@ $ npm run build
3030

3131
This command generates static content into the `build` directory and can be served using any static contents hosting service.
3232

33+
### Preview for pull request
3334

35+
As part of the documentation validation we create a subdomain for previewing your pull request.
36+
The Link will be added to the "checks" section in the pull request as "preview". The url used
37+
is http://pr-[prnumber].manual.joomlacode.org
3438

3539
## How to use
3640

‎docs/accessibility/atag.md‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
sidebar_position: 3
3+
---
4+
ATAG Conformance
5+
===========
6+
In this section we will explain the Authoring Tool Accessibility Guidelines, which level of conformance we are aiming for, and how to learn more about ATAG.
7+
8+
:::caution TODO
9+
10+
This page is unfinished, please use the **Edit this Page** link at the bottom of this page to help make it more useful.
11+
12+
:::

‎docs/accessibility/best-practices/empty-template.md‎

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
Page Template
2+
===========
3+
import Tabs from '@theme/Tabs';
4+
import TabItem from '@theme/TabItem';
5+
6+
:::tip
7+
This is an empty template, intended to be used as a starting point for adding new best practices pages. Try to keep it consistent with other pages and fill out all relevant sections; sections marked "optional" can be removed if not relevant.
8+
:::
9+
10+
## Overview
11+
12+
Definition / explanation of what this page is all about.
13+
14+
### Best Practices
15+
* Add best practices here.
16+
* etc
17+
18+
### Common Mistakes
19+
* Add common errors here.
20+
21+
## Who is affected?
22+
People using screen readers need ....
23+
24+
People with cognitive disabilities need ... etc.
25+
26+
Who is impacted most by the accessibility of this element?
27+
28+
## Testing for accessibility
29+
<Tabs>
30+
<TabItem value="screenreader" label="With a screenreader">
31+
32+
How does someone test that this is accessible with a screenreader?
33+
1. Use the screen reader to navigate to ...
34+
2. Make sure ...
35+
3. Make sure ...
36+
4. If ... then it passes. ✅
37+
5. If ... then it fails. ❌
38+
39+
</TabItem>
40+
<TabItem value="inspector" label="With web inspector">
41+
42+
How does someone test that this is accessible with web inspector?
43+
1. Right Click > Inspect ... on the page.
44+
2. Make sure ...
45+
3. Make sure ...
46+
4. If ... then it passes. ✅
47+
5. If ... then it fails. ❌
48+
6. If ... then it passes. ✅
49+
7. If ... then it fails. ❌
50+
51+
</TabItem>
52+
</Tabs>
53+
54+
## Relevant WCAG Success Criteria
55+
* Link to the WCAG Success Criteria here. For example:
56+
* [WCAG criteria 1.3.1 - Info and Relationships](https://www.w3.org/TR/WCAG22/#info-and-relationships)
57+
58+
## Relevant ATAG Guidelines (optional)
59+
* Link to the ATAG Guideline(s) here. For example:
60+
* [Guideline A.3.2: (For the authoring tool user interface) Provide authors with enough time.](https://www.w3.org/TR/ATAG20/#gl_a32)
61+

‎docs/accessibility/best-practices/index.md‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
sidebar_position: 4
3+
---
4+
Best Practices for Accessible Design
5+
===========
6+
In this section we will explain different aspects to designing with accessibility in mind.
7+
8+
Suggested sub-pages:
9+
1. Colours
10+
2. Fonts
11+
3. Images
12+
4. Focus Order
13+
5. (add more)
14+
15+
:::caution TODO
16+
17+
This page is unfinished, please use the **Edit this Page** link at the bottom of this page to help make it more useful.
18+
19+
:::

‎docs/accessibility/code-for-humans.md‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
sidebar_position: 1
3+
---
4+
You code for humans, not machines.
5+
===========
6+
In this section we will explain what accessibility is and why it matters. This should be evocative and informative; why should people care?
7+
8+
:::caution TODO
9+
10+
This page is unfinished, please use the **Edit this Page** link at the bottom of this page to help make it more useful.
11+
12+
:::

‎docs/accessibility/element-library/empty-template.md‎

Lines changed: 114 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,114 @@
1+
Element Template
2+
===========
3+
import Tabs from '@theme/Tabs';
4+
import TabItem from '@theme/TabItem';
5+
6+
:::tip
7+
This is an empty template, intended to be used as a starting point for adding UI elements to the library. Try to keep it consistent with other elements and fill out all relevant sections; sections marked "optional" can be removed if not relevant.
8+
:::
9+
10+
## Overview
11+
12+
Definition / explanation of what this component is/how it works.
13+
14+
<Tabs>
15+
<TabItem value="front" label="Front End Screenshot">
16+
17+
Put front end/Cassiopeia screenshot here, if applicable. Don't forget alt text!
18+
19+
</TabItem>
20+
<TabItem value="back" label="Back End Screenshot">
21+
22+
Put back end/Atum screenshot here, if applicable. Don't forget alt text!
23+
24+
</TabItem>
25+
</Tabs>
26+
27+
## Usage
28+
### Requirements (optional)
29+
If this code only works in certain contexts or environments, add that here. For example:
30+
* PHP 8.0+
31+
* No IE Support
32+
33+
### Code Snippets
34+
35+
<Tabs>
36+
<TabItem value="front" label="Front End Usage">
37+
38+
:::info
39+
40+
Add notes about using this snippet in the front end, if applicable.
41+
42+
:::
43+
44+
```html title="Sample Front End Usage - ie, Cassiopia template"
45+
<!-- HTML Code Snippet Here -->
46+
```
47+
48+
</TabItem>
49+
<TabItem value="back" label="Back End Usage">
50+
51+
:::info
52+
53+
Add notes about using this snippet in the back end, if applicable.
54+
55+
:::
56+
57+
```html title="Sample Back End Usage - ie, Atum template"
58+
<!-- HTML Code Snippet Here -->
59+
```
60+
61+
</TabItem>
62+
</Tabs>
63+
64+
65+
66+
67+
### Best Practices
68+
* Add best practices here. For example, "Make sure you only use button elements when it will do an action, instead of navigating to a different page."
69+
* etc
70+
71+
### Common Mistakes
72+
* Add common errors here.
73+
74+
## Who is affected?
75+
People using screen readers need ....
76+
77+
People with cognitive disabilities need ... etc.
78+
79+
Who is impacted most by the accessibility of this element?
80+
81+
## Testing for accessibility
82+
<Tabs>
83+
<TabItem value="screenreader" label="With a screenreader">
84+
85+
How does someone test that this is accessible with a screenreader?
86+
1. Use the screen reader to navigate to ...
87+
2. Make sure ...
88+
3. Make sure ...
89+
4. If ... then it passes. ✅
90+
5. If ... then it fails. ❌
91+
92+
</TabItem>
93+
<TabItem value="inspector" label="With web inspector">
94+
95+
How does someone test that this is accessible with web inspector?
96+
1. Right Click > Inspect ... on the page.
97+
2. Make sure ...
98+
3. Make sure ...
99+
4. If ... then it passes. ✅
100+
5. If ... then it fails. ❌
101+
6. If ... then it passes. ✅
102+
7. If ... then it fails. ❌
103+
104+
</TabItem>
105+
</Tabs>
106+
107+
## Relevant WCAG Success Criteria
108+
* Link to the WCAG Success Criteria here. For example:
109+
* [WCAG criteria 1.3.1 - Info and Relationships](https://www.w3.org/TR/WCAG22/#info-and-relationships)
110+
111+
## Relevant ATAG Guidelines (optional)
112+
* Link to the ATAG Guideline(s) here. For example:
113+
* [Guideline A.3.2: (For the authoring tool user interface) Provide authors with enough time.](https://www.w3.org/TR/ATAG20/#gl_a32)
114+

‎docs/accessibility/code-blocks/index.md‎ renamed to ‎docs/accessibility/element-library/index.md‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,7 @@
1-
Code Blocks
1+
---
2+
sidebar_position: 4
3+
---
4+
Accessible UI Library
25
===========
36
In this section we will show how to write accessible elements for Joomla.
47
:::caution TODO

‎docs/accessibility/template.md‎ renamed to ‎docs/accessibility/further-reading.md‎

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,9 @@
1-
Template
2-
========
3-
This is the content for developing an accessible template.
1+
---
2+
sidebar_position: 7
3+
---
4+
Further Reading
5+
===========
6+
Additional accessibility resources can go here.
47

58
:::caution TODO
69

‎docs/accessibility/reporting-issues.md‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
sidebar_position: 6
3+
---
4+
Reporting Errors
5+
===========
6+
How do people report accessibility issues in the CMS or template to us?
7+
8+
:::caution TODO
9+
10+
This page is unfinished, please use the **Edit this Page** link at the bottom of this page to help make it more useful.
11+
12+
:::

0 commit comments

Comments
 (0)