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

Re: Proof reading of python-recaptcha description



Vincent Bernat <bernat@debian.org> writes:

> Description: reCAPTCHA and Mailhide client modules

It might be clearer to use the term "library", which indicates the
integrated nature of these modules.

Description: client library for reCAPTCHA and Mailhide

>  This Python package provides modules for both reCAPTCHA and reCAPTCHA
>  Mailhide.

The long description shouldn't depend on the synopsis, so this should
specify that it's for a client to these services.

    This Python package provides modules implementing clients for both
    reCAPTCHA and reCAPTCHA Mailhide.

>  These modules access a free (as in free beer) web service […]

Rather than use the ambiguous term "free", and then immediately need
to disambiguate, use terms that are already clear:

    These modules access a web service that requires sites running the
    reCAPCHA client to register (at no cost) for an API key. […]

-- 
 \      “Every valuable human being must be a radical and a rebel, for |
  `\      what he must aim at is to make things better than they are.” |
_o__)                                                      —Niels Bohr |
Ben Finney


Reply to: