If you have a CLI tool that outputs more than ~10 lines of info, it should really use bold and colour. It makes a huge difference to readability!
Related Posts
It is *really* hard to find a good screenshot for a CLI tool when users are on a mobile browser.
This is the best I've come up with so far. I'm showing the terminal GUI to show where you'd use the tool.
I'm also trying several standalone screenshots to make it more comprehensible.
I'm trying to improve the readability of the --help output from difftastic.
I'm experimenting with making example invocations bold, so they are easier to distinguish from the text.
I'm also trying OSC 8 to make my URLs clickable.
Opinions welcome :)
I'm coming round to the view that a main function shouldn't take arguments.
For example, in Rust you have to call std::env::args() to get CLI arguments.
This makes Hello World less verbose, and gives you more flexibility in setting up CLI argument parsers.