Skip to content

Copy edits!#1237

Merged
maya merged 2 commits into
update-a11y-docsfrom
kategarklavs-patch-1
Jun 6, 2016
Merged

Copy edits!#1237
maya merged 2 commits into
update-a11y-docsfrom
kategarklavs-patch-1

Conversation

@kategarklavs

Copy link
Copy Markdown
Contributor

Description

Include a high-level description for what the pull request fixes and links to Github issues it resolves.

Additional information

  • Relevant research and support documents
  • Type of content review needed: stylistic or copy editing
  • Screen shot images
  • Notes
  • etc.

@maya asked me to take a look and make some copy edits — here they are.

@maya asked me to take a look and make some copy edits — here they are.
Comment thread docs/_components/form-templates.md Outdated
<li>A single legend is always required for fieldset. A common use of fieldset and legend is a question with radio button options for answers. The question text and radio buttons are wrapped in a fieldset, with the question itself being inside the legend tag.</li>
<li>You can embed multiple fieldsets and legends for more complex forms.</li>
<li>Keep your form blocks in a vertical pattern. It's an ideal approach for accessibility, due to limited vision that makes it hard to scan from right to left.</li>
<li>Group each set of thematically related controls in a fieldset element. Use the legend element to offer a label within each one. The fieldset and legend elements make it easier for screen-reader users to navigate the form.</li>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks like screen reader is non-hyphenated: http://www.freedomscientific.com/Products/Blindness/JAWS

@maya

maya commented Jun 6, 2016

Copy link
Copy Markdown
Contributor

LGTM, will bring these changes in to docs/_elements/form-controls.md as well.

@maya maya merged commit ff1a894 into update-a11y-docs Jun 6, 2016
@maya maya deleted the kategarklavs-patch-1 branch June 6, 2016 23:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants