Merge pull request #10074 from mcanouil/docs/issue-discussion-examples

docs: Improve issue/discussion templates

Author: cscheid

.github/DISCUSSION_TEMPLATE/q-a.yml

@@ -28,7 +28,11 @@ body:
         print("Hello, world!")
         ```
 
-        ![A placeholder image](https://placehold.co/600x400.png)
+        ![An image]({{< placeholder 600 400 >}}){#fig-placeholder}
+
+        {{< lipsum 1 >}}
+
+        A reference to @fig-placeholder.
 
         The end.
         ````
@@ -49,16 +53,31 @@ body:
       placeholder: |
         You can include Quarto document code which includes code blocks like this:
 
+        `````md
         ````qmd
         ---
-        title: "Hello Quarto!"
+        title: "Reproducible Quarto Document"
         format: html
+        engine: jupyter
         ---
 
-        ```py
-        print("Hello Quarto!")
+        This is a reproducible Quarto document using `format: html`.
+        It is written in Markdown and contains embedded Python code.
+        When you run the code, it will produce a message.
+
+        ```{python}
+        print("Hello, world!")
         ```
+
+        ![An image]({{< placeholder 600 400 >}}){#fig-placeholder}
+
+        {{< lipsum 1 >}}
+
+        A reference to @fig-placeholder.
+
+        The end.
         ````
+        `````
 
         ---
 

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -10,7 +10,7 @@ body:
         We are always happy to hear feedback from our users.
 
         This is the repository for the command-line program `quarto`:
-        
+
         - If you're reporting an issue with the VS Code extension, please visit https://github.com/quarto-dev/quarto
         - If you're reporting an issue inside RStudio, please visit https://github.com/rstudio/rstudio
 
@@ -24,6 +24,37 @@ body:
 
         Thank you for using Quarto!
 
+        ---
+
+        You can share a Quarto document using the following syntax, _i.e._, using more backticks than you have in your document (usually four ` ```` `).
+        For example with Quarto CLI >=1.5:
+
+        `````md
+        ````qmd
+        ---
+        title: "Reproducible Quarto Document"
+        format: html
+        engine: jupyter
+        ---
+
+        This is a reproducible Quarto document using `format: html`.
+        It is written in Markdown and contains embedded Python code.
+        When you run the code, it will produce a message.
+
+        ```{python}
+        print("Hello, world!")
+        ```
+
+        ![An image]({{< placeholder 600 400 >}}){#fig-placeholder}
+
+        {{< lipsum 1 >}}
+
+        A reference to @fig-placeholder.
+
+        The end.
+        ````
+        `````
+
   - type: textarea
     attributes:
       label: Bug description
@@ -39,22 +70,31 @@ body:
       placeholder: |
         You can share a Quarto document using the following syntax, _i.e._, using more backticks than you have in your document (usually four ` ```` `).
 
+        `````md
         ````qmd
         ---
         title: "Reproducible Quarto Document"
         format: html
+        engine: jupyter
         ---
 
         This is a reproducible Quarto document using `format: html`.
-        It is written in Markdown and contains embedded R code.
-        When you run the code, it will produce a plot.
+        It is written in Markdown and contains embedded Python code.
+        When you run the code, it will produce a message.
 
-        ```{r}
-        plot(cars)
+        ```{python}
+        print("Hello, world!")
         ```
 
+        ![An image]({{< placeholder 600 400 >}}){#fig-placeholder}
+
+        {{< lipsum 1 >}}
+
+        A reference to @fig-placeholder.
+
         The end.
         ````
+        `````
 
   - type: textarea
     attributes: