The "Post a new comment" form causes a lot of mental distraction, when you are working on an issue. Especially for experienced users who use Dr.editor - a lot of the functionality and help text in this form is poorly communicated.

Comments

Bojhan’s picture

StatusFileSize
new29.24 KB

cleanuppostnewcomment.png

Cleaning up this form, is mostly about removing all help text, unnecairy labels. As you can see I also removed fieldsets - this obviously to adhere to #drupal7 standards to not put a fieldset around a main interaction of the screen (also does anyone collapse this?).

With that in mind I also moved up the tags (as suggested by tha_sun) , because obviously this is functionality you touch quite often. For it to be collapsed and in the bottom (even though its important meta date) makes no sense.

Last, I moved the create commit message to the bottom (preferbly this should also be aligned to the right) - because this is functionality I never use. And because of its blueness, it really stands out - with that causing distraction.

sun’s picture

Status: Active » Needs review
StatusFileSize
new2.56 KB

The "create commit message" button, we need to tackle separately.

But here's a patch to add some licky awesomeness.

Bojhan’s picture

Status: Needs review » Reviewed & tested by the community

Since I cant review this code - I say its RTBC :)

sun’s picture

StatusFileSize
new16.3 KB

This is what I see:

issue-comment-form-5.png

Bojhan’s picture

Interesting, I actually think that makes less sense then I imagined. The group of form elements, is now very crowded together - causing it to be less scan able. If we want to make this more usefull, we should add spacing, rearrange a bit.

What if the order could be :

Status, Priority, Category [ some spacing ] Project, version, component, Assigned
Tags

Where the length of tags is Status, Priority and Category instead of the whole width. Also you didn't remove the useless descriptions.

sun’s picture

The additional stacking of the (normally two) basic issue data rows, I added at the end... the idea was to decrease the visual height until you see the actual comment area.

Yes, it's quite unusual (and still feels alienate here), so perhaps revert it back to two rows.

sun’s picture

StatusFileSize
new14.43 KB

ok, back to two rows. Also removed the labels, as you suggested.

sun’s picture

Status: Reviewed & tested by the community » Needs review

I really like this version. However, two issues:

1) Major: At least in Firefox, this form alteration "disables" Firefox's automated form values reset to last known values upon refreshing the page.

I've to study why and under which circumstances this happens. It's possible that the user script runs too early, so Firefox no longer identifies the form to be the same form as before the page refresh...

2) When attaching a file, the form-level submit buttons jump next to the file upload progress bar. I guess the attachments need an additional wrapping DIV container to prevent this.

Bojhan’s picture

Also you probally want to add some spacing between the two.

My suggestion was actually most around the description text.

The suggestion for tags are fairly useless, for the expert user that uses Dr.Editor
And, descriptions of priority neither have to be explained, you might disagree with them :P from time to time, but there definitions are fairly clear for most cases

sun’s picture

Status: Needs review » Fixed

Thanks for reporting, reviewing, and testing! Committed http://drupal.org/cvs?commit=360112

A new development snapshot will be available within the next 12 hours. This improvement will be available in the next official release.

joachim’s picture

Isn't this something that should be fixed on d.org itself?

I really don't like how the new version of dreditor removes those labels.

sun’s picture

Could you elaborate a bit more on the issues you have with the streamlined comment form? (an annotated screenshot may help)

Aside from that, it's unfortunate that we can't move the issue tags above the comment area via JS. That was one of the optimizations I really liked most. I'm still thinking about very advanced CSS tricks though.

sun’s picture

Now that I thought once more about it... it's totally doable :) Committed http://drupal.org/cvs?commit=360476

smk-ka’s picture

StatusFileSize
new37.88 KB

No annotations, just the result...

smk-ka’s picture

Status: Fixed » Needs work
smk-ka’s picture

Status: Needs work » Fixed

Oops, according to #8 this is actually the desired result. Well, then...

sun’s picture

humm.... so any belated annotations maybe? :)

webchick’s picture

Category: task » bug
Priority: Normal » Critical
Status: Fixed » Needs work

