RStudio User Guide

If you’re interested in getting involved with open source, contributing to documentation is a good—and helpful—place to start. - James Turnbill

If you have found issues with the RStudio User Guide, please check for existing duplicate issues/pull requests. If a matching Issue/Pull Request doesn’t exist, please then open an Issue or Pull Request. Each page in the RStudio User Guide docs have an option to view the source which is useful for specifying a line of code in an Issue. Alternatively, selecting “Edit this Page” will prepare you to open a quick Pull Request from your browser.

Development

To locally test changes to the User Guide, you will need to do the following:

  1. Install Quarto or RStudio 2022.07.2 or later, which bundles Quarto.
  • Quarto is bundled with RStudio. Download RStudio from posit.co/downloads/
  • If not using RStudio, download the CLI directly from github.com/quarto-dev for your operating system
  • Optionally install the Quarto R Package with install.packages("quarto")
  1. Clone the rstudio repo
  2. Open up the docs/user/rstudio/ directory in your favorite IDE (RStudio!).
  3. Serve the project in one of the following ways.

This will serve the site to the RStudio Viewer or your web browser. Quarto will detect when you make changes to any of the qmd files and rerender that page.

  • From an open .qmd file, click the Render button

  • From the command line, quarto preview from within the docs/user/rstudio directory:

cd docs/user/rstudio
quarto preview
  • From the R console, enter quarto::quarto_preview() on the file you’ve changed like below:
quarto::quarto_preview(file = "docs/user/rstudio/index.qmd")

Regardless of the method - you are likely to see the below error, because you don’t have the environment variables set that we use in the build process. You can safely ignore these as they are resolved during our render/publish of the guide to docs.posit.co.

WARNING: Unknown var buildType specified in a var shortcode.
WARNING: Unknown var version specified in a var shortcode.
  1. Once you have confirmed that the changes are technically accurate and that the rendered output is visually correct, you can either open a Pull Request with your changes or an Issue with the suggested fix.

Thank you for your contribution to open source - it will definitely help future users (and probably you)!

Back to top