-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 > Yuck! > > I'm personally a fan of sentences in the help, and would like to see us > standardize in the other direction. I think the all lower case and > semi-colons looks too much like code instead of documentation. >
My problem with sentence structure is that most times, people aren't writing in full sentences in a CLI: Creates a new consumer. Isn't an actual sentence, so formatting it as such reads awkward. The other side of that is that forcing full sentences to fulfill this formatting desire will end up with a really verbose CLI --help, which is also cumbersome. That's what the man page is for. - -- Jason Dobies RHCE# 805008743336126 Freenode: jdob -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.14 (GNU/Linux) Comment: Using GnuPG with Fedora - http://enigmail.mozdev.org/ iQEcBAEBAgAGBQJMoMFNAAoJEOMmcTqOSQHCnsQIALFA+X4DY6lsU4MDKRn/CQCQ OiguA0roFfng/x2ok7kRR8mxuaqG04P6qs7zGntwhguymRTOY+3R1Nn00O9h0aYS 6LR2qkOmbxGKyqeFktKTBpFu89MvYj55bMwjKd4GcpkJx1qWLMpHHIXCBW6fEjLZ rVM/L/VzqKvRTCGebOm1MVbz8pQ81TEKNOkVEIWyrUu87e0sm8mQtHwauwd5LaqG hEzHQk32Jn+o6yfOjAVB8SeXphzCmuDbyNTetL7FDGM9LuucgPmAQRFpoTFVNJVz CzVznc1rynKs8jrr/sITQFbxDkdipZTLVOOUudTHM5wdABOApj7Dl3yrk1hGP9Y= =fy9X -----END PGP SIGNATURE----- _______________________________________________ Pulp-list mailing list [email protected] https://www.redhat.com/mailman/listinfo/pulp-list
