Command Line Interface Guidelines
Command Line Interface Guidelines
An open-source guide to help you write better command-line programs, taking traditional UNIX principles and updating them for the modern day.
The tools linked in the article (eg WebAIM)you linked give white on black a pass.
The Philosophy section has quite a few wonky arguments; I'd skip it altogether.
Guidelines is pretty succinct and has many rules-of-thumb that almost any software would benefit from. That's including CLI, GUI, libraries -- even hardware if you take a bit of a step back.
The Philosophy section has quite a few wonky arguments; I’d skip it altogether.
I agree. I wish they moved that to a standalone section so that it could be easily skipable. Reference docs can and should have a rationale, but a lengthy rant is not what leads people to the site.
That's way too much text. It's an interesting topic but I can't imagine anyone is going to read that essay. Can't it be condensed down to a few simple examples?