Closed ozwaldorf closed 8 months ago
While I agree that the filename being part of a flag and the URL may be redundant, I think using the long form of the flag in examples makes more sense. It is easier to read for people that are not familiar with a command. I've also found that using the long form of flags in scripts helps with readability when I come back to modify scripts months later.
thanks @ozwaldorf for the information.
I will close the issue since its content is available anyway. If you want to share the information in the docs, please open a PR, thanks :)
In the example on the site, a shorter form for
--upload-file
can be used instead,-T
, which additionally will amend the URL with the document name. It's much simpler to type and easier to useThis also works for piping output, although you must specify the document name. Perhaps the service could support a default name for this flow: