Created attachment 173833 [details] Static example. SUMMARY ------- The severity field isn't documented, so the "critical", "grave", "major", "normal" "minor", and "task" fields' explicit purposes aren't well described. As an example, choosing between "critical", "grave", and "major" isn't intuitive. STEPS TO REPRODUCE ------------------ Visit https://bugs.kde.org/page.cgi?id=fields.html#bug_severity. OBSERVED RESULT --------------- The sole documentation is: > ```HTML > <dt id="bug_severity">Severity</dt> > <dd>How severe the bug is, or whether it's an enhancement.</dd> > ``` EXPECTED RESULT --------------- What each field refers to should be documented. ADDITIONAL INFORMATION ---------------------- - Counterpart exists at [Gentoo](https://bugs.gentoo.org/619108#c0). - https://bugs.kde.org/buglist.cgi?bug_status=UNCONFIRMED&bug_status=CONFIRMED&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&bug_status=NEEDSINFO&bug_status=VERIFIED&bug_status=CLOSED&classification=Websites&f0=OP&f1=OP&f2=product&f3=component&f4=alias&f5=short_desc&f7=content&f8=CP&f9=CP&j1=OR&list_id=2841451&o2=substring&o3=substring&o4=substring&o5=substring&o6=substring&o7=matches&product=bugs.kde.org&query_format=advanced&v2=severity&v3=severity&v4=severity&v5=severity&v6=severity&v7=%22severity%22 returns nothing of relevance.
They are documented here: https://community.kde.org/index.php?title=Guidelines_and_HOWTOs/Bug_triaging#Set_the_Severity_field In general this isn't something bug reporters need to care about. The field is mostly an internal thing for the benefit of developers.
(In reply to Nate Graham from comment #1) Thanks for the link. Perhaps copy that link to https://bugs.kde.org/page.cgi?id=fields.html#bug_severity? It seems strange to have a help link in Bugzilla that directs to the wrong documentation.
Ben, are we able to modify the contents of that page?
Git commit 36924b2742966d911c86c2d68e7516fb1e2999fb by Ben Cooksley. Committed on 25/09/2024 at 09:56. Pushed by bcooksley into branch 'kde-5.0'. Add link to the Bugzilla severity field documentation to the Bugzilla Fields documentation page. M +5 -0 template/en/default/pages/fields.html.tmpl https://invent.kde.org/websites/bugs-kde-org/-/commit/36924b2742966d911c86c2d68e7516fb1e2999fb