Add descriptions for social sharing

.github/copilot-instructions.md

@@ -63,7 +63,8 @@ Follow these exact rules, which are based on our style guide.
 
 - Titles/H1s: Use **Title Case**
 - Other headings: Use **sentence case**
-- Do not format documentation titles. Do not italicize or use quotations. 
+- Do not format documentation titles. Do not italicize or use quotations.
+- Add `description` as YAML front matter for each `.qmd` file, to be used as social sharing metadata. 
 
 ## Formatting Rules
 

404.qmd

@@ -1,6 +1,6 @@
 ---
 title: "Page Not Found"
-format: html
+description: "The page you're looking for isn't available. Search Positron documentation or get started with our free data science IDE for Python and R."
 ---
 
 Oops! The page you requested isn't available. Try [searching our documentation](/404.qmd?q=%20&show-results=1) or find out [how to get started](welcome.qmd) with Positron.

_freeze/install/execute-results/html.json

@@ -1,8 +1,8 @@
 {
-  "hash": "28f78563ba45adbab1f59f80422bf2f9",
+  "hash": "d31d35efc0941f0284c59dc9de62fb69",
   "result": {
     "engine": "knitr",
-    "markdown": "---\ntitle: \"Install Positron\"\nformat:\n  html:\n    include-in-header:\n      - '_download.html'\naliases:\n  - start.html\n---\n\nPositron is a modern, extensible IDE for data science built on [Code OSS](https://github.com/microsoft/vscode). Before you install Positron, please review the prerequisites below to ensure your system is ready.\n\n## Prerequisites\n::: {.panel-tabset}\n\n### Windows\n\nIf you're using Windows, make sure you have the [latest Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#latest-microsoft-visual-c-redistributable-version) installed.\n\n### Python setup\nPositron works with [actively supported versions](https://devguide.python.org/versions/#versions) of Python, from 3.9 to 3.13.\n\nWe recommend [uv](https://docs.astral.sh/uv/guides/install-python/), or [pyenv](https://github.com/pyenv/pyenv) and [pyenv for Windows](https://github.com/pyenv-win/pyenv-win), for managing Python versions.\n\nPositron requires the [IPython kernel](https://pypi.org/project/ipykernel/) (version 6.19.1 or higher) to communicate with Python. By default, the IPython kernel is bundled with Positron for the CPython implementation (the standard Python implementation) and added to the [Python search path](https://docs.python.org/3/library/sys_path_init.html).\n\nIf you prefer finer control over your Python environment, set the [`python.useBundledIpykernel`](positron://settings/python.useBundledIpykernel) setting to false and install the IPython kernel manually\n\n::: callout-note\nIf you're using an implementation other than CPython, you'll need to install the IPython kernel manually.\n:::\n\n### R setup\n\nIf you plan to use R with Positron, ensure you have R 4.2 or higher installed. To install R, follow the instructions for your operating system at <https://cloud.r-project.org/>.\n\nAlternatively, if you'd like to have multiple R installations, [rig](https://github.com/r-lib/rig) is a great tool to manage this which works well with Positron.\n\nIf you're an R package developer, you will also want to make sure that you have the current versions of certain R packages, all of which had recent updates to make them work more smoothly in Positron. Run one of the code snippets below to ensure that you are up-to-date:\n\n``` r\n# if you're a pak person (we are!)\npak::pak(c(\"usethis\", \"cli\", \"crayon\", \"rlang\", \"roxygen2\", \"pkgload\"))\n\n# or using base R\ninstall.packages(c(\"usethis\", \"cli\", \"crayon\", \"rlang\", \"roxygen2\", \"pkgload\"))\n```\n\n::: callout-note\nIf you're a Windows user, note that Positron doesn't currently bundle [Rtools](https://cran.r-project.org/bin/windows/Rtools/). If you need Rtools for your package development or other work, you can either use the official guidance from CRAN on installing Rtools and putting it on the PATH, or alternatively, use [rig](https://github.com/r-lib/rig) to install and set up Rtools:\n\n```bash\nrig system rtools add\n```\n:::\n\n:::\n\n## Install Positron\n\nDownload the installer for your operating system from the button below and follow the standard installation process for your platform. You only need to install Positron once, as it [automatically updates](updating.qmd) to the latest version after installation.\n\n:::{.callout-important #privacy-policy}\n## Accept license agreement\n\nPlease review [Positron's license agreement](licensing.qmd) and [privacy policy](https://posit.co/about/privacy-policy/). Your acceptance of this license agreement and privacy policy is required as a condition to proceeding with your download or use of the software.\n\n<div id=\"privacy-policy-agreement\">\n  <input type=\"checkbox\" id=\"privacy-checkbox\" onclick=\"updatePrivacy(this)\">\n  <label>I agree to the <a href=\"licensing.qmd\">Positron license agreement</a> and <a href=\"https://posit.co/about/privacy-policy/\">Posit Privacy Policy</a>.</label>\n</div>\n:::\n\n<!-- The below R code is used by the _download.html snippet\nto populate the platform-default download button -->\n\n::: {.cell}\n\n:::\n\n\n[Download Positron <span id=\"os-name\"></span>](#){.btn .btn-primary .disabled #download-btn data-version=\"2025\\.12\\.1\\-4\"}\n\n[All Downloads](download.qmd){#all-downloads}\n",
+    "markdown": "---\ntitle: \"Install Positron\"\ndescription: \"Get started with Positron right away. Install the free data science IDE for Python and R, with prerequisites and setup instructions for all platforms.\"\nformat:\n  html:\n    include-in-header:\n      - '_download.html'\naliases:\n  - start.html\n---\n\nPositron is a modern, extensible IDE for data science built on [Code OSS](https://github.com/microsoft/vscode). Before you install Positron, please review the prerequisites below to ensure your system is ready.\n\n## Prerequisites\n::: {.panel-tabset}\n\n### Windows\n\nIf you're using Windows, make sure you have the [latest Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#latest-microsoft-visual-c-redistributable-version) installed.\n\n### Python setup\nPositron works with [actively supported versions](https://devguide.python.org/versions/#versions) of Python, from 3.9 to 3.13.\n\nWe recommend [uv](https://docs.astral.sh/uv/guides/install-python/), or [pyenv](https://github.com/pyenv/pyenv) and [pyenv for Windows](https://github.com/pyenv-win/pyenv-win), for managing Python versions.\n\nPositron requires the [IPython kernel](https://pypi.org/project/ipykernel/) (version 6.19.1 or higher) to communicate with Python. By default, the IPython kernel is bundled with Positron for the CPython implementation (the standard Python implementation) and added to the [Python search path](https://docs.python.org/3/library/sys_path_init.html).\n\nIf you prefer finer control over your Python environment, set the [`python.useBundledIpykernel`](positron://settings/python.useBundledIpykernel) setting to false and install the IPython kernel manually\n\n::: callout-note\nIf you're using an implementation other than CPython, you'll need to install the IPython kernel manually.\n:::\n\n### R setup\n\nIf you plan to use R with Positron, ensure you have R 4.2 or higher installed. To install R, follow the instructions for your operating system at <https://cloud.r-project.org/>.\n\nAlternatively, if you'd like to have multiple R installations, [rig](https://github.com/r-lib/rig) is a great tool to manage this which works well with Positron.\n\nIf you're an R package developer, you will also want to make sure that you have the current versions of certain R packages, all of which had recent updates to make them work more smoothly in Positron. Run one of the code snippets below to ensure that you are up-to-date:\n\n``` r\n# if you're a pak person (we are!)\npak::pak(c(\"usethis\", \"cli\", \"crayon\", \"rlang\", \"roxygen2\", \"pkgload\"))\n\n# or using base R\ninstall.packages(c(\"usethis\", \"cli\", \"crayon\", \"rlang\", \"roxygen2\", \"pkgload\"))\n```\n\n::: callout-note\nIf you're a Windows user, note that Positron doesn't currently bundle [Rtools](https://cran.r-project.org/bin/windows/Rtools/). If you need Rtools for your package development or other work, you can either use the official guidance from CRAN on installing Rtools and putting it on the PATH, or alternatively, use [rig](https://github.com/r-lib/rig) to install and set up Rtools:\n\n```bash\nrig system rtools add\n```\n:::\n\n:::\n\n## Install Positron\n\nDownload the installer for your operating system from the button below and follow the standard installation process for your platform. You only need to install Positron once, as it [automatically updates](updating.qmd) to the latest version after installation.\n\n:::{.callout-important #privacy-policy}\n## Accept license agreement\n\nPlease review [Positron's license agreement](licensing.qmd) and [privacy policy](https://posit.co/about/privacy-policy/). Your acceptance of this license agreement and privacy policy is required as a condition to proceeding with your download or use of the software.\n\n<div id=\"privacy-policy-agreement\">\n  <input type=\"checkbox\" id=\"privacy-checkbox\" onclick=\"updatePrivacy(this)\">\n  <label>I agree to the <a href=\"licensing.qmd\">Positron license agreement</a> and <a href=\"https://posit.co/about/privacy-policy/\">Posit Privacy Policy</a>.</label>\n</div>\n:::\n\n<!-- The below R code is used by the _download.html snippet\nto populate the platform-default download button -->\n\n::: {.cell}\n\n:::\n\n\n[Download Positron <span id=\"os-name\"></span>](#){.btn .btn-primary .disabled #download-btn data-version=\"2025\\.12\\.1\\-4\"}\n\n[All Downloads](download.qmd){#all-downloads}\n",
     "supporting": [],
     "filters": [
       "rmarkdown/pagebreak.lua"