This seems to have totally broken the "Create commit message" button. :(

Only local images are allowed.

webchick’s picture

Having used this feature for a few days now, I really wish it was rolled back, or at least there was a way to toggle it off... :\

1. There seems to be a (IMO incorrect) assumption here that only "power users" use Dreditor. But one of the first things I do with new contributors who want to do patch reviews is have them download Dreditor to use the totally awesome patch review tool. And now, they have to expend all kinds of mental energy to figure out what each field is asking about, since they don't have intimate familiarity with this form that most of us do. -1000 for making the issue queue less approachable for newbies, or forcing them to use sub-standard tools so they don't get confused.

2. This totally breaks consistency with every single other form in all of Drupal core and contrib, and the entire Internet as a whole for that matter. Input fields should have labels. They do on Twitter, they do on Facebook, they do on every single other site I can imagine that has a much higher rate of usage than the Drupal.org issue queue. The only form I've ever seen in my life that did not have labels, the contents of the box defaulted to description text that explained to someone new what they were supposed to enter there. These don't. There's not even a little (?) to click on if you get totally stuck.

3. It makes me really nervous relying on a tool, and recommending it to others, that has this kind of stuff just randomly getting shoved into it with basically zero outside review. It calls for either a "modular" system that users can toggle on/off these kinds of "user enhancement" things, or else keeping Dreditor *just* the patch review / commit message tools, and having some "Dreditor Extras" for experimental weird stuff that has nothing to do with the day-to-day reasons we use this tool.

dave reid’s picture

Wow, I really do not like the missing labels on the form elements. :/

Bojhan’s picture

@webchick Honestly, if you advise Dr.Editor to newbies you are extending its scope to a very different target audience. I know that's how we do it in core, making it accessible for all but in terms of power use that's not always the best road.

1. Not knowing the labels sure, but I highly doubt it will cause much mental distress. After all you don't install Dr.Editor from the the get to go? Reviewing is not the first thing you do in the issue queue?

2. I would strongly disagree with that notion, its becoming much more of a trend in form design. Polluting it with ? marks, would only defeat the purpose of eliminating text that one already knows anyway. The idea behind this change is to eliminate text one knows anyway, to reduce the amount of reading needed to be done = efficiency increase.

3. Sorry but this is contrib, we should be allowed to experiment and try out ideas even for a larger use base. Creating an extra option, or addon to handle multiple opinions on just this topic would be rather silly. The whole problem of Drupal and design is that we don't experiment = don't improve significantly.

Anyway, I am somewhat shocked by the backslash on this topic. I could agree it takes some time to get used too, and one could have an opinion like @Dave Reid that he doesn't like it. But from an argumentation perspective, it really should improve the efficiency for power uses, no not for beginning users.

So I do truly stand by my point that from a pure efficiency and for that matter human factors point of view it makes a lot of sense. But that it does take quite some time to get used too (remember we are changing an interface you use multiple times per day, it will be annoying no matter how good the change is), I guess I am just too much of a minimalist when it comes to power use. I am fine if it gets rolled back, just a bit sad it can't be an open-minded experiment - even to unusual UI changes.

joachim’s picture

> The idea behind this change is to eliminate text one knows anyway, to reduce the amount of reading needed to be done = efficiency increase.

I disagree with that. I don't feel compelled to read all the text I see. I know what all the form elements are, and I skip the labels. But nonetheless their presence adds something. It's hard to explain but it's perhaps something like a white line on the edge of a road: it does nothing for safety whatsoever but somehow gives you a mental guide.

> Sorry but this is contrib,

It is. One module, one purpose. It could be argued that Dreditor is a patch reviewing tool, and adding form tweaks is out of its scope.

Bojhan’s picture

@joachim You might not read it, but its there its taking up space and sadly that does put cognitive pressure. It is not a mental guide like the white line on the edge of the road. That one has pure informational value, this one is purely informational at first.

Its indeed a patch review tool, so maybe not - perhaps just keep it to our own personal styles.

joachim’s picture

> You might not read it, but its there its taking up space and sadly that does put cognitive pressure.

I'm really not an expert on this, but perhaps different people have different cognitive pressures? It sounds like for me and some others, the pressure of not being entirely certain what an item is is slightly greater than having the labels there.

dave reid’s picture

I like how the changelog for this commit was 'Fixed UX of issue comment form.'. Um? That's how we fix UX?

Honestly stuff like this is better fit for a 'power user drupal.org style' like http://userstyles.org/styles/11133 and not dreditor. But that's just my opinion. For everyone else, http://drupalcode.org/viewvc/drupal/contributions/modules/dreditor/dredi... is the link to the code from before this fix was included. Using Greasemonkey you can easily copy that, and then edit the code for your current dreditor and paste that in. If you comment out the last line of the script it will stop warning you about an out-of-date dreditor as well.

I understand we want to innovate. But I think we kinda need to draw a line between functionality that actually makes reviewing and committing patches easier and friendlier, vs 'power user' stuff.

Bojhan’s picture

@joachim Ohh definitly, confusion is of course greater. Then again, I am a little confused you wouldn't know what some form items are. Anyways clear you guys don't like it, all it needs is a patch I guess.

sun’s picture

Status: Needs work » Postponed (maintainer needs more info)

Can we revisit this issue? I actually love the cleaned up issue comment form, but I'm open to do compromises.

Bojhan’s picture

@sun Maybe you can do a toggle? Since this is total hacking anyway :) I can come up with an icon :P

