Make WordPress Core

Opened 5 years ago

Closed 2 years ago

Last modified 19 months ago

#46057 closed enhancement (fixed)

Remove self-references ("we") in text in core

Reported by: johnbillion's profile johnbillion Owned by: audrasjb's profile audrasjb
Milestone: 6.0 Priority: normal
Severity: minor Version:
Component: Administration Keywords: has-patch commit
Focuses: ui-copy Cc:

Description

There are many text strings in WordPress core that reference the mysterious collective "we". Some examples:

PHP is the programming language we use to build and maintain WordPress.

Note to users of assistive technology: if you experience usability issues with the block editor, we recommend you continue to use the Classic Editor.

This format, which we call WordPress eXtended RSS or WXR, will contain your posts, pages, comments, custom fields, categories, and tags.

To learn more about what data we collect, and how we use it, please visit ...

If they don’t respect the WordPress license, we don’t recommend them.

Sit tight for a few more seconds while we update them as well.

Some could pass as acceptable given the context (such as those on the About page), but most reference an unknown entity, and some cause switches between the grammatical person.

Some just plain don't make sense:

The update cannot be installed because we will be unable to copy some files.

The ssh2 PHP extension is available, however, we require the PHP5 function %s


Text strings that reference "we" should be re-phrased so they no longer need to. For example:

PHP is the programming language that's used to build and maintain WordPress.

Note to users of assistive technology: if you experience usability issues with the block editor, you should continue to use the Classic Editor.

One counter-argument might be that it reduces the personality of WordPress, but I think there are better ways to add personality to software than to reference a collective, unknown entity.

Feedback welcome.

Attachments (2)

46057.diff (2.4 KB) - added by Shital Patel 5 years ago.
text changed
46057.1.diff (8.2 KB) - added by audrasjb 3 years ago.
Administration: Remove self-references ("we") in text in core.

Download all attachments as: .zip

Change History (41)

#1 @SergeyBiryukov
5 years ago

  • Component changed from General to Text Changes

@Shital Patel
5 years ago

text changed

#2 @Shital Patel
5 years ago

  • Focuses docs added
  • Keywords has-patch added

#3 @Shital Patel
5 years ago

  • Version set to 5.0.3

#4 @desrosj
5 years ago

  • Milestone changed from Awaiting Review to Future Release

#5 in reply to: ↑ description ; follow-up: @marybaum
5 years ago

If it's a choice between we and using a passive verb, I'd rather use we. At a minimum, we can often refer to the reader and the writer -- you and me.

I agree that in cases where we are making a policy decision, or the copy needs to make clear that a specific person or team, or contributors in a meeting, we (you and I) should specify who is doing what.

Perhaps writers and copy editors could experiment with using you and I in place of the generic we, especially in support and error contexts. Of course, any time an error message starts referring to itself as I in any form, that starts to sound a little too much like the mission computer in 2001: A Space Odyssey 😜

Replying to johnbillion:

There are many text strings in WordPress core that reference the mysterious collective "we". Some examples:

PHP is the programming language we use to build and maintain WordPress.

Note to users of assistive technology: if you experience usability issues with the block editor, we recommend you continue to use the Classic Editor.

This format, which we call WordPress eXtended RSS or WXR, will contain your posts, pages, comments, custom fields, categories, and tags.

To learn more about what data we collect, and how we use it, please visit ...

If they don’t respect the WordPress license, we don’t recommend them.

Sit tight for a few more seconds while we update them as well.

Some could pass as acceptable given the context (such as those on the About page), but most reference an unknown entity, and some cause switches between the grammatical person.

Some just plain don't make sense:

The update cannot be installed because we will be unable to copy some files.

The ssh2 PHP extension is available, however, we require the PHP5 function %s


Text strings that reference "we" should be re-phrased so they no longer need to. For example:

PHP is the programming language that's used to build and maintain WordPress.

Note to users of assistive technology: if you experience usability issues with the block editor, you should continue to use the Classic Editor.

One counter-argument might be that it reduces the personality of WordPress, but I think there are better ways to add personality to software than to reference a collective, unknown entity.

Feedback welcome.

#6 in reply to: ↑ 5 @SergeyBiryukov
5 years ago

Replying to marybaum:

If it's a choice between we and using a passive verb, I'd rather use we. At a minimum, we can often refer to the reader and the writer -- you and me.
...
Perhaps writers and copy editors could experiment with using you and I in place of the generic we, especially in support and error contexts.

Just wanted to note the post & comment guidelines in make/core handbook have this recommendation that I think applies to any core messages as well:

