Bezsensowne opisy modułów perlowych

Paweł A. Gajda mis w pld.org.pl
Czw, 13 Lut 2003, 12:29:21 CET


środa 12/02/2003 22:33:12, Andrzej Krzysztofowicz:
> > 
> > Właśnie. Sporo modułów ma takie wiele mówiące opisy 
> > (szczególnie w Summary) jak "Foo::Bar perl module" -- 
> > coś co *nic* nie mówi o zawartości pakietu. 
> > 
> > Już zupełnym kuriozum jest tłumaczenie tego, taki 
> > perl-Class-Virtual.spec miał kilkanaście wersji 
> > językowych "Class::Virtual perl module". 
> > 
> > Konkluzja: wycinamy takie kwiatki. 
> 
> Raczej zastepujemy bardziej rozwleklymi opisami. Samo 
> wycinanie nie jest lepsze niz stan obecny.

Dlaczego? 

W tym przypadku brak informacji jest zdecydowanie lepszy:

$ LANG=en poldek --shcmd='desc perl-Class-Virtual' | grep Summary
Summary: Class::Virtual Perl module - Base class for virtual base classes

$ LANG=de poldek --shcmd='desc perl-Class-Virtual' | grep Summary
Summary: Class::Virtual Perl Modul

Jeżeli nie jesteśmy w stanie napisać sensownego Summary to lepiej
nie pisać nic. Umożliwi to przynajmniej korzystanie z locale 
(oczywiście angielskie Summary jest wymagane z definicji).




Więcej informacji o liście dyskusyjnej pld-devel-pl