but for God’s sake just introduce basic usages first
And include practical examples!
Much easier to figure out the correct formatting of some command by just seeing the formatting used properly!
It’s also a great place to sneakily introduce the most common and useful ways to use the command, by including those as the examples! (Are you documenting, say, a command to compress images and documents, and even though most people never use it for video, you want people to know that it works with some video formats as well? Then include compressing .mp4 file as one of your example commands!)
And include practical examples!
Much easier to figure out the correct formatting of some command by just seeing the formatting used properly!
It’s also a great place to sneakily introduce the most common and useful ways to use the command, by including those as the examples! (Are you documenting, say, a command to compress images and documents, and even though most people never use it for video, you want people to know that it works with some video formats as well? Then include compressing .mp4 file as one of your example commands!)