The make/core blog is the official voice of the core team. As a result, you should keep your personal thoughts out of the body of the post, leaving them for the comments. Furthermore, first person pronouns should be avoided.

Similarly, the word “we” should be avoided in posts, unless its made very clear which group is speaking. An example of this is listing attendees of a meeting and, in the summary post, noting that “we, those present at the meeting” made a decision or agreed on a plan of action.

#7 @garrett-eclipse
4 years ago

  • Component changed from Text Changes to Administration
  • Focuses ui-copy added

#8 @johnbillion
4 years ago

  • Version 5.0.3 deleted

@audrasjb
3 years ago

Administration: Remove self-references ("we") in text in core.

#9 @audrasjb
3 years ago

  • Focuses docs removed
  • Keywords dev-feedback removed
  • Milestone changed from Future Release to 5.9

46057.1.diff refreshes the previous patch and applies the changes to site-health screen.

Moving for 5.9 consideration.

This ticket was mentioned in Slack in #core by audrasjb. View the logs.


3 years ago

#11 @audrasjb
3 years ago

  • Keywords commit added

Reviewed during today's bug scrub.
Marking this as commit candidate.

#12 @peterwilsoncc
3 years ago

I did a regex search in vscode for we[^a-z] and found a few additional strings containing we:

After your Privacy Policy page is set, we suggest that you edit it.

Don&#8217;t you wish all software came with these freedoms? So do we! For more information, check out the <a href="https://www.fsf.org/">Free Software Foundation</a>.

Every plugin and theme in WordPress.org&#8217;s directory is 100%% GPL or a similarly free and compatible license, so you can feel safe finding <a href="%1$s">plugins</a> and <a href="%2$s">themes</a> there. If you get a plugin or theme from another source, make sure to <a href="%3$s">ask them if it&#8217;s GPL</a> first. If they don&#8217;t respect the WordPress license, we don&#8217;t recommend them.

If the root directory of your site was <a href="%1$s">writable</a>, we could do this automatically, but it isn&#8217;t so this is the url rewrite rule you should have in your %2$s file. Create a new file, called %2$s in the root directory of your site. Click in the field and press %3$s to select all. Then insert this code into the %2$s file.

If your %1$s file was <a href="%2$s">writable</a>, we could do this automatically, but it isn&#8217;t so these are the mod_rewrite rules you should have in your %1$s file. Click in the field and press %3$s to select all.

If your %1$s file was <a href="%2$s">writable</a>, we could do this automatically, but it isn&#8217;t so this is the url rewrite rule you should have in your %1$s file. Click in the field and press %3$s to select all. Then insert this rule inside of the %4$s element in %1$s file.

It seems we can&rsquo;t find what you&rsquo;re looking for. Perhaps searching can help.

Need more help? <a href="%s">We got it</a>.

Sorry, we can&#8217;t load the video at the supplied URL. Please check that the URL is for a supported video file (%s) or stream (e.g. YouTube and Vimeo).

This format, which we call WordPress eXtended RSS or WXR, will contain your posts, pages, comments, custom fields, categories, and tags.

This means that we lost contact with the database server at %s. This could mean your host&#8217;s database server is down.

We already have a ping from that URL for this post.

We can&#8217;t find that audio file. Check your <a href="%s">media library</a> and make sure it wasn&#8217;t deleted.

We can&#8217;t find that file. Check your <a href="%s">media library</a> and make sure it wasn&#8217;t deleted.

We can&#8217;t find that image. Check your <a href="%s">media library</a> and make sure it wasn&#8217;t deleted.

We can&#8217;t find that video. Check your <a href="%s">media library</a> and make sure it wasn&#8217;t deleted.

We couldn’t locate %s. Please try another nearby city. For example: Kansas City; Springfield; Portland.

We have suggested the sections you will need. Under each section heading you will find a short summary of what information you should provide, which will help you to get started. Some sections include suggested policy content, others will have to be completed with information from your theme and plugins.

We send your registration email to this address. (Double-check your email address before continuing.)

We were able to connect to the database server (which means your username and password is okay) but not able to select the %s database.

We would also suggest reviewing your Privacy Policy from time to time, especially after installing or updating any themes or plugins. There may be changes or new suggested information for you to consider adding to your policy.

We&#8217;re backing up this post in your browser, just in case.' 
'We&#8217;re going to use this information to create a %s file.

Welcome to WordPress. Before getting started, we need some information on the database. You will need to know the following items before proceeding.

