aws-amplify / aws-amplify/docs

Alt text is not descriptive [../tools/console files]

Open
#7,069 0 comments 0 reactions 0 assignees View on GitHub
web accessibility
Dominant language
MDX
Stars
506
Forks
1.1k
Avg merge
3h 14m
Merged PRs (30d)
1

Description

**Describe the content issue**:
Images listed below do not have descriptive/informative alt text. For markdown the alt text is located between the square brackets, `![alt text](...)`.

The list below isn't exhaustive since I found these images based on the word count for the alt text, but it should be a good starting point to make our alt text better for people who use screen readers.

Some resources to help write alt text:
- https://webaim.org/techniques/alttext/
- https://www.a11yproject.com/posts/are-you-making-these-five-mistakes-when-writing-alt-text/

 

https://github.com/aws-amplify/docs/blob/main/src/pages/[platform]/tools/console/index.mdx:
```
93
94: ![GIF showing data modeling](/images/console/datamodel.gif)
95

99
100: ![Screenshot showing Figma to Code](/images/console/ui-figmatocode.png)
101
```

 

https://github.com/aws-amplify/docs/blob/main/src/pages/[platform]/tools/console/storage/file-browser/index.mdx:
```
50
51: ![Amplify Studio file browser](/images/console/fileBrowser.png)
52
```

 

https://github.com/aws-amplify/docs/blob/main/src/pages/[platform]/tools/console/storage/file-storage/index.mdx:
```
49
50: ![Amplify Studio storage start page](/images/console/storageStart.png)
51
```

 

https://github.com/aws-amplify/docs/blob/main/src/pages/[platform]/tools/console/tutorial/bindui/index.mdx:
```
56
57: ![Video of Shuffle Preview](/images/studio/shuffle-preview.gif)
```

 

https://github.com/aws-amplify/docs/blob/main/src/pages/[platform]/tools/console/tutorial/buildui/index.mdx:
```
96
97: ![edit button](/images/studio/buildui/edit-ui-library.png)
98

100
101: ![selection](/images/studio/buildui/multiple-components-selection.png)
102

104
105: ![delete](/images/studio/buildui/delete-components.png)
```

https://github.com/aws-amplify/docs/blob/main/src/pages/[platform]/tools/console/tutorial/code/index.mdx:
```
59
60: ![GIF showing responsive app](/images/studio/responsive.gif)
61
```

 

https://github.com/aws-amplify/docs/blob/main/src/pages/[platform]/tools/console/tutorial/collections/index.mdx:
```
57
58: ![Screenshot of collection stylings applied](/images/studio/collection-layout.png)
59

65
66: ![Screenshot of collection data applied](/images/studio/collection-data.png)
67
```

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.