sun’s picture

If it is only about the hidden labels, then we could change that. That said, the labels are still needless cruft once you know them, so one potential solution would be to move the labels into HTML 'title' attributes, so they show up when hovering over an input element with the mouse. Wouldn't that be a working solution making everyone happy?

Alternatively, we could implement a counter and hide the labels after you've seen them 100 times or so. Yes, there are lots of possibilities. :)

sun’s picture

Status: Postponed (maintainer needs more info) » Needs review
StatusFileSize
new1.26 KB

Attached patch implements the title attribute idea. Of course, there's no visual difference compared to the current appearance, and I'm not able to take a screenshot of a browser tooltip, so I'm afraid you have to apply this patch to test it.

sun’s picture

Status: Needs review » Postponed (maintainer needs more info)
StatusFileSize
new2.38 KB

Since there are no visual changes, I went ahead and committed attached patch.

Any feedback is welcome.

joachim’s picture

> so one potential solution would be to move the labels into HTML 'title' attributes, so they show up when hovering over an input element with the mouse

That means if I don't know what things are, I have to spend 5 minutes promenading my mouse round everything and waiting to tooltips to appear on each one. Not very usable.

Bojhan’s picture

Yhea, I would still recommend a toggle - its the most non-intrusive way, without requiring some magic in either after 100 shows or upon hover.

webchick’s picture

I still question the entire idea of hiding labels on form fields as a "usability" "feature." Can you cite anywhere at all where this is done elsewhere?

Also generally dismayed that 2 people being +1 to a fundamentally UI changing issue is enough to push it into the tool for everyone. :\

Bojhan’s picture

@webchick I totally understand your point, but I think you are misunderstanding our argument. We are not arguing to make it less usable for beginners, not at all. We are merely exploring options for optimizing it for the expert, asking for evidence of this is silly as there are almost no sites and fewer publicly available applications that optimize for the expert (non publicly available, there are many, as expertly as not even exposing labels at all).

I am confused why you would be against something like a toggle, the default would still be showing labels but for those who like it there would be an option. After all contrib is where we can optimize for certain use cases, I know core and drupal.org for this matter should accommodate the intermediate/beginning user.

There is no wrong in creating interface elements for experts - as long as we are all clear that is what it is.

sun’s picture

Any ideas for how a toggle could look like? I.e., where could we put that? Perhaps something like the "Create commit message" link/button? A cog in the upper right like contextual links? hrhr...

Bojhan’s picture

@sun I think a icon that would convey, hide labels :'D

Bojhan’s picture

StatusFileSize
new774 bytes

There you go, anyway - the contextual link would be fine too, just feel we should not make core vs drupal.org confusing.

We spoke on chat, ideally the cog opens a dialog showing the options available. For example, commit message is a option that is used only by maintainers or core commiters.

dave reid’s picture

I don't think people are against a toggle for this, they're just against the fact that this went in *without* a toggle when it has such an impact on a large portion of the user base (the non-experts). I still think this belongs in a user style sheet rather than dreditor since this is only about presentation and not adding features to make life easier. :/ Willing to help review the toggle patch.

Bojhan’s picture

Ahh, I didn't know that - thought I had an patch applied. I am talking with tha_sun about revamping some stuff.

webchick’s picture

I am an expert and still think it's totally bizarre to not have labels on form fields. It's completely non-standard to any form I've ever seen anywhere.

User style++ This would move presentation logic to where it belongs: in the presentation, rather than in the functionality. What Dreditor currently does is akin to hard-coding a call to theme_foo_bar() instead of theme('foo_bar'), and changing the default output of theme_foo_bar() to being totally non-sensical to a huge chunk of its audience.

sun’s picture

Status: Postponed (maintainer needs more info) » Fixed

Sorry for the delay. I've just reverted the hiding of the labels in the issue comment form.

Status: Fixed » Closed (fixed)

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

silverwing’s picture

locking comments on this issue due to, well, you know...