I don't think the CLI one is a good analogy.

> We left command-line interfaces behind 40 years ago for a reason

Man I still love command-line so much

> And it would go on like this for hours while you tried in vain to guess what the hell it wanted you to type, or you discovered the outdoors, whichever came first. [...] guess what secret spell they had to type into their computer to get actual work done

Well... docs and the "-h" do a pretty good job.