Skip to content

Fix a few broken links - #341

Merged
mit-mit merged 4 commits into
masterfrom
mit-mit-patch-2
Jan 5, 2017
Merged

mit-mit merged 4 commits into
masterfrom
mit-mit-patch-2

Conversation

@mit-mit

@mit-mit mit-mit commented Dec 29, 2016

Copy link
Copy Markdown
Member

As discussed in flutter/flutter#7306 and #340

@googlebot googlebot added the cla: yes Contributor has signed the Contributor License Agreement label Dec 29, 2016
Comment thread debugging.md Outdated
If you're using IntelliJ, you can also debug your application using its
built-in debugger.
If you started your application on an Android device using `flutter run`, then,
while it is running, you can open the Web page at `http://localhost:8181/` to

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.

We should replace this with "...then, while it is running, you can open the Web page at the address given by the flutter run tool to connect..." because the URL changes every time now.

Comment thread getting-started.md Outdated
<div class="box2">
<figure>
<img src="/images/flutter-starter-app-ios.png">
<img src="/images/flutter-starter-app-ios.png" alt="iOS screenshot">

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.

that is not a valid alt value. It is more correct to omit the alt attribute here.

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.

See https://html.spec.whatwg.org/#alt for detailed information on what the alt attribute value should be.

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.

https://html.spec.whatwg.org/#a-key-part-of-the-content in particular has examples of screen shot alt texts

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Yes, those were not great alt strings.

I don't think omitting the attribute would be correct. From the spec you linked, that is only correct when the image contents are not known.

Rather, in this case the image is not a key part of the content, but rather merely a graphical representation of the surrounding text, so they can be left empty per §4.8.4.4.6.

Comment thread getting-started.md Outdated
<div class="box2">
<figure>
<img src="/images/flutter-starter-app-android.png">
<img src="/images/flutter-starter-app-android.png" alt="Android screenshot">

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.

ditto

These images are merely a graphical representation of the surrounding text, so they can be left empty per  §4.8.4.4.6:
https://html.spec.whatwg.org/#a-graphical-representation-of-some-of-the-surrounding-text
@mit-mit

mit-mit commented Dec 30, 2016

Copy link
Copy Markdown
Member Author

Thanks for the feedback, updated

@mit-mit

mit-mit commented Jan 4, 2017

Copy link
Copy Markdown
Member Author

@Hixie any more comments, or can I get a LGTM?

@Hixie

Hixie commented Jan 5, 2017

Copy link
Copy Markdown
Contributor

LGTM.

@mit-mit
mit-mit merged commit a50af70 into master Jan 5, 2017
@mit-mit
mit-mit deleted the mit-mit-patch-2 branch January 5, 2017 13:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla: yes Contributor has signed the Contributor License Agreement

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants