Didier 'OdyX' Raboud <o...@debian.org> 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 <what?>", 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).
