Skip to content
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

Write meaningful text alternatives for images – Example looks like alt text visible #188

Closed
yatil opened this issue Sep 1, 2015 · 7 comments

Comments

@yatil
Copy link
Contributor

yatil commented Sep 1, 2015

In “Write meaningful text alternatives for images” I miss a note that the alternative text is embedded invisible to the document. That the alternative text is visible in the example reinforces that. Maybe add a toggle button [show/hide] alternative text. I see the need for the writer to specify the alt text but I think we shouldn’t mislead here…

@yatil yatil added the Writing label Sep 1, 2015
@iadawn
Copy link

iadawn commented Sep 1, 2015

In this case the activity of writing does not involve creating the actual code. I think I would prefer to include a note to explain what alternative text is a little more, rather than including a toggle button.

@yatil
Copy link
Contributor Author

yatil commented Sep 2, 2015

Would be fine for me. Alternatively the alt text could be styled more like a post it note or (now it’s getting fancy) in a cursive font to show that this is a note that is taken in the writing process.

@iadawn
Copy link

iadawn commented Sep 2, 2015

I think that might fall foul of the style police ;)

iadawn added a commit that referenced this issue Sep 2, 2015
@iadawn
Copy link

iadawn commented Sep 2, 2015

Close on change, please reopen if you think it needs more

@iadawn iadawn closed this as completed Sep 2, 2015
@yatil
Copy link
Contributor Author

yatil commented Sep 3, 2015

Like it! 👍

shawna-slh added a commit that referenced this issue Sep 17, 2015
i'm not set on that wording, just trying to make it quieter and more informal. Maybe make it gray, too?
(i'm also commenting more in #188 -- for later revision.)
@shawna-slh
Copy link
Contributor

I think we should re-do the example/illustration so the alt text does not look like it's part of the content.
One idea would be to make it look like a pop-up tooltip kinda thing. &/or write:
alt="Charging phone"
I'm fine with saving this to next update -- not in Sept -- although before March 2016. :-)

@yatil
Copy link
Contributor Author

yatil commented Sep 18, 2015

It is part of the content that the writer needs to think about, and if they give their text to an implementer, this is important to note for them.

I suggest making the alternative text hint italic so that it looks more like a note.

I strongly, strongly, strongly think that we should not use tech jargon or even code (like alt="") but use natural language, especially in non-developer tips.

@iadawn iadawn modified the milestone: Phase 2 Sep 21, 2015
@yatil yatil closed this as completed Jul 22, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants