WordPress.org

Make WordPress Core

#19523 closed defect (bug) (fixed)

Inaccurate Help text on the Tools screen

Reported by: SergeyBiryukov Owned by: ryan
Priority: normal Milestone: 3.4
Component: Help/About Version:
Severity: normal Keywords: ui-feedback has-patch
Cc: heymrpro@…, xoodrew@…

Description

Help text says:

The Categories and Tags Converter link on this screen will take you to the Import screen, where that Converter is one of the plugins you can install. Once that plugin is installed, return to this screen and the link will take you to a screen where you can choose to convert tags into categories or vice versa.

The highlighted part is inaccurate. The link always leads to the Import screen first, whether the plugin is installed or not:
http://core.trac.wordpress.org/browser/tags/3.3/wp-admin/tools.php#L61

Introduced in [19509] as a rewrite of previous text ([16980]), which wasn't accurate too. Should probably have been "the link on that page" (Import screen) rather than "the link on this page".

Attachments (4)

19523.diff (1.3 KB) - added by DrewAPicture 18 months ago.
First pass
19523.2.diff (742 bytes) - added by ajacommerce 17 months ago.
Cleaned up text and corrected typo
tools.patch (1.6 KB) - added by AJ Acevedo 17 months ago.
19523.3.diff (1.6 KB) - added by SergeyBiryukov 14 months ago.

Download all attachments as: .zip

Change History (13)

comment:1 dougwrites18 months ago

  • Cc heymrpro@… added

comment:2 SergeyBiryukov18 months ago

  • Milestone changed from Awaiting Review to 3.4

DrewAPicture18 months ago

First pass

comment:3 DrewAPicture18 months ago

  • Cc xoodrew@… added
  • Keywords has-patch added

Patch attached is first pass at clarifying the language. Have to say, there's a lot of 'screen' use in there.

The Categories and Tags Converter link on this screen will take you to the Import screen, where that Converter is one of the plugins you can install. Once that plugin is installed, return to this screen and the link will take you to a screen where you can choose to convert tags into categories or vice versa.

becomes

The Categories and Tags Converter link on this screen will take you to the Import screen, where that Converter is one of the plugins you can install. Once that plugin is installed and activated, return to this screen and the link will again take you to the Import screen. From the Import screen, the Converter link will take you to a screen where you can choose to convert tags into categories or vice versa.

comment:4 ajacommerce17 months ago

Also the second instance of the word hierarchy is misspelled in the sentence "Tags do not have hierachy" on line 22.

Original:
Categories have hierarchy, meaning that you can nest sub-categories. Tags do not have hierachy and cannot be nested. Sometimes people start out using one on their posts, then later realize that the other would work better for their content.

The Categories and Tags Converter link on this screen will take you to the Import screen, where that Converter is one of the plugins you can install. Once that plugin is installed, return to this screen and the link will take you to a screen where you can choose to convert tags into categories or vice versa.

Modified:
Categories have hierarchy, meaning that you can nest sub-categories. Tags do not have hierarchy and cannot be nested. Sometimes people start out using one on their posts, then later realize that the other would work better for their content.

The Categories and Tags Converter link below will take you to the Import screen, where the Converter is one of the plugins you can install. Once installed and activated, return to this screen and the link will take you to the Import screen where you can choose to convert tags into categories or vice versa.

Last edited 17 months ago by ajacommerce (previous) (diff)

ajacommerce17 months ago

Cleaned up text and corrected typo

AJ Acevedo17 months ago

comment:5 AJ Acevedo17 months ago

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

comment:6 AJ Acevedo17 months ago

  • Resolution fixed deleted
  • Status changed from closed to reopened

SergeyBiryukov14 months ago

comment:7 SergeyBiryukov14 months ago

Just reviewed the process again. 19523.3.diff is my take.

comment:8 nacin14 months ago

  • Component changed from Administration to Help/About

comment:9 ryan14 months ago

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

In [20727]:

Update contextual help for Tools screen. Props SergeyBiryukov, ajacommerce, DrewAPicture. fixes #19523

Note: See TracTickets for help on using tickets.