Issue 123049 - Adding attachments (sample documents) hard to find or to understand
Summary: Adding attachments (sample documents) hard to find or to understand
Alias: None
Product: Infrastructure
Classification: Infrastructure
Component: Bugzilla (show other issues)
Version: current
Hardware: All All
: P3 Minor (vote)
Target Milestone: ---
Assignee: AOO issues mailing list
QA Contact:
Depends on:
Reported: 2013-08-16 12:10 UTC by Edwin Sharp
Modified: 2013-08-18 14:01 UTC (History)
4 users (show)

See Also:
Latest Confirmation in: ---
Developer Difficulty: ---

suggestion for add file (164.27 KB, image/jpeg)
2013-08-18 08:46 UTC, Edwin Sharp
no flags Details
Mockup for more simple improvement (46.38 KB, application/
2013-08-18 09:43 UTC, Rainer Bielefeld
no flags Details

Note You need to log in before you can comment on or make changes to this issue.
Description Edwin Sharp 2013-08-16 12:10:54 UTC
A lot of bug reporters complain they couldn't find the way to attach files to their bug report.
Lack of attachment can be crucial to analyzing the bug.

Adding files should be very easy to find.
Comment 1 Rainer Bielefeld 2013-08-17 05:17:23 UTC
I think the problem is not that the attachment function can't be found, but that reporters underrate importance of sample documents.

@Edwin Sharp
Suggestions? Mockups?
Comment 2 Edwin Sharp 2013-08-17 19:47:25 UTC
See for example bug 109011.
Couldn't find more complaints although I'm sure I encountered more.
Will try to prepare a mockup.
Comment 3 Rainer Bielefeld 2013-08-18 07:05:22 UTC
(In reply to Edwin Sharp from comment #2)
> See for example bug 109011.
Yes, I see such comments from time to time, but that's a user-problem. To mee it seems impossible not to see the "Add an Attachment" button on the way to the "Submit" button.
When we think we have Bugzilla idiot proof they will send better idiots ;-)
(I like that saying, but I do not want to  affront anybody)

> Will try to prepare a mockup.
Fine. May be some little more prominent hint how valuable attached sample documents are might only help some users to find this item.
Comment 4 Edwin Sharp 2013-08-18 08:46:54 UTC
Created attachment 81349 [details]
suggestion for add file

Not a big change but maybe a little bit easier for reporter to understand...
Comment 5 Rainer Bielefeld 2013-08-18 09:39:25 UTC
I do not think that such a big modification in BZ will be necessary. But seeing Edwin's Mockup I had an idea what might be the problem for inexperienced bug reporters: 

May be they want to contribute a "sample document" or a "screenshot", but they only find a button to "Add an Attachment". For us it seems crystal clear that that button is for attaching sample documents or similar, but may be not everybody can understand that? Especially because there is no Help link?

So as a first step I suggest simply to trail a short hint behind the button, see following Mockup.

Severity "MINOR Enhancement", I don't think that many users suffer from this problem. But nevertheless a useful suggestion.

What do you think?
Comment 6 Rainer Bielefeld 2013-08-18 09:43:56 UTC
Created attachment 81350 [details]
Mockup for more simple improvement

Please see comment above.

And may be a similar hint would be useful behind table heading "Attachments" in the attachments table of existing Bug reports? May be some newbies have difficulties to understand for what these files are?
Comment 7 Regina Henschel 2013-08-18 11:48:09 UTC
Most other field labels show a tooltip, when hovered with the mouse, and they link to But the label "Attachment" has is not. So one improvement can be to add these to label "Attachment" to.

Another improvement can be to change the button text from "Add an attachment" to "Upload attachment".
Comment 8 Rob Weir 2013-08-18 14:01:58 UTC
Something to keep in mind:  We're not going to rewrite Bugzilla.  And we're very unlikely to apply and maintain custom patches to the Bugzilla UI.

That leaves four basic approaches:

1) If something is already accessible to BZ admins, we can adjust settings.

2) If we need to improve documentation on pages that link to BZ, so users know better what we're looking for, we can do that.

For example, maybe this page should be better known (though it is lengthy):

3) We can "wrap" the submission process with another webpage that simplifies the experience for users.  For example, this out-of-date page:

4) Send UI suggestions to