From 4d225d7736c595fbcd5b55887e3a5f3f75db8135 Mon Sep 17 00:00:00 2001
From: Aymeric Stamm <aymeric.stamm@cnrs.fr>
Date: Tue, 5 Aug 2025 18:24:08 +0200
Subject: [PATCH] Update instructions in README. Closes README update #52.

---
 README.md | 46 +++++++++++++++++++++++++++-------------------
 1 file changed, 27 insertions(+), 19 deletions(-)

diff --git a/README.md b/README.md
index bdc7e7f..d7c9a90 100644
--- a/README.md
+++ b/README.md
@@ -3,32 +3,40 @@
 
 This repository stores the source of Computorg.
 
-
 ## How to contribute to the website
 
-- Install [quarto](https://quarto.org/docs/get-started/)
+### Quarto
+
+Our website has been built with [Quarto](https://quarto.org), an open-source scientific and technical publishing system. The first thing you need to compile the website is therefore to install Quarto, which can be done by downloading the corresponing installer here: <https://quarto.org/docs/get-started/>.
+
+::: {.callout-note}
+## Positron
+
+If you are using the new [Positron IDE](https://positron.posit.co), quarto is already bundled with it. You can simply type `which quarto` within the built-in terminal in Positron and add the returned path to your `PATH`.
+:::
+
+### Microsoft DotNet SDK
 
-- Install DotNet SDK 8.0
+You need to install Microsoft DotNet SDK which is now v9.0. Installers can be found here: <https://dotnet.microsoft.com/en-us/download>. Otherwise, you can install it on Unix systems via:
 
-    - Linux:
-    ```bash
-    sudo apt-get install dotnet-sdk-8.0
-    ```
-    - macOS:
-    ```bash
-    brew install dotnet
-    ```
+- Linux:
+```bash
+sudo apt-get install dotnet-sdk-9.0
+```
+- macOS:
+```bash
+brew install dotnet
+```
 
-- Create an API key on github (personal access token)
+### GitHub Personal Access Token
 
-    - Go to your settings
-    - Then developer settings
-    - Then create a github token
+You need to connect to your GitHub account. 
 
+- Go under *Settings*, scroll down until you see the *Developer settings* tab on the left sidebar and click on it. Follow the procedure to create a **classic** personal access token (PAT). Give it a name you will remember and remember to copy the PAT before closing the page.
 - Put the token in a file named `.env-secret` in the root of this repository
 
-    ```bash
-    GITHUB_TOKEN=your_github_token
-    ```
+```bash
+GITHUB_TOKEN=your_github_token
+```
 
-- Now, you can compile the website with `quarto render .`
+Now, you can compile the website with `quarto render .`.