Commandline CLI options: documentation incomplete?

[ratnanil]

Description

I love quarto and that it's a CLI tool. However, I feel like the commandline options are not very well documented. For example: the following command creates an extension of the fomat typst with the name test. Where is this documented?

quarto create extension format:typst test

The option --help does not provide much help (see details below)

quarto create extension --help


Usage:   quarto create [type] [commands...]
Version: 1.8.19                            

Description:

  Create a Quarto project or extension

Options:

  -h, --help              - Show this help.                                               
  --open        [editor]  - Open new artifact in this editor (positron, vscode, rstudio)  
  --no-open               - Do not open in an editor                                      
  --no-prompt             - Do not prompt to confirm actions                              
  --log         <file>    - Path to log file                                              
  --log-level   <level>   - Log level (debug, info, warning, error, critical)             
  --log-format  <format>  - Log format (plain, json-stream)                               
  --quiet                 - Suppress console output.                                      
  --profile               - Active project profile(s)                                     

Commands:

  help  [command]  - Show this help or the help of a sub-command.

Different example: If I want to use a template (e.g. quarto use template quarto-journals/acm) I am asked if I trust the authors, want to create a subdirectory and would like to install the extension. I feel like there must be some parameters I can pass to use to answer these questions, is this documented somewhere?

I was hoping for something like man quarto or an online documentation.

[mcanouil]

Thanks for the feedback.

This is tracked with:

• Reference for CLI subcommands? #598

There are some work to improve this, but not quite fully done.