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

Editorial: Cite Image Resource #895

Merged
merged 2 commits into from Jun 9, 2020

Conversation

christianliebel
Copy link
Member

@christianliebel christianliebel commented Jun 5, 2020

Closes #854

This change (choose one):

  • Breaks existing normative behavior (please add label "breaking")
  • Adds new normative requirements
  • Adds new normative recommendations or optional items
  • Makes only editorial changes (only changes informative sections, or
    changes normative sections without changing behavior)
  • Is a "chore" (metadata, formatting, fixing warnings, etc).

Commit message:

Cite the Image Resource spec.


Preview | Diff

@christianliebel christianliebel changed the title Cite Image Resource Editorial: Cite Image Resource Jun 5, 2020
Copy link
Collaborator

@aarongustafson aarongustafson left a comment

Choose a reason for hiding this comment

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

Looks good to me, thank you.

@rayankans
Copy link

Looks good to me as well. I'm wondering if ShortcutItem should use ManifestImageResource or just ImageResource. Any thoughts on that @aarongustafson ?

@aarongustafson
Copy link
Collaborator

Looks good to me as well. I'm wondering if ShortcutItem should use ManifestImageResource or just ImageResource. Any thoughts on that @aarongustafson ?

Could we see purpose being used in the shortcut context?

@kenchris
Copy link
Collaborator

kenchris commented Jun 8, 2020

The new monochrome purpose could be preferred by some Android launchers I think

@NotWoods
Copy link
Member

NotWoods commented Jun 8, 2020

The maskable purpose could also be preferred for full-bleed shortcut images, such as those for contacts:
https://developer.android.com/guide/topics/ui/shortcuts

index.html Outdated
@@ -1139,11 +1139,11 @@ <h3>
<var>manifest</var>["<a>categories</a>"].
</li>
<li>Set <var>manifest</var>["<a>icons</a>"] to the result of running
<a>processing ImageResource members</a> given
<a>processing ManifestImageResource members</a> given
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
<a>processing ManifestImageResource members</a> given
<a>processing `ManifestImageResource` members</a> given

index.html Outdated
<var>manifest</var>["<a>icons</a>"] and <var>manifest URL</var>.
</li>
<li>Set <var>manifest</var>["<a>screenshots</a>"] to the result of
running <a>processing ImageResource members</a> given
running <a>processing ManifestImageResource members</a> given
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
running <a>processing ManifestImageResource members</a> given
running <a>processing `ManifestImageResource` members</a> given

index.html Outdated
or to integrate the web application with an <abbr title=
"operating system">OS</abbr>'s task switcher and/or system
preferences.
<a>ManifestImageResource</a>s that can serve as iconic
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
<a>ManifestImageResource</a>s that can serve as iconic
{{ManifestImageResource}}s that can serve as iconic

index.html Outdated
@@ -1528,7 +1528,7 @@ <h3>
examination, to in fact be inappropriate (e.g. because its content
type is unsupported), then the user agent MUST try the
next-most-appropriate icon as determined by examining the
<a>ImageResource</a>'s members.
<a>ManifestImageResource</a>'s members.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
<a>ManifestImageResource</a>'s members.
{{ManifestImageResource}}'s members.

index.html Outdated
@@ -1891,8 +1891,8 @@ <h3>
</h3>
<p>
The <dfn>screenshots</dfn> member is an <a>array</a> of
<a>ImageResource</a>s, representing the web application in common
usage scenarios.
<a>ManifestImageResource</a>s, representing the web application in
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
<a>ManifestImageResource</a>s, representing the web application in
{{ManifestImageResource}}s, representing the web application in

index.html Outdated
agent can use these values to select an image that is best suited to
display on the end-user's device or most closely matches the end-user's
preferences.
Each <a>ManifestImageResource</a> represents an image that is used as
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Each <a>ManifestImageResource</a> represents an image that is used as
Each {{ManifestImageResource}} represents an image that is used as

index.html Outdated
Comment on lines 2420 to 2422
<li>Let |image| be the result of running [=process an image
resource from JSON|processing an image resource from JSON=] given
|entry| and |manifest URL|.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
<li>Let |image| be the result of running [=process an image
resource from JSON|processing an image resource from JSON=] given
|entry| and |manifest URL|.
<li>Let |image| be the result of running [=process an image resource from JSON=] given
|entry| and |manifest URL|.

Copy link
Member

@marcoscaceres marcoscaceres left a comment

Choose a reason for hiding this comment

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

Ok, let's run with this...

However, I think we should remove platform if we can. Let's discuss that elsewhere.

@marcoscaceres marcoscaceres merged commit b7bb380 into w3c:gh-pages Jun 9, 2020
@christianliebel christianliebel deleted the image-resource branch June 9, 2020 05:59
marcoscaceres pushed a commit that referenced this pull request Jun 10, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Use the newly defined ImageResource
6 participants