[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

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



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,
-- 
  ⢀⣴⠾⠻⢶⣦⠀   Raphaël Hertzog <hertzog@debian.org>
  ⣾⠁⢠⠒⠀⣿⡁
  ⢿⡄⠘⠷⠚⠋    The Debian Handbook: https://debian-handbook.info/get/
  ⠈⠳⣄⠀⠀⠀⠀   Debian Long Term Support: https://deb.li/LTS


Reply to: