WordPress.org

Make WordPress Core

Opened 5 years ago

Closed 5 years ago

#9827 closed enhancement (fixed)

Improving the contextual help text for Widgets

Reported by: demetris Owned by:
Milestone: 2.8 Priority: normal
Severity: normal Version: 2.8
Component: UI Keywords: has-patch tested commit
Focuses: Cc:

Description

I started by editing the confusing 2nd paragraph (“Widgets can be removed from their settings...”) but ended up reworking the whole bit.

I also removed the whole explanation of dragging-and-dropping. Why:

I think WP should try to explain what is specific to itself—or, when necessary, to web publishing tools in general— and leave basic computing lessons to where they belong. Thus, WP’s message can be more focused and concise.

Attachments (2)

t9827-widgets-help-context.diff (1.9 KB) - added by demetris 5 years ago.
t9827-widgets-help-context-MOM-TEST-APPROVED.diff (2.1 KB) - added by demetris 5 years ago.
Alt. patch with explanation of drag-and-drop kept

Download all attachments as: .zip

Change History (7)

comment:1 Denis-de-Bernardy5 years ago

  • Keywords needs-patch added; has-patch 2nd-opinion removed

-1 on the current patch. Please leave the basic computing lessons in there. Else, this won't pass a mom test.

demetris5 years ago

Alt. patch with explanation of drag-and-drop kept

comment:2 follow-up: demetris5 years ago

  • Keywords has-patch 2nd-opinion added; needs-patch removed

Added an alternative patch that keeps the explanation of dragging and dropping.

But I don’t think it’s needed: How are you going to use a web publishing tool if you don’t already know how to drag and drop?

I also think that this verbose explaining goes against the general style of WP messages, which are quick and to the point.

comment:3 in reply to: ↑ 2 ; follow-up: Denis-de-Bernardy5 years ago

  • Keywords tested commit added; 2nd-opinion removed

+1 to the patch that is mom-proof.

Replying to demetris:

Added an alternative patch that keeps the explanation of dragging and dropping.

But I don’t think it’s needed: How are you going to use a web publishing tool if you don’t already know how to drag and drop?

You'd be very surprised by the kind of questions a handful of my customers send me. Some barely know how to use a mouse.

I also think that this verbose explaining goes against the general style of WP messages, which are quick and to the point.

That is the reason it's hidden over under Help.

comment:4 in reply to: ↑ 3 demetris5 years ago

Replying to Denis-de-Bernardy:

[SNIP]

I also think that this verbose explaining goes against the general style of WP messages, which are quick and to the point.

That is the reason it's hidden over under Help.

Of course! :-) You are right.

comment:5 ryan5 years ago

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

(In [11353]) Improve contextual help for widgets. Props demetris. fixes #9827

Note: See TracTickets for help on using tickets.