Bug#779407: tracker.debian.org: suboptimal wording with patch/help action short descriptions

Raphael Hertzog <[email protected]> Thu, 30 Oct 2025 16:32:35 +0100
Newsgroups gmane.linux.debian.devel.quality-assurance
Message-ID <aQOFE6uabQa0XQoE__21122.0199520298$1761838531$gmane$org@fr13-buxy.home.ouaza.com>
For anyone looking at fixing this, you should look into:
* distro_tracker/vendor/debian/tracker_tasks.py
* distro_tracker/vendor/debian/templates/debian/help-bugs-action-item.html
* distro_tracker/vendor/debian/templates/debian/patch-bugs-action-item.html

On Sat, 28 Feb 2015, Paul Wise wrote:
> Assumes people know what a BTS is, "bug tracker" might be more familiar
> to more people not familiar with Debian terminology.

BTS is an <abbr> tag which expands to "Bug Tracking System" so it's not so
bad really. But yes, we could replace it with "bug tracker".

> Assumes people know what the help/patch tags of the Debian BTS mean, it
> would be helpful for newcomers if the meaning was present instead.

For the patch action item, I suggest to use a short description like this:
> X bugs with a patch to review in the bug tracker

For the long description, we might want to have string that looks like
this:
> The bug tracker contains patches fixing X bugs (Y if counting merged
> bugs) that should be reviewed.
> 
> If the patch is not good, a short explanation of why it can't be used
> should be given and the patch tag should be dropped. If the patch is
> good, it should be integrated in a new package release, with a changelog
> entry closing the associated bug.

We might want to add a link on "patch tag" pointing to https://www.debian.org/Bugs/Developer#tags

For the help action item, I suggest to use a short description like this:
> X bugs are in need of external help

For the long description:
> The bug tracker contains X bugs tagged help, please consider helping the
> maintainer in dealing with them. For a given bug, have a look at it, try to
> reproduce it, provide any missing information, answer open question,
> etc. If you have the required skills, prepare a patch and submit it in
> the bug tracker.

Cheers,