search

quarto-dev / quarto-r

R interface to quarto-cli
https://quarto-dev.github.io/quarto-r/
144 stars 22 forks source link

Please clarify what the purpose of the quarto package is. #176

Closed davidkane9 closed 5 months ago

davidkane9 commented 5 months ago

From here:

We don't want the Quarto R package to duplicate what the Quarto CLI does.

Assuming this is true, it would be good to document this fact clearly and to describe exactly what the purpose is of the Quarto R package. I had mistakenly assumed that this was (part of) the purpose!

I had certainly assumed that, for example, the purpose of the quarto_publish_doc() command was to publish documents and that such a command would (naturally!) allow one to publish to Quarto Pub. Perhaps I am mistaken?

This is important for me as a teacher because I need to decide the best way to have my beginner students make their work public. The easiest way, of course, are buttons on RStudio, like the handy publish button. The second best way is using an R package like quarto. The hardest way is using the command line.

I had assumed that there was an effort to make quarto package an easy way for students to publish to sites like Quarto Pub. If that is not the case, please let everyone know!

davidkane9 commented 5 months ago

Closing and replacing with a better issue.