[wp-trac] [WordPress Trac] #50886: docs: Improve help text about site vs. WordPress URL settings

[WordPress Trac]

#50886: docs: Improve help text about site vs. WordPress URL settings
--------------------------+------------------------------------------------
 Reporter:  tobifjellner  |       Owner:  marybaum
     Type:  defect (bug)  |      Status:  assigned
 Priority:  normal        |   Milestone:  6.2
Component:  Help/About    |     Version:
 Severity:  normal        |  Resolution:
 Keywords:  has-patch     |     Focuses:  ui, docs, administration, ui-copy
  needs-testing           |
--------------------------+------------------------------------------------

Comment (by sabernhardt):

 Proposed new text (for single sites):

 > Most themes show the site title at the top of every page, in the title
 bar of the browser, and as the identifying name for syndicated feeds. Many
 themes also show the tagline.
 >
 > Two terms you will want to know are the WordPress URL and the site URL.
 The WordPress URL is where the core WordPress installation files are, and
 the site URL is the address a visitor uses in the browser to go to your
 site.
 >
 > Though the terms refer to two different concepts, in practice, they can
 be the same address or different. For example, you can have the WordPress
 core files in the root directory (`https://example.com`), in which case
 the two URLs would be the same. Or the WordPress files can be in a
 subdirectory (`https://example.com/wordpress`). In that case, the site URL
 and the WordPress URL would be different.
 >
 > Both site URLs and WordPress URLs can start with either `http://` or
 `https://`. A URL starting with `https://` will also show a padlock next
 to the address in the browser address bar. Both of those things signal to
 visitors that your site meets some basic security requirements, which can
 build trust with your users and with search engines.
 >
 > If you want site visitors to be able to register themselves, check the
 membership box. If you want the site administrator to register every new
 user, leave the box unchecked. In both cases, you can set a default user
 role for all new users, whether they register themselves or a site admin
 registers them.
 >
 > You can set the language, and WordPress will automatically download and
 install the translation files (available if your filesystem is writable).

 Notes:

 1. The PR includes `code` tags.
 2. In addition to explaining Site URLs and WordPress URL, this includes
 changing two strings to replace passive voice. One of these strings is
 also in network settings.
 3. I had tried [https://github.com/WordPress/wordpress-
 develop/commit/b64a0eca68fe76561340b7184056efd3ff21951f splitting the
 reminder to save] into its own text string so the old translations would
 remain valid. But then I removed that part from the patch because I'm not
 comfortable editing it in six files for this ticket. It could deserve a
 separate discussion.
 4. [attachment:"50886-comment 24.patch"] proposed "Both of those things
 **signal to visitors that your site is authentic, and the people who run
 it are real.**" However, I prefer the sentence that talks about building
 trust.

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/50886#comment:32>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform