quarto-dev / quarto-dev/quarto-cli
Improve the Get Started Flow for Positron
@cwickham is already working on this.
Since Jun 30, 2025.
- Dominant language
- JavaScript
- Stars
- 6k
- Forks
- 458
- Avg merge
- 1d 9h
- Merged PRs (30d)
- 41
Description
The current docs have a user download a document, open it in Positron, and give basic setup instructions (e.g. which packages to make sure they have installed).
I think we could do something much better. I.e. ideally a single command (that we could help a user run by providing a positron:// link in the docs) that initiates the flow below, so a user can get everything they need and have as a high a probability as possible that the first Quarto Preview on hello.qmd just works.
Flow:
-
Offer a choice between R and Python.
-
Create a new folder and populate it with the Get Started (language-specific) documents:
hello.qmdcomputations.qmdauthoring.qmd
-
Python only: a prompt to get create a virtual environment, and activate it.
-
Check and prompt to install the packages required for Quarto:
- Python:
jupyter - R:
rmarkdown
- Python:
-
Check and prompt to install the packages required for the Get Started documents:
- Python:
plotnine - R:
tidyverse
- Python:
-
A guarantee (or check) that the interpreter Quarto will find is the same as the active one in the Console.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.