Open jennybc opened 1 month ago
I agree that we need to improve the situation, possibly not only with documentation.
I don't know why we decided to keep the following option quiet, but we have quarto create --json
. You give it a JSON object on stdin, and it writes back on stdout a JSON object describing what happened:
What would you like to do?
Give feedback or suggest an improvement
Description
I had some trouble figuring out how to call
quarto create project
-- especially non-interactively or with--no-prompt
. I give some details below these are the main points:quarto create project
that does not trigger additional user interaction. In particular, it seems liketitle
is required, which I didn't expect based on what I see at https://quarto.org/docs/projects/quarto-projects.html#creating-projects.title
default toname
? Should (project)type
default to "default"?quarto create project
support the POSIX-y way of passing arguments by name, meaning--name=value
? The existing usage and help already puts my mind in that mode. Then it feels like sensible defaults could take over in non-interactive settings and even interactively you could specify just thename
, for example (quarto create project --name=whatever
).Here's what I currently see for how to use
quarto create project
:I'm not sure what the
[commands...]
bit should be. I figured it out by successively adding inputs and noticing what I was being prompted for.Culminating in this successful call:
So I think it's: