Commit 77e00e3
committed
Remove section on "delight"
The other parts of this CLI guide already cover the things that make a
CLI pleasant to use:
* stable output that's easily piped to Big Data Tools like awk/sed/cut
etc.
* good error messages
* consistency in switches
* consistent exit codes
* easily accessible documentation
* thoughtful use of colour in interactive contexts
The examples given in the removed "Delight" section are examples of what
not to do.
* Don't use the CLI as a billboard for marketing/advertising.
* Don't use wit in error messages. Something has gone wrong, the user
has to work out what/why, and whimsical error messages diminish
that fact.1 parent 12b88dc commit 77e00e3
1 file changed
Lines changed: 0 additions & 17 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
190 | 190 | | |
191 | 191 | | |
192 | 192 | | |
193 | | - | |
194 | | - | |
195 | | - | |
196 | | - | |
197 | | - | |
198 | | - | |
199 | | - | |
200 | | - | |
201 | | - | |
202 | | - | |
203 | | - | |
204 | | - | |
205 | | - | |
206 | | - | |
207 | | - | |
208 | | - | |
209 | | - | |
210 | 193 | | |
211 | 194 | | |
212 | 195 | | |
| |||
0 commit comments