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

Bug#513053: marked as done ([checks/descriptions] include first-word-of-sentences-too-repetitive)



Your message dated Thu, 19 Sep 2013 16:19:53 +0200
with message-id <523B0809.7080606@thykier.net>
and subject line Re: Bug#513053: [checks/descriptions] include first-word-of-sentences-too-repetitive
has caused the Debian Bug report #513053,
regarding [checks/descriptions] include first-word-of-sentences-too-repetitive
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@bugs.debian.org
immediately.)


-- 
513053: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=513053
Debian Bug Tracking System
Contact owner@bugs.debian.org with problems
--- Begin Message ---
Package: lintian
Version: 2.2.0
Severity: wishlist
Tags: patch

Hi,

Proposed check info:
> Tag: using-first-person-in-description
> Severity: minor
> Certainty: possible
> Info: You should avoid the use of first person ("I will do this..." or
>  "We recommend..."). The computer is not a person and the description does
> not speak for the maintainer(s). You should use neutral construction and
> often the passive form.

This check is based on using-first-person-in-template, but with a couple of 
words more (which in the end should also be included in the original check). 
It also checks for the word "You" (case sensitive) because by definition a 
description should not give instructions to the reader (like "You should 
really install package bar if you use foo"). I felt like lowercase "you" 
would be too picky.
I originally used severity: normal, but later was unsure about the severity 
because if I filed a bug report I would use severity: minor but using this 
severity causes an EWI code of I which lintian by default doesn't display it.

As a bonus the attached mbox contains a patch implementing:

> Tag: first-word-of-sentences-too-repetitive
> Severity: minor
> Certainty: wild-guess
> Info: The given word is used very often as the first word of a sentence. 
> This makes the description hard to read because it is repetitive.
>  .
>  Consider rephrasing the description, using a more wide diversity of words.
>  In case you have troubles with it an email to the english i18n mailing
> list should help.

Cheers,
-- 
Raphael Geissert - Debian Maintainer
www.debian.org - get.debian.net

Attachment: lintian_descriptions.mbox
Description: application/mbox


--- End Message ---
--- Begin Message ---

Hi,

There has been no news on this bug for over 4 years, so I guess it is
safe to assume this is "not going to happen"?  In light of this, I have
taken the liberty of closing the bug.  If my assumption is wrong, feel
free to reopen the bug.

~Niels

--- End Message ---

Reply to: