aws-amplify / aws-amplify/docs

Alt text is not descriptive [CLI pages]

Open
#7,050 0 comments 2 reactions 1 assignee Claimed by @josefaidt 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/cli/index.mdx:
```
53
54: ![Amplify CLI feature carousel](/assets/cli-b-roll.gif)
55
```

 

https://github.com/aws-amplify/docs/blob/main/src/pages/[platform]/tools/cli/hosting/index.mdx:
```
95
96: ![SPA redirect](/images/hosting/spa-redirect.png)
97
```

 

https://github.com/aws-amplify/docs/blob/main/src/pages/[platform]/tools/cli/migration/aws-cdk-migration/index.mdx:
```
83
84: ![Amplify overrides warning](/images/ts-guide-cdk-package.png)
85 And update amplify/backend/custom//cdk-stack.ts for custom categories as shown below:
86
87: ![Amplify custom warning](/images/ts-guide-cdk.png)
```

 

https://github.com/aws-amplify/docs/blob/main/src/pages/[platform]/tools/cli/plugins/architecture/index.mdx:
```
54
55: ![Image](/images/plugin-platform.png)
56

77
78: ![Image](/images/AmplifyCliConcept.jpg)
79
```

 

https://github.com/aws-amplify/docs/blob/main/src/pages/[platform]/tools/cli/project/troubleshooting/index.mdx:
```
228
229: ![Amplify GraphQL schema validation error](/images/ts-guide-gql-schema-validation-error.png)
230

294
295: ![Amplify GraphQL model deletion warning](/images/ts-guide-model-deletion-warning.png)
296
```

 

https://github.com/aws-amplify/docs/blob/main/src/pages/[platform]/tools/cli/teams/index.mdx:
```
52
53: ![Image](/images/AmplifyEnvSwitching.jpg)
54

56
57: ![Image](/images/AmplifyEnvAddDeploy.jpg)
58

60
61: ![Image](/images/AmplifyEnvAddDeploySwitching.jpg)
62

64
65: ![Image](/images/AmplifyEnvMultDevelopers.jpg)
66
```

 

https://github.com/aws-amplify/docs/blob/main/src/pages/[platform]/tools/cli/teams/multi-frontend/index.mdx:
```
54
55: ![Image](/images/multiple-frontends.png)
56
```

 

https://github.com/aws-amplify/docs/blob/main/src/pages/[platform]/tools/cli/usage/containers/index.mdx:
```
453
454: ![Fully Managed Pipeline](/images/containers/build-workflow.png)
455
```

https://github.com/aws-amplify/docs/blob/main/src/pages/[platform]/tools/cli-legacy/relational-databases/index.mdx:
```
65
66: ![Database Creation](/images/database-creation.png)
67

69
70: ![Engine Option](/images/database-engine-option.png)
71

73
74: ![Database Features](/images/database-features.png)
75

77
78: ![Database Settings](/images/database-setting.png)
79

81
82: ![Database Capacity](/images/database-capacity.png)
83

85
86: ![Database Connectivity](/images/database-connectivity.png)
87

89
90: ![Database Additional Configuration](/images/database-additional-configuration.png)
91

97
98: ![Database details](/images/query-editor.png)
99

118
119: ![Add GraphQL Data Source](/images/add-graphql-datasource.png)
120

148
149: ![GraphQL Results](/images/graphql-results.png)
150

157
158: ![SQL Results](/images/sql-results.png)
159
```

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.