writing: updated based on PR feedback

Author: SaintRod

writing/index.md

@@ -264,12 +264,10 @@ julia> Pluto.run()
 \tldr{Markdown is also a good fit for literate programming, and Quarto is an alternative to notebooks.}
 
 [Markdown](https://www.markdownguide.org/) is a markup language used to add formatting elements to plaintext text files.
-For example, to bold text one encapsulates words with double asterisks: `**bold text**` -> **bold text**.
-Markdown files can be opened by any text editor, such as VSCode, and are particularly useful when the file itself is not the final product.
 
 ### Plain Text Markdown
 Plain text markdown files, which have the `.md` extension, are not used for interactive programming, meaning one cannot run code written in the file.
-Plain text markdown files are usually rendered into something else, such as but not limited to documents (e.g., PDF, Word), websites, presentations, and even books.
+As a result, plain text markdown files are usually rendered into a final product by other software.
 
 This is an example of a plain text markdown file:
 
@@ -290,37 +288,40 @@ println("hello world")
 [Quarto](https://quarto.org/) "is an open-source scientific and technical publishing system."
 Quarto makes a plain text markdown file (`.md`) alternative called Quarto markdown file (`.qmd`).
 
-Quarto markdown files like plain text markdown files also integrate with editors, such as VSCode, and can be rendered into various output formats, such as websites.
+Quarto markdown files like plain text markdown files also integrate with editors, such as VSCode.
 
 \vscode{
 
-Install the Quarto extension for a streamlined experience.
+Install the Quarto [extension](https://marketplace.visualstudio.com/items?itemName=quarto.quarto) for a streamlined experience.
 
 }
 
 Unlike plain text markdown files, Quarto markdown files have executable code chunks.
-These code chunks provide a functionality similar to notebooks, which makes Quarto markdown files an alternative to writing code in notebooks.
-Additionally, Quarto markdown files give users additional control over output and styling via YAML headers.
+These code chunks provide a functionality similar to notebooks, thus Quarto markdown files are an alternative to notebooks.
+Additionally, Quarto markdown files give users additional control over output and styling via the YAML header at the top of the `.qmd` file.
 
-Below is a revised markdown example using Quarto.
-If this file were opened in an editor such as VSCode one could execute the `println("hello world")` Julia code and view the output.
-Also, notice the YAML header at the top of the page that defines the document's title and specifies to make the code chunks invisible via the `echo: false` command.
-When `echo` is set to `false` the output of the code chunks will be displayed but the code itself will be hidden.
-
-Last, as of Quarto version 1.5, Julia programmers have the option to use a native Julia engine to execute code - previously IJulia.jl was the only Julia engine.
-The primary difference betweens IJulia.jl and the native Julia engine is that the native Julia engine does not depend on Python and can utilize local environments.
+As of Quarto version 1.5, users can choose from two Julia engines to execute code - a native Julia engine and IJulia.jl.
+The primary difference between the native Julia engine and IJulia.jl is that the native Julia engine does not depend on Python and can utilize local environments.
+For this reason it's recommended to start with the native Julia engine.
 Learn more about the native Julia engine in Quarto's [documentation](https://quarto.org/docs/blog/posts/2024-07-11-1.5-release/#native-julia-engine).
-To use the native Julia engine set `engine` equal to `julia` in the YAML header of the Quarto markdown file as seen below.
+
+Below is an example of a Quarto markdown file.
 
 ````quarto
 ---
 title: "My document"
 format:
+  # renders a HTML document
   html:
+    # table of contents
     toc: true
 execute:
+  # makes code chunks invisible in the output
+  # code output is still visible though
   echo: false
+  # hides warnings in the output
   warning: false
+# native julia engine
 engine: julia
 ---
 
@@ -330,6 +331,8 @@ engine: julia
 
 Below is an executable code chunk.
 
+If this file were opened in an editor such as VSCode one could execute the `println("hello world")` Julia code and view the output, like in a notebook.
+
 ```{{julia}}
 println("hello world")
 ```