Apply review suggestions

Author: cwickham

docs/get-started/hello/positron.qmd

@@ -18,7 +18,7 @@ tool:
 Quarto is an open-source scientific and technical publishing system that weaves together code and narrative to produce high-quality documents, presentations, websites, and more.
 In this tutorial, you'll learn how to use Positron with Quarto.
 
-Positron comes ready to work with Quarto out-of-the-box --- it includes both the Quarto command line interface and the Quarto VS Code extension. 
+Positron comes ready to work with Quarto out-of-the-box --- it includes both the Quarto command line interface and the [Quarto VS Code extension](https://open-vsx.org/extension/quarto/quarto). 
 
 It includes many tools that enhance working with Quarto, including:
 
@@ -28,7 +28,7 @@ It includes many tools that enhance working with Quarto, including:
 
 -   Positron's full R and Python support for code that is inside a Quarto document, including interactive execution of code in the Console, code completion, help, and diagnostics.
 
-Here's an example Quarto document, `hello.qmd`, open in Positron, demonstrating the seamless side-by-side editing and preview experience:
+Here's a sample Quarto document, `hello.qmd`, open in Positron, demonstrating the seamless side-by-side editing and preview experience:
 
 ::: {.panel-tabset group="language"} 
 
@@ -63,7 +63,7 @@ If you would like to follow along with this tutorial in your own environment, fo
     install.packages("palmerpenguins")
     ```
 
-2.  Download the Quarto document (`.qmd`) below, open it in Positron.
+2.  Download the Quarto document (`hello.qmd`) below and open it in Positron.
 
     ::: {.callout appearance="minimal"}
     <i class="bi bi-download"></i> [Download hello.qmd](_positron/r/hello.qmd){download="hello.qmd"}
@@ -77,7 +77,7 @@ If you would like to follow along with this tutorial in your own environment, fo
     pip install jupyter plotnine
     ```
 
-2.  Download the Quarto document (`.qmd`) below, open it in Positron.
+2.  Download the Quarto document (`hello.qmd`) below and open it in Positron.
 
     ::: {.callout appearance="minimal"}
     <i class="bi bi-download"></i> [Download hello.qmd](_positron/python/hello.qmd){download="hello.qmd"}
@@ -143,7 +143,7 @@ If you prefer the preview to update whenever you save the document, you can chec
 
 The document, `hello.qmd`, is a combination of markdown and executable code cells.
 Quarto uses the term *render* to describe the process of taking this source document and producing a new file that combines the output from the executed code cells with the markdown.
-When `hello.qmd` is rendered, the new file is `hello.html`, an [HTML](/docs/output-formats/all-formats.qmd) document, but it could be a [PDF](/docs/output-formats/pdf-basics.qmd), [MS Word](/docs/output-formats/ms-word.qmd) document, [presentation](/docs/presentations/index.qmd), [website](/docs/websites/website-basics.qmd), [book](/docs/books/book-basics.qmd), [interactive document](/docs/interactive/index.qmd), or [other format](/docs/output-formats/all-formats.qmd).
+When `hello.qmd` is rendered, the new output is `hello.html`, an [HTML](/docs/output-formats/all-formats.qmd) document, but it could be a [PDF](/docs/output-formats/pdf-basics.qmd), [MS Word](/docs/output-formats/ms-word.qmd) document, [presentation](/docs/presentations/index.qmd), [website](/docs/websites/website-basics.qmd), [book](/docs/books/book-basics.qmd), [interactive document](/docs/interactive/index.qmd), or [other format](/docs/output-formats/all-formats.qmd).
 
 This is the basic model for Quarto publishing---take a source document that combines code and narrative, and render it to a variety of output formats.
 
@@ -169,7 +169,7 @@ The Quarto extension provides Positron commands as convenient alternatives to ru
 ## Authoring
 
 Let's turn our attention to the contents of our Quarto document.
-The file contains three types of content: a header, code cells, and markdown text.
+The file contains three types of content: a header, executable code cells, and markdown text.
 
 ### Document header
 
@@ -189,7 +189,7 @@ In this case, the `title` is set to `"Hello, Quarto"` and the `format` is set to
 When rendered, the `title`, will appear at the top of the rendered document with a larger font size than the rest of the document.
 The `format` field denotes the target format for the output.
 
-Other options commonly found in headers of documents include metadata like `author`, `subtitle`, `date` as well as customization like `theme`, `fontcolor`, `fig-width`, etc.
+Other options commonly found in headers of documents include metadata like `author`, `subtitle`, and `date`, as well as customizations like `theme`, `fontcolor`, `fig-width`, etc.
 The available options depend on the output format and are listed in the [Reference](/docs/reference) e.g.: [HTML options](/docs/reference/formats/html.qmd), [PDF options](/docs/reference/formats/pdf.qmd) and [MS Word options](/docs/reference/formats/docx.qmd).
 
 ### Code cells
@@ -294,8 +294,8 @@ The markdown file generated is then processed by [pandoc](http://pandoc.org/), w
 
 When a Quarto document includes executable code cells, 
 Quarto uses what is known as an *engine* to execute them.
-If you completed this tutorial with R, you'll have been using the `knitr` engine. 
-If you completed this tutorial with Python, you'll have been using the `jupyter` engine.
+If you're following along with this tutorial with R, you have been using the `knitr` engine. 
+If you're following along with Python, you have been using the `jupyter` engine.
 You can read more about how Quarto chooses an engine in [Engine Binding](/docs/computations/execution-options.qmd#engine-binding).
 
 Quarto supports other languages in addition to R and Python for code cells like [Julia](/docs/computations/julia.qmd) (via the `julia` engine or the `jupyter` engine) and [Observable JS](/docs/computations/ojs.qmd).