WordPress grows when people like you tell their friends about it, and the thousands of businesses and services that are built on and around WordPress share that fact with their users. We&#8217;re flattered every time someone spreads the good word, just make sure to <a href="%s">check out our trademark guidelines</a> first.

In docs I also found the we in the following files:

  • src/js/_enqueues/vendor/README.md
  • src/readme.html
  • CONTRIBUTING.md
  • SECURITY.md

There's quite a few comments with we in it, so there is a good chance I have missed a few instances.

If we (the people discussion the phrase on this ticket) wish to commit what we have and come back to some of these strings, then that works for me.

#13 @johnjamesjacoby
2 years ago

  • Owner set to johnjamesjacoby
  • Resolution set to fixed
  • Status changed from new to closed

In 51979:

Admin/UI-Copy: reword some "we" usages.

This changes some admin-area, user-facing text, to better match the guidelines and recommendations set forth in the make/core handbook, specifically:

the word “we” should be avoided (...) unless its made very clear which group is speaking

(There are several more usages of "we" that will receive this same scrutiny in future commits/releases.)

Props audrasjb, johnbillion, marybaum, peterwilsoncc, sergeybiryukov, shital-patel.

Fixes #46057.

#14 @johnjamesjacoby
2 years ago

@peterwilsoncc let's remember to get all of those the next time around 🔁

This ticket was mentioned in PR #1802 on WordPress/wordpress-develop by kebbet.


2 years ago
#15

Suggestion of more we-changes, based on regex-search by @peterwilsoncc 

Trac ticket: https://core.trac.wordpress.org/ticket/46057

#16 @hellofromTonya
2 years ago

  • Keywords commit removed
  • Milestone changed from 5.9 to 6.0
  • Resolution fixed deleted
  • Status changed from closed to reopened

Reopening for 6.0 to tackle the remaining "we" instances.

#17 @kebbet
2 years ago

  • Keywords needs-copy-review added

All instances except the listed below is updated in the linked PR (1802).

- Don&#8217;t you wish all software came with these freedoms? So do we! For more information, check out the <a href="https://www.fsf.org/">Free Software Foundation</a>.
- It seems we can&rsquo;t find what you&rsquo;re looking for. Perhaps searching can help.
- WordPress grows when people like you tell their friends about it, and the thousands of businesses and services that are built on and around WordPress share that fact with their users. We&#8217;re flattered every time someone spreads the good word, just make sure to <a href="%s">check out our trademark guidelines</a> first.

kebbet commented on PR #1802:


2 years ago
#18

Sorry for incorrect tagging John!!

kebbet commented on PR #1802:


2 years ago
#19

Sorry for incorrect tagging John!!

#20 @costdev
2 years ago

It looks like the strings mentioned in comment 17 need review to see if they should be changed.

I'm not sure if any of them should change, but here's how they could:

Don&#8217;t you wish all software came with these freedoms? So do we! For more information, check out the <a href="https://www.fsf.org/">Free Software Foundation</a>.

// Remove "So do we!"

Don&#8217;t you wish all software came with these freedoms? For more information, check out the <a href="https://www.fsf.org/">Free Software Foundation</a>.


It seems we can&rsquo;t find what you&rsquo;re looking for. Perhaps searching can help.

// Replace "It seems we can&rsquo;t find what you&rsquo;re looking for." with:

404.php
This page could not be found. Perhaps searching can help.

content-none.php
No posts were found. Perhaps searching can help.


WordPress grows when people like you tell their friends about it, and the thousands of businesses and services that are built on and around WordPress share that fact with their users. We&#8217;re flattered every time someone spreads the good word, just make sure to <a href="%s">check out our trademark guidelines</a> first.

// Replace "We&#8217;re flattered" with "It&#8217;s flattering" and "our trademark guidelines" with "the trademark guidelines.

WordPress grows when people like you tell their friends about it, and the thousands of businesses and services that are built on and around WordPress share that fact with their users. It&#8217;s flattering every time someone spreads the good word, just make sure to <a href="%s">check out the trademark guidelines</a> first.

What are your thoughts @johnjamesjacoby?

#21 @peterwilsoncc
2 years ago

The "so do we" text on the freedoms pages was removed in [52626] so the need to change that can be discarded.

This ticket was mentioned in Slack in #core by chaion07. View the logs.


2 years ago

#23 @chaion07
2 years ago

  • Keywords needs-refresh added; needs-copy-review removed

