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

Improve placeholder text phrasing for media blocks #16135

Merged
merged 1 commit into from
Jun 12, 2019

Conversation

kjellr
Copy link
Contributor

@kjellr kjellr commented Jun 12, 2019

Closes #8409

This PR edits the placeholder text for the following blocks, cleaning up the sentence structure and phrasing.

  • Image
  • Cover
  • Audio
  • Video
  • File
  • Media & Text

It uses the recommendations in the original ticket, but with some minor adjustments (from a DM with @michelleweber):

For when there's a URL option:

Upload a [type] file, pick one from your media library, or add one with a URL.

For when there's no URL option:

Upload a [type] file or pick one from your media library.


Before:

gutenberg test_wp-admin_post php_post=1 action=edit (1)

After:

gutenberg test_wp-admin_post php_post=1 action=edit

@kjellr kjellr added [Feature] Blocks Overall functionality of blocks Needs Copy Review Needs review of user-facing copy (language, phrasing) [Block] Cover Affects the Cover Block - used to display content laid over a background image [Block] Image Affects the Image Block [Block] Video Affects the Video Block [Block] File Affects the File Block [Block] Media & Text Affects the Media & Text Block [Block] Audio Affects the Audio Block labels Jun 12, 2019
@kjellr kjellr requested a review from sarahmonster June 12, 2019 22:46
@kjellr kjellr self-assigned this Jun 12, 2019
@@ -175,14 +175,14 @@ export class MediaPlaceholder extends Component {
const isVideo = isOneType && 'video' === allowedTypes[ 0 ];

if ( instructions === undefined && mediaUpload ) {
instructions = __( 'Drag a media file, upload a new one or select a file from your library.' );
instructions = __( 'Upload a media file or pick one from your media library.' );
Copy link
Contributor Author

Choose a reason for hiding this comment

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

This one doesn't contain the "or add one with a URL" part, because the media & text block doesn't include that option.

@jwold
Copy link

jwold commented Jun 12, 2019

This is a good improvement and feels more consistent, great work! I was debating on whether an oxford comma or rewording could be used on Cover, but ultimately feels like the direction you took makes the most sense.

@kjellr kjellr changed the title Bring greater consistency to placeholder text for media blocks Improve placeholder text phrasing for media blocks Jun 12, 2019
Copy link
Member

@sarahmonster sarahmonster left a comment

Choose a reason for hiding this comment

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

This looks to be a good improvement. Ship it!

It might be worth considering if we need this text at all. Does it add any additional context or help users understand how to add media? It seems to just be wordily replicating messaging that already exists on the buttons, without adding any additional context.

@kjellr
Copy link
Contributor Author

kjellr commented Jun 12, 2019

Thanks folks.

It might be worth considering if we need this text at all. Does it add any additional context or help users understand how to add media? It seems to just be wordily replicating messaging that already exists on the buttons, without adding any additional context.

I agree. 😄 This is a good small, iterative improvement on what we have, and I think we can keep going in further PRs.

@kjellr kjellr merged commit 84543ff into master Jun 12, 2019
@kjellr kjellr deleted the update/media-placeholder-instructions branch June 12, 2019 23:41
@kjellr kjellr removed the Needs Copy Review Needs review of user-facing copy (language, phrasing) label Jun 12, 2019
@gziolo gziolo added this to the Gutenberg 6.0 milestone Jun 13, 2019
daniloercoli added a commit that referenced this pull request Jun 14, 2019
…rnmobile/open-video-by-browser-for-android

* 'master' of https://github.com/WordPress/gutenberg: (34 commits)
  [RNMobile] Native mobile release v1.7.0 (#16156)
  Scripts: Document and simplify changing file entry and output of build scripts (#15982)
  Block library: Refactor Heading block to use class names for text align (#16035)
  Make calendar block resilient against editor module not being present (#16161)
  Bump plugin version to 5.9.1
  Editor: Fix the issue where statics for deprecated components were not hoisted (#16152)
  Build Tooling: Use "full" `npm install` for Build Artifacts Travis task (#16166)
  Scripts: Fix naming conventions for function containing CLI keyword (#16091)
  Add native support for Inserter (Ported from gutenberg-mobile) (#16114)
  docs(components/higher-order/with-spoken-messages): fix issue in example code (#16144)
  docs(components/with-focus-return): fix typo in README.md (#16143)
  docs(block-editor/components/inspector-controls): fix image path in README.md (#16145)
  Add mention of on Figma to CONTRIBUTING.md (#16140)
  Bring greater consistency to placeholder text for media blocks. (#16135)
  Add descriptive text and a link to embed documentation in embed blocks (#16101)
  Update toolbar-text.png (#16102)
  Updating changelogs for the Gutenberg 5.9 packages release
  chore(release): publish
  [RNMobile] Fix pasting text on Post Title (#16116)
  Bump plugin version to 5.9.0
  ...

# Conflicts:
#	packages/block-library/src/video/video-player.android.js
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
[Block] Audio Affects the Audio Block [Block] Cover Affects the Cover Block - used to display content laid over a background image [Block] File Affects the File Block [Block] Image Affects the Image Block [Block] Media & Text Affects the Media & Text Block [Block] Video Affects the Video Block [Feature] Blocks Overall functionality of blocks
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Improve consistency of empty states for media blocks
4 participants