This seems backwards. The new issue body field is the information the maintainer needs, no log message commentary required. I'd expect to see a revision log message when updating an issue, but it doesn't actually show on that form at all.

See https://drupal.org/files/issues/revision-log-message-new-issue.png in the attachments.

Comments

tvn’s picture

StatusFileSize
new19.24 KB

On the issue edit form this field is present as a "Comment". It is used for both the revision log message and as a body of the comment, which is being automatically generated when you edit an issue. It used to have label "Revision comment". However while testing D7 D.o with people in Prague, we received feedback that the label is confusing and it got renamed to just "Comment".

rszrama’s picture

That doesn't make sense to me. Are you saying then that if I create a new issue and give it a revision log message, that message should be treated like a comment on the issue? Because it isn't - I added a log message to this issue when I created it (visible here), and it was definitely treated differently from the comment message on the update form.

rszrama’s picture

Also, it sucks that your screenshot is now above mine where I expected it to be easily understood that people should see my screenshot in the issue attachment. Guess I'll edit the issue to link to the specific file in case other attachments come in.

rszrama’s picture

Issue summary: View changes
jthorson’s picture

Re-ordering files to address previous comment. :)

alan d.’s picture

StatusFileSize
new108.79 KB

testing D7 D.o with people in Prague, we received feedback that the label is confusing

When making comments, "Revision comment" would be confusing, but it is surprising when actually making changes not to have a log. So taking a closer look, after editing over 10 issues to date, this was the first time that I saw this bit:

Provide an explanation of the changes you are making. This will be used for an auto-generated comment about your edit, and will help others understand your motivations.

It is completely hidden under the Format help text and the Body itself. Maybe if this was dropped to the bottom of the form so that the help text is not slammed in-between fields?

See drupal.org-issue-field-order.png for a quick mockup.

tvn’s picture

Title: Revision log message field shows on new issue forms but not issue update forms » Hide 'Revision log message' field on node/add/project-issue/x
Issue tags: +Drupal.org 7.1

Re: #2. No, I didn't mean that. I am saying that another field is playing the role of "Revision log message" for issues. So original "Revision log message" field is hidden on issue edit form. We should also hide it on the issue add form, because, as you correctly noted, it makes no sense to show it there.

Re: #6. Might be a good idea. Location of the comment field is being discussed here #2120007: Move comment field below issue summary on issue edit form. This should also help a lot #2104275: Collapse Text format descriptions on node edit form.

sanchiz’s picture

Project: [Archive] Drupal.org D7 upgrade QA » Project issue tracking
Version: » 7.x-2.x-dev
Status: Active » Needs review
StatusFileSize
new504 bytes

Initial patch for module project_issues.

dww’s picture

Title: Hide 'Revision log message' field on node/add/project-issue/x » Hide 'Revision log message' field on node/add/*
Project: Project issue tracking » Drupal.org customizations
Version: 7.x-2.x-dev » 7.x-3.x-dev
Status: Needs review » Needs work
Related issues: +#308820: Don't show the revision checkbox when a node is being created

Thanks for the patch. However, setting to needs work for a few reasons:

A) There could potentially be multiple node types configured to behave as issues. We can't hard-code project_issue in the name of the alter hook implementation. If we did want that, see project_issue_issue_node_types().

B) However, there's no reason to try to restrict this to issue nodes at all. It's pointless having the 'Create new revision' checkbox and 'Revision log message' text area on *any* node/add/* form.

C) It's silly to do this in contrib at all. #308820: Don't show the revision checkbox when a node is being created is the right solution. Sadly, it'll probably be a long time before that's ever committed, backported, and deployed on d.o.

So, for now, let's just do it in drupalorg.module, do it to all node add forms, and leave a @todo comment pointing to #308820.

Thanks!
-Derek

sanchiz’s picture

StatusFileSize
new618 bytes

Moved code to drupalorg.module and hided revision fields on all node add forms.

sanchiz’s picture

Status: Needs work » Needs review
drumm’s picture

Status: Needs review » Needs work

This should go into drupalorg_form_node_form_alter(), which already alters $form['revision_information']

The code comment should reference #308820, so we have a chance of removing it when we upgrade to Drupal 8.

sanchiz’s picture

StatusFileSize
new712 bytes

Fixed. New version.

sanchiz’s picture

Status: Needs work » Needs review
drumm’s picture

Status: Needs review » Fixed

Committed & deploying

sanchiz’s picture

Thanks!:)

Status: Fixed » Closed (fixed)

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

  • Commit 77472f8 on 7.x-3.x, 7.x-3.x-dev authored by sanchiz, committed by drumm:
    [#2127375] Hide 'Revision log message' field on node/add/*