aws-amplify / aws-amplify/docs

Alt text is not descriptive [/src/**/start files]

Open
#7,063 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/fragments/start/getting-started/angular/hosting.mdx:
```
43
44: ![image](/images/browser-published-updated.png)
45
```

 

https://github.com/aws-amplify/docs/blob/main/src/fragments/start/getting-started/flutter/integrate.mdx:
```
212
213: ![Budget Tracker home screen](/images/lib/getting-started/flutter/budget-tracker-home.png)
214

290
291: ![Budget Tracker with Authenticator](/images/lib/getting-started/flutter/budget-tracker-authenticator.png)
292

493
494: ![Budget Tracker create screen](/images/lib/getting-started/flutter/budget-tracker-create-screen.png)
495

573
574: ![Completed budget tracker](/images/lib/getting-started/flutter/budget-tracker-complete.png)
```

 

https://github.com/aws-amplify/docs/blob/main/src/fragments/start/getting-started/ios/setup.mdx:
```
53
54: ![Add package dependency](/images/lib/getting-started/ios/set-up-ios-add-package-dependency.png)
55

59
60: ![Add the Amplify package](/images/lib/getting-started/ios/set-up-ios-search-amplify-repo.png)
61

63
64: ![Select dependencies](/images/lib/getting-started/ios/set-up-ios-select-dependencies.png)
65

73
74: ![Edit dependencies](/images/lib/getting-started/ios/set-up-ios-edit_dependencies.png)
75
```

 

https://github.com/aws-amplify/docs/blob/main/src/fragments/start/getting-started/next/hosting.mdx:
```
24
25: ![image](/images/start-nextjs-deploy-1.png)
26

28
29: ![image](/images/start-nextjs-deploy-2.png)
30

34
35: ![image](/images/start-nextjs-deploy-3.png)
36
```

 

https://github.com/aws-amplify/docs/blob/main/src/fragments/start/getting-started/reactnative/generate-model.mdx:
```
12
13: ![Create new schema](/images/lib/getting-started/reactnative/generate-model-admin-ui-create.png)
14

23
24: ![Add isComplete field](/images/lib/getting-started/reactnative/generate-model-admin-ui-isComplete-field.png)
25
```

 

https://github.com/aws-amplify/docs/blob/main/src/fragments/start/getting-started/vanillajs/hosting.mdx:
```
29
30: ![image](/images/browser-vanillajs-hosting.png)
31
```

 

https://github.com/aws-amplify/docs/blob/main/src/pages/[platform]/start/getting-started/hosting/index.mdx:
```
101
102: ![image](/images/browser-vanillajs-hosting.png)
103

107
108: ![image](/images/browser-published-updated.png)
109
```

 

https://github.com/aws-amplify/docs/blob/main/src/pages/[platform]/start/getting-started/hosting/index.mdx:
```
101
102: ![image](/images/browser-vanillajs-hosting.png)
103

107
108: ![image](/images/browser-published-updated.png)
109
```

 

https://github.com/aws-amplify/docs/blob/main/src/fragments/start/getting-started/ios/add-api.mdx:
```
141
142: ![](/images/lib/getting-started/ios/set-up-ios-appsync-query.png)
143

168
169: ![](/images/lib/getting-started/ios/set-up-ios-appsync-create.png)
170
```

 

https://github.com/aws-amplify/docs/blob/main/src/fragments/start/getting-started/ios/setup.mdx:
```
22
23: 2. Select **iOS** tab, choose Application type as **App**, and then click on **Next**. ![](/images/lib/getting-started/ios/set-up-ios-select-project-template.png)
24

31
32: ![](/images/lib/getting-started/ios/set-up-ios-studio-configure-your-project.png)
33
```

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.