A setup note needs to show a required input and an optional destination. A reader should be able to tell a syntax diagram from a line with real values.
Here is a fictional command synopsis. Uppercase tokens mark values to replace. Square brackets group the optional flag and its argument.
pack-notes INPUT_FILE [--output-dir OUTPUT_DIR]
Example notation. Both the flag and its value are optional together.
Show both forms with concrete values
pack-notes shift.md
pack-notes shift.md --output-dir handoffThe first form omits both the flag and the destination. The second supplies both. For a real command, check its documentation and state where the output goes when the option is absent.

Example command lines. Keep the brackets and placeholder names out of concrete invocations.
Use separate code blocks for the synopsis and examples. Check that any example intended to be copied contains neither the explanatory brackets nor the unreplaced placeholder names.