Thanks @johnbillion for reporting this. We reviewed this ticket during a recent bug-scrub session. Based on the feedback received from the team we are making the following changes to the ticket:

  1. Removing needs-copy-review keyword
  2. Adding keyword needs-refresh
  3. Rephrasing to remove we instances should just be double checked by non-English speakers to make sure they convey the same message
  4. @audrasjb will try to refresh it and hopefully commit this week before Beta 01 is in effect

Props to @davidbaumwald & @audrasjb

Cheers!

#24 @audrasjb
2 years ago

  • Keywords needs-refresh removed
  • Owner changed from johnjamesjacoby to audrasjb
  • Status changed from reopened to reviewing

PR refreshed against trunk.
Should be ok now.
Self assigning for final review and, hopefully, commit.

#25 @peterwilsoncc
2 years ago

  • Keywords needs-copy-review added

Let's get a copy review on all these string changes.

#26 @audrasjb
2 years ago

  • Keywords commit assigned-for-commit added; needs-copy-review removed

Way to go, I had a copy review for all those changes, I updated the PR, and I'm now marking it for commit.

#27 @audrasjb
2 years ago

  • Resolution set to fixed
  • Status changed from reviewing to closed

In 53131:

Administration: Remove self-reference ("we") in WordPress Admin.

This changes updates many strings to remove self-references to an undefined "we" collective across the WordPress Administration.

The goal of this change is to better match the guidelines and recommendations set forth in the make/core handbook, specifically:

the word "we" should be avoided (…) unless its made very clear which group is speaking.

Props johnbillion, shital-patel, audrasjb, marybaum, SergeyBiryukov, peterwilsoncc, johnjamesjacoby, kebbet, costdev, chaion07, davidbaumwald.
Fixes #46057.

#29 @audrasjb
2 years ago

In 53132:

Administration: Replace "can not" with "cannot" after [53131].

Follow-up to [53131], [52979].

See #46057, #38913

#30 follow-up: @SergeyBiryukov
2 years ago

  • Resolution fixed deleted
  • Status changed from closed to reopened

Thanks everyone!

I think some of the new sentences can be improved a bit further:

  • "It is also suggested that you should review your Privacy Policy from time to time" → "You should also review your Privacy Policy from time to time" or "It is also suggested that you review your Privacy Policy from time to time".
  • "Before getting started, some information on the database is needed. You will need to know the following items before proceeding." → "Before getting started, some information on the database is required. You will need to know the following items before proceeding." (Replace "needed" with "required" to avoid tautology.)

#31 @SergeyBiryukov
2 years ago

In 53148:

I18N: Remove wp-config.php file name from translatable strings.

Follow-up to [35547], [35557], [53131].

See #46057.

#32 in reply to: ↑ 30 @costdev
2 years ago

Replying to SergeyBiryukov:

Thanks everyone!

I think some of the new sentences can be improved a bit further:

  • "It is also suggested that you should review your Privacy Policy from time to time" → "You should also review your Privacy Policy from time to time" or "It is also suggested that you review your Privacy Policy from time to time".
  • "Before getting started, some information on the database is needed. You will need to know the following items before proceeding." → "Before getting started, some information on the database is required. You will need to know the following items before proceeding." (Replace "needed" with "required" to avoid tautology.)

For the first sentence, I think the first suggestion works best:

You should also review your Privacy Policy from time to time.

For the second sentence:

  • I wonder why it says "some information on the database is required" and "you will need to know the following.
  • "before getting started"..."before proceeding". Another tautology.

Would this be cleaner?

Before getting started, you will need to know the following items.

This ticket was mentioned in Slack in #core by chaion07. View the logs.


2 years ago

#35 @audrasjb
2 years ago

  • Keywords commit assigned-for-commit removed

The above PR implements those propositions.

#36 @audrasjb
2 years ago

  • Keywords commit added

Thanks for the review @costdev 👍

#37 @audrasjb
2 years ago

  • Resolution set to fixed
  • Status changed from reopened to closed

In 53156:

Administration: Clarify some sentences after [53131].

Props SergeyBiryukov, costdev, audrasjb.
Fixes #46057.

#39 @audrasjb
19 months ago

In 54200:

Text Changes: Remove self-reference ("we") in WordPress Admin.

This changes some admin-area, user-facing text, to better match the guidelines and recommendations set forth in the make/core handbook, specifically:

the word “we” should be avoided (...) unless its made very clear which group is speaking

Follow-up to [51979], [53131], [53132], [53148], [53156].

Props kebbet, costdev, SergeyBiryukov.
Fixes #55758.
See #46057.

Note: See TracTickets for help on using tickets.