Problem/Motivation

The explanation texts on the Configuration page invite the user to do something, for example to manage or configure something.
In some cases, extensive reviewing of the hook_help text of a module has come up with explanations of Uses that are more to the point then the existing link descriptions, or that can just be shorter.

Proposed resolution

Change the descriptions in the *links.menu.yml files that they are correct, consistent, and follow a common format.

Remaining tasks

Update the link descriptions for those that are just small tweaks to improve the readability.

User interface changes

This are UI text changes.

API changes

None.

Data model changes

None.

Beta phase evaluation

Reference: https://www.drupal.org/core/beta-changes
Issue category Task to improve some module link descriptions
Issue priority Minor
Disruption None
Support from Acquia helps fund testing for Drupal Acquia logo

Comments

ifrik created an issue. See original summary.

ifrik’s picture

Assigned: ifrik » Unassigned
Issue summary: View changes
Status: Needs work » Needs review
FileSize
1.06 KB

I've shortened the descriptions for the Image and Statistics module where less words work just as well

jhodgdon’s picture

Status: Needs review » Reviewed & tested by the community

ifrik says we should credit: mairi, snehi, rachel_norfolk for this patch as well as herself

These two changes both look fine to me. Thanks!

Status: Reviewed & tested by the community » Needs work

The last submitted patch, 2: 2579001-link-description-configuration-page-minor-2.patch, failed testing.

Status: Needs work » Needs review
snehi’s picture

Status: Needs review » Reviewed & tested by the community

Again RTBC now.

jhodgdon’s picture

Issue tags: +rc deadline

https://groups.drupal.org/node/484788 Apparently this needs to be "rc deadline" because it changes translatable UI text strings

Status: Reviewed & tested by the community » Needs work

The last submitted patch, 2: 2579001-link-description-configuration-page-minor-2.patch, failed testing.

jhodgdon’s picture

Status: Needs work » Reviewed & tested by the community
FileSize
519 bytes

Patch does not apply any more. Another commit apparently changed the Statistics link description to:
Configure the logging of content statistics.
which is pretty much what this patch does, but better. So, here's a patch for just the other hunk.

Bojhan’s picture

Issue tags: -Needs usability review

I am not sure, we are losing the examples here which is what gives context. Now we are just repeating the title a bunch of times.

jhodgdon’s picture

Status: Reviewed & tested by the community » Closed (works as designed)

Well that is a good point. In that case, I think we should just leave this as it was.