[Python-modules-team] Bug#580716: rabbitvcs: description leads user to believe that multiple VCSes are supported

brian m. carlson sandals at crustytoothpaste.ath.cx
Fri May 7 23:32:24 UTC 2010


Package: rabbitvcs
Version: 0.13.1-1
Severity: normal

According to Policy §3.4:

  The description should describe the package (the program) to a user
  (system administrator) who has never met it before so that they have
  enough information to decide whether they want to install it.  This
  description should not just be copied verbatim from the program's
  documentation.

Each of the four rabbitcvs-* packages that are new today contain the
following as the first paragraph of their descriptions:

  RabbitVCS is a set of graphical tools written to provide simple and
  straightforward access to the version control systems you use. There
  are extensions for Nautilus, Thunar and GEdit, and a simple
  command-line interface.

Notice that the phrase is "the version control systems you use".  Only
on the -core package is it stated that it only supports Subversion.
Instead of using hyperbole, perhaps you could specify in each package
description that "RabbitVCS is a set of graphical tools writtten to
provide simple and straightforward access to Subversion." Currently, the
description is not very useful because it does not help me as an
administrator to know whether RabbitVCS is something I want to install
at the moment.  What it may do in the future is unknowable and not
useful to imply in the package description.

-- System Information:
Debian Release: squeeze/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.32-5-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

-- 
brian m. carlson / brian with sandals: Houston, Texas, US
+1 832 623 2791 | http://www.crustytoothpaste.net/~bmc | My opinion only
OpenPGP: RSA v4 4096b: 88AC E9B2 9196 305B A994 7552 F1BA 225C 0223 B187
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 836 bytes
Desc: Digital signature
URL: <http://lists.alioth.debian.org/pipermail/python-modules-team/attachments/20100507/a49657d9/attachment.pgp>


More information about the Python-modules-team mailing list