[Bug 258331] PR form includes layout of fields which is confusing, redundant and counter intuitive.

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=258331

            Bug ID: 258331
           Summary: PR form includes layout of fields which is confusing,
                    redundant and counter intuitive.
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Some People
          Priority: ---
         Component: Website
          Assignee: doc@FreeBSD.org
          Reporter: pr.freebsd.only.2021090501@tigerfoot.com

Created attachment 227728
  --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=227728&action=edit
Component and Version Fields.

The PR form includes various fields for describing the bug. This includes two
fields, Component and Version, which are yellow boxes and have an asterisk
which means required. Depending on the type of bug being reported, these two
fields may be pre-filled with one or more possible value (ie for this PR, the
Component field includes Advocacy, Documentation, Manual Pages, Website and
Wiki).

When there is only one possible value for either of these fields, that value of
course is pre-filled. However, this being an empty yellow box with a red
heading, and looks to me, and some, as if it is yet to be filled in, and is
expecting some input.

For instance, when the PR is about a port, the Component field has in the red
heading 'Individual Port(s)' and then a large yellow space underneath. It seams
quite obvious to me, and some, that this should be the place to enter the name
of the port. This is what is intuitive.

In fact, the yellow box is redundant and the correct place to enter the name of
the port is the beginning of the Summary field. This is counter intuitive.

This renders the use of the PR form as confusing.

I did work this out after some little time, but some people who are not
familiar with the form may be put off and not complete a PR which may have been
useful to the community.

I suggest that when there is only one value for either of these fields, that
there is no yellow box underneath and there is no asterisk associated with it.

Thank you.

-- 
You are receiving this mail because:
You are the assignee for the bug.