Re: Bug#501121: jd: package description inadequate
Ben Finney wrote:
>>> ***** BEGINNING *****
>>> JD is a simple and easy-to-use browser for 2ch-style bulletin board
>>> systems (or Internet forums), which ensures you comfortable 2ch browsing
>>> experience with its various functionalities such as logging in,
>>> message viewing/posting, image viewing, mouse gestures, ignore lists,
>>> "play-by-play" mode, and so on, while significantly reducing server workloads
>>> by bypassing CGI programs and directly retrieving thread data files
>>> to your local hard drives.
>
> The sentence is far too long; package descriptions are usually better
> with separate, simpler sentences. I also find some of the terms a
> little verbose and unclear. Suggested improvement:
>
> Description: simple browser for “2ch-style” web forum sites
> JD is a simple browser allowing easy use of “2ch-style” web
> forum sites. Its features include:
A bit repetitive.
> .
> * log in
> * message view/post
> * image view
Reading "log in" as a verb makes the list a mix of verbs and nouns.
Also, keep the "ing"s on "viewing", "posting" ("image view" might
mean "a mode that displays things as if they were images").
(Oh, and we seem to have arbitrarily standardised on hyphens as
bulletpoints.)
> * mouse gestures
> * ignore lists
> * “play-by-play” mode
What happened to the bit about server workloads?
> .
> “2ch-style” web forum sites have their origins in 2channel,
> which is a very popular Internet forum in Japan. Such sites are
> often available only in the Japanese language. The sites
> supported by JD include:
> .
> * 2channel <http://www.2ch.net>
> * Shitaraba <http://rentalbbs.livedoor.com/jbbs/>
> * Machi-BBS <http://www.machi.to/>
No need for any sort of brackets on the URLs.
Description: simple browser for "2ch-style" web forum sites
JD offers a comfortable browsing experience on 2ch-style bulletin
board systems. Its features include:
.
- automated login,
- message viewing/posting,
- image viewing,
- mouse gestures,
- ignore lists,
- "play-by-play" mode.
.
It can also significantly reduce the load on servers by bypassing
CGI programs and directly retrieving thread data files to your local
hard drives.
.
"2ch-style" web forum sites have their origins in 2channel,
which is a very popular Internet forum in Japan. Such sites are
often available only in the Japanese language. For example:
.
- 2channel http://www.2ch.net
- Shitaraba http://rentalbbs.livedoor.com/jbbs/
- Machi-BBS http://www.machi.to/
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
Reply to: