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

Re: I got a bug report -- td2planet #428061



Yukiharu Yabuki wrote:
[extra context:]
> Enrico Zini wrote:
>> From the description it looks like td2planet is a reimplementation of
>> Ruby, instead of a planet implemented in ruby.         

He's right; you can say "an implementation in Ruby" or "a Ruby
implementation", but "an implementation of Ruby" means something
else.
 
> please give me and upstream your advice.
>
> Enrico propse us these sentences :

I'll give it a full review while it's here.

>> Description: A planet implementation in ruby, mainly for tDiary

Capitalise software projects (etc.) in the style used by upstream;
don't capitalise short descriptions as sentences.

   Description: a Planet implementation in Ruby, mainly for tDiary

>> This package is a planet implementation written in ruby.

Likewise:
   This package is a Planet implementation written in Ruby.

But the "planet" in the next sentence refers to a particular
instance of a Planet-style RSS aggregator, and it seems plausible
that these are lowercase (like their URLs). 

>> If you would like to make a planet for tDiary bloggers, this package is
>> good for you (You should read README).

"Good for you" could be improved, and so could the punctuation:

   If you would like to make a planet for tDiary bloggers, this package is
   what you need.  See /usr/share/doc/td2planet/README.

>> Homepage: http://rubyforge.org/projects/td2planet/

This pseudoheader is conventionally formatted with one extra leading
space:

    Homepage: http://rubyforge.org/projects/td2planet/

(See Policy 5.6.13 on the effects.)         
-- 
JBR
Ankh kak! (Ancient Egyptian blessing)
--- control.old	2007-06-08 17:41:47.000000000 +0100
+++ control	2007-06-08 17:44:51.000000000 +0100
@@ -10,10 +10,11 @@
 Architecture: all
 Depends: ruby1.8
 Recommends: tdiary-theme
-Description: This is a planet implementation of ruby, mainly for tDiary
- This package is a planet another implementation of ruby.
- If you would like to make planet for tDiary blogers, This package is
- good for you. (You should read README)
+Description: a Planet implementation in Ruby, mainly for tDiary
+ This package is a Planet implementation written in Ruby.
  .
- upstream: http://rubyforge.org/projects/td2planet/
+ If you would like to make a planet for tDiary blogers, this package is
+ what you need.  See /usr/share/doc/td2planet/README.
+ .
+  Homepage: http://rubyforge.org/projects/td2planet/
 
Source: td2planet
Section: web
Priority: extra
Maintainer: Yukiharu YABUKI <yabuki@netfort.gr.jp>
Build-Depends: cdbs, debhelper (>= 5)
Build-Depends-Indep: ruby-pkg-tools (>= 0.11), ruby1.8
Standards-Version: 3.7.2

Package: td2planet
Architecture: all
Depends: ruby1.8
Recommends: tdiary-theme
Description: a Planet implementation in Ruby, mainly for tDiary
 This package is a Planet implementation written in Ruby.
 .
 If you would like to make a planet for tDiary blogers, this package is
 what you need.  See /usr/share/doc/td2planet/README.
 .
  Homepage: http://rubyforge.org/projects/td2planet/


Reply to: