Hi, so here's my take at improving the description, based on the current description in stretch: (I believe some lines are too long now, but left them as such for the sake of a better diff.)
$ cat description.new
Description-en: OpenPGP key signing and exchange for humans
monkeysign is project to overhaul the OpenPGP keysigning experience
and bring it closer to something that most primates can understand.
.
To achieve that it makes use of cheap digital cameras and the type of bar
code known as a QRcode to provide a human-friendly yet still-secure
keysigning experience.
.
No more reciting tedious strings of hexadecimal characters. And, you
can build a little rogue's gallery of the people that you have met
and exchanged keys with!
.
Monkeysign is also the name of it's commandline signing software, a caff
replacement. Monkeyscan is the graphical user interface that scans
qrcodes.
$ diff -Nur description.orig description.new
--- description.orig 2017-09-16 19:49:45.216000000 +0200
+++ description.new 2017-09-16 19:50:52.965000000 +0200
@@ -1,8 +1,8 @@
Description-en: OpenPGP key signing and exchange for humans
- monkeysign is a tool to overhaul the OpenPGP keysigning experience
+ monkeysign is a project to overhaul the OpenPGP keysigning experience
and bring it closer to something that most primates can understand.
.
- The project makes use of cheap digital cameras and the type of bar
+ To achieve that it makes use of cheap digital cameras and the type of bar
code known as a QRcode to provide a human-friendly yet still-secure
keysigning experience.
.
@@ -10,6 +10,6 @@
can build a little rogue's gallery of the people that you have met
and exchanged keys with!
.
- Monkeysign is the commandline signing software, a caff
+ Monkeysign is also the name of it's commandline signing software, a caff
replacement. Monkeyscan is the graphical user interface that scans
qrcodes.
I'm not entirely happy with the last paragraph, mostly because the first
three paragraphs make it sound like monkeyscan can do much more than just
scanning. But maybe it cannot?
(Also the third paragraph is still "out of style": the other paragraphs
describe what monkeysign is, while this one is different: the first sentence
has no subject, while the second one clearly and suddenly addresses the
reader, you!)
--
cheers,
Holger
signature.asc
Description: Digital signature
