Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 07 Sep 2021 02:29:11 +0000
From:      bugzilla-noreply@freebsd.org
To:        doc@FreeBSD.org
Subject:   [Bug 258331] PR form includes layout of fields which is confusing, redundant and counter intuitive.
Message-ID:  <bug-258331-9@https.bugs.freebsd.org/bugzilla/>

next in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D258331

            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=3D227728&action=
=3Dedit
Component and Version Fields.

The PR form includes various fields for describing the bug. This includes t=
wo
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, t=
he
Component field includes Advocacy, Documentation, Manual Pages, Website and
Wiki).

When there is only one possible value for either of these fields, that valu=
e 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 r=
ed
heading 'Individual Port(s)' and then a large yellow space underneath. It s=
eams
quite obvious to me, and some, that this should be the place to enter the n=
ame
of the port. This is what is intuitive.

In fact, the yellow box is redundant and the correct place to enter the nam=
e 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.

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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-258331-9>