Cleanup forum description

Bojhan - July 18, 2009 - 13:49
Project:Drupal
Version:7.x-dev
Component:user interface text
Category:task
Priority:normal
Assigned:yoroy
Status:closed
Issue tags:ui-text, Usability
Description

Removed
To rearrange forums and containers, grab a drag-and-drop handle under the Name column and drag the forum or container to a new location in the list. (Grab a handle by clicking and holding the mouse while hovering over a handle icon.) Remember that your changes will not be saved until you click the Save button at the bottom of the page.

Because we shouldn't describe how an interaction works, instead it should be obvious from the interaction itself. Also the please click save is a bit overdone, with also the inline feedback of save.

AttachmentSizeStatusTest resultOperations
Before-cleanup-forums.png25.77 KBIgnoredNoneNone
After-cleanup-forums.png17.54 KBIgnoredNoneNone
cleanup.forum_.description.patch1.92 KBIdleFailed: Failed to apply patch.View details | Re-test

#1

keith.smith - July 18, 2009 - 13:57
Component:forum.module» user interface text
Status:needs review» reviewed & tested by the community

Yes, this seems fine.

As an aside, all this "grab a handle" business was put in at the last possible second of the Drupal 6 string freeze, because this was, then, a new interaction and we weren't certain that people would immediately grasp it, pun intended. But, it seems to have turned out fairly self-explanatory, so there's no need to have the additional text.

#2

eigentor - July 19, 2009 - 03:34

Not bad, but we could be more noob-compatible, and even much shorter.

How about:

"All forums on your page. You can put forums into containers to group them."

No need to talk about topics and threads here: this should be on the thread list.

#3

Dries - July 19, 2009 - 05:50

@eigenator: do you mean "All forums on you site" (instead of page)?

#4

Dries - July 19, 2009 - 05:57
Status:reviewed & tested by the community» fixed

Committed to CVS HEAD. Thanks!

#5

eigentor - July 19, 2009 - 11:59
Status:fixed» needs review

@Dries yes. All forums on your site. :)

Though the other version is already comitted, I'd like to give it a shot with the as-short-as-possible one.

AttachmentSizeStatusTest resultOperations
forum-description-supershort.patch1.7 KBIdleFailed: Failed to apply patch.View details | Re-test

#6

eigentor - July 19, 2009 - 12:00

Darn, the last one had "page". This one has "site"

AttachmentSizeStatusTest resultOperations
forum-description-supershort.patch1.7 KBIdleFailed: Failed to apply patch.View details | Re-test

#7

eigentor - July 19, 2009 - 12:03

And once more because of double hyphens...

It's a real drag that it is not possible to edit or remove attachments on issues in your own comments.

AttachmentSizeStatusTest resultOperations
forum-description-supershort.patch1.7 KBIdleFailed: Failed to apply patch.View details | Re-test

#8

System Message - July 19, 2009 - 12:15
Status:needs review» needs work

The last submitted patch failed testing.

#9

eigentor - July 19, 2009 - 13:07

O.K. this could not work, because the other patch was applied before. New attempt.

This is the description now:

"All forums on your site. You can put forums into containers to group them."

AttachmentSizeStatusTest resultOperations
forum-supershort.patch1.35 KBIdleFailed: Failed to apply patch.View details | Re-test

#10

eigentor - July 19, 2009 - 15:18
Status:needs work» needs review

#11

Bojhan - July 19, 2009 - 15:55

I think you should be able to catch it into one nicely flowing sentence, its to much a "two" thing sentence now. One does not need to explain what this page holds, merely the main concept it is for.

#12

System Message - July 21, 2009 - 15:50
Status:needs review» needs work

The last submitted patch failed testing.

#13

yoroy - November 4, 2009 - 23:59
Status:needs work» needs review

couple of changes added here, all related to the forum pages admin pages.

changed

This page displays a list of existing forums and containers. Containers (optionally) hold forums, and forums hold forum topics (a forum topic is the initial post to a threaded discussion). To provide structure, both containers and forums may be placed inside other containers and forums.

to:
Use containers to group related forums.

changed

By grouping related or similar forums, containers help organize forums. For example, a container named "Food" may hold two forums named "Fruit" and "Vegetables", respectively.

to:
Containers let you organize forums. For example, a container named "Food" may hold two forums named "Fruit" and "Vegetables".

changed

A forum holds related or similar forum topics (a forum topic is the initial post to a threaded discussion). For example, a forum named "Fruit" may contain forum topics titled "Apples" and "Bananas", respectively.

to:
A forum holds related forum topics. For example, a forum named "Fruit" may contain forum topics titled "Apples" and "Bananas".

changed

These settings allow you to adjust the display of your forum topics. The content types available for use within a forum may be selected by editing the <em>Content types</em> on the forum vocabulary page.

to:
Adjust the display of your forum topics. Select the content types that may be used in a forum by editing the <em>Content types</em> on the forum vocabulary page.

AttachmentSizeStatusTest resultOperations
forum-texts.patch2.63 KBIdlePassed: 14698 passes, 0 fails, 0 exceptionsView details | Re-test

#14

Bojhan - November 5, 2009 - 11:12

Screenshots please?

#16

eigentor - November 7, 2009 - 02:16

images from yoroy's patch:

Container before

after

Forum before

after

Forum before

after

Settings before

after

#17

eigentor - November 7, 2009 - 02:36

Re-rolled it to make it even shorter and by removing unneeded words. Pattern: "For example, a Forum named Fruit" becomes "A forum named Fruit"

Patch and screenshots.

AttachmentSizeStatusTest resultOperations
forum-text-v2.patch2.59 KBIdleFailed: Failed to apply patch.View details | Re-test
Screenshot-014.jpg10.53 KBIgnoredNoneNone
Screenshot-015.jpg10.65 KBIgnoredNoneNone
Screenshot-016.jpg10.51 KBIgnoredNoneNone

#18

eigentor - November 7, 2009 - 02:47

Rerolled, changed "Set content types to use on the Forum vocabulary page"
to "Select content types to use in Forums on the Forum vocabulary page"

Updated the link to that page. And - er - sometimes the controls to choose content types are missing on that page...

AttachmentSizeStatusTest resultOperations
Screenshot-018.jpg32.04 KBIgnoredNoneNone

#19

eigentor - November 7, 2009 - 03:12

uh, and the patch...

AttachmentSizeStatusTest resultOperations
forum-text-v2.patch2.58 KBIdleFailed: Failed to apply patch.View details | Re-test

#20

System Message - November 9, 2009 - 09:45
Status:needs review» needs work

The last submitted patch failed testing.

#21

yoroy - November 16, 2009 - 22:21

Ok here we go:

Forum list before:

forums-before

Forum list after:

forums-list-after
___

Forum settings before:

forum-settings-after

Forum settings after:

forum-settings-after
___

Add container before:

forum-add-container-before

Add container after:

forum-add-container-after
___

Add forum topic before:

forum-add-forum-before

Add forum topic after:

forum-add-topic-after

AttachmentSizeStatusTest resultOperations
forum-descriptions2.patch4.67 KBIdleFailed on MySQL 5.0 ISAM, with: 14,908 pass(es), 2 fail(s), and 0 exception(es).View details | Re-test

#22

yoroy - November 16, 2009 - 22:22
Assigned to:Bojhan» yoroy
Status:needs work» needs review

status etc.

#23

System Message - November 16, 2009 - 23:22
Status:needs review» needs work

The last submitted patch failed testing.

#24

yoroy - November 16, 2009 - 23:37
Assigned to:yoroy» Anonymous

No idea how to fix tests.

#25

System Message - November 17, 2009 - 17:55
Status:needs work» needs review

Bojhan requested that failed test be re-tested.

#26

System Message - November 17, 2009 - 18:31
Status:needs review» needs work

The last submitted patch failed testing.

#27

yoroy - November 18, 2009 - 23:50
Status:needs work» needs review

Or maybe I do.

AttachmentSizeStatusTest resultOperations
forum-descriptions3.patch5.97 KBIdlePassed on all environments.View details | Re-test

#28

yoroy - November 19, 2009 - 00:41
Assigned to:Anonymous» yoroy

woohoo! Now needs review of #21 by humans.

#29

redndahead - November 21, 2009 - 19:10
Status:needs review» reviewed & tested by the community

Looking over the code it looks good. Nice change.

#30

webchick - November 21, 2009 - 19:19
Status:reviewed & tested by the community» needs work

Could we avoid silly, nonsensical examples? There is no one on this earth, even Martha Stewart, who is going to name forum categories Fruit and Vegetables and forums Apples and Bananas.

How about describing more "real world" sample forum containers/forums? You know, like these! http://drupal.org/forum

For example, categories of "General" and "Support", and "General" may contain forums such as "News and Announcements" and "General Discussion".

#31

webchick - November 21, 2009 - 19:20

On the other hand, that Fruit/Vegetables and Apple/Bananas example might be very nice in the help text/help page for Taxonomy.

#32

yoroy - November 21, 2009 - 20:24
Status:needs work» needs review

Ok, removed examples in this patch.

AttachmentSizeStatusTest resultOperations
forumhelptxts-no-examples.patch5.86 KBIdlePassed on all environments.View details | Re-test

#33

webchick - November 21, 2009 - 20:34
Status:needs review» fixed

Great! Even fewer words. :)

Committed to HEAD.

#34

System Message - December 5, 2009 - 20:40
Status:fixed» closed

Automatically closed -- issue fixed for 2 weeks with no activity.

 
 

Drupal is a registered trademark of Dries Buytaert.