New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Fixes DOC-2073 #443
Fixes DOC-2073 #443
Conversation
👍 |
The purpose of this guide is to provide a reference for documentation standards | ||
used in edX technical publications. Its intended audience is members of the | ||
edX documentation team, other edX employees, and translation teams and open | ||
source contributors around the world. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
+++
Great, thank you. One question. 👍 |
.. note:: With regard to blindness, I feel it is important to drive home | ||
the fact that if you do not vocalize unspoken visual events that are important | ||
to understanding the video, you will trigger a requirement to provide Audio | ||
Descriptions, which is both expensive and time consuming. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is there a reason "Audio Descriptions" is capitalized?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
no reason at all. should probably be lower-cased. We may consider linking to definition though: http://www.w3.org/TR/WCAG20/#audiodescdef
A few nits - otherwise 👍 |
@cptvitamin are you ok with the edits that @srpearce and @mhoeber suggest? or should I take out the line crediting you for this work? |
These comments are good. I definitely think first person should be removed. |
@mhoeber @catong @srpearce this is my decathlon project for the week. See https://openedx.atlassian.net/browse/DOC-2073. @cptvitamin I have very lightly edited your google doc to include it in our style guide, most notably by adding some additional subheaders.
c660102
to
25d9d65
Compare
@mhoeber @catong @srpearce this is my docathon project for the week.
See https://openedx.atlassian.net/browse/DOC-2073.
@cptvitamin I have very lightly edited your google doc to include it in
our style guide, most notably by adding some additional subheaders.