The following message is a courtesy copy of an article
that has been posted to gmane.linux.debian.devel.general as well.
Didier 'OdyX' Raboud writes:
> * Package name: brpc
> Version : 1.7.0
> Upstream Contact: d...@brpc.apache.org
> * URL : https://brpc.apache.org/
> * License : Apache-2.0
> Programming Lang: C++
> Description : Industrial-grade RPC
> Apache bRPC is often used in high performance systems such as Search,
> Storage, Machine learning, Advertisement, Recommendation, etc
>
> (the short and long descriptions' are really bad; suggestions welcome!
suggestions:
- say what it is for - why would i install it?
- See also guide at http://jbr.me.uk/linux/esl.html (section F)
specifics:
- avoid hyperbole like "industrial-grade", "high performance" - if it means
something
specific - fast? reliable? follows some standard? - say that, else avoid.
I dont think "high performance systems such as X, Y, Z" with "such as"
works unless "X, Y, Z" are the names of "high-performance systems" ---
perhaps "Search" is (bad) shorthand for "systems for searching ",
but "machine learning" is not really a "system". "Advertisement" could
mean several things - is this software for producing adverts? (maybe
"such as for" is better, but I think how people have used something is
much less interesting that what features the something provides. And is
"often" based on any data?)
- avoid jargon - or at least explain what "RPC" means
- unless it's to do with the apache web-server, or part of the name, the
word "Apache" may be confusing. (if it's a module try and copy their
descriptions).
