From f6cb4ad6c7372bdab9e09bb2957df104da6be5a5 Mon Sep 17 00:00:00 2001
From: Michael Beck <ich@mbeck.cologne>
Date: Thu, 2 Jul 2026 08:12:29 +0000
Subject: [PATCH] Update README.md

---
 README.md | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index f0c9576..ea6ff39 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,13 @@ Make sure that Quarto, Task and Python are on your PATH.
 
 ## How to use
 
-Clone the repo and edit `*.qmd` files, update author information in `resources/author_profiles/_quarto-default.yml` include references in `resources/references.bib` and render all projects using `task finalize`. 
+Clone the repo:
+
+```bash
+git clone https://git.mbeck.cologne/mischbeck/ScientificManuscriptTemplate
+```
+
+Edit `*.qmd` files, update author information in `resources/author_profiles/_quarto-default.yml` include references in `resources/references.bib` and render all projects using `task finalize`. 
 
 In any arch-based Linux distro, run `go-task finalize` instead.
 
@@ -21,7 +27,7 @@ More on how to include more detail in the front matter can be found in the offic
 
 ## Project layout
 
-Each of `Manuscript/`, `ResearchReport/`, and `Supplements/` is its own Quarto project with its own `_quarto.yml`, `index.qmd`, `data/`, and `figures/` folders.
+Each of `Manuscript/`, `ResearchReport/`, and `Supplements/` contains a Quarto project with its own `_quarto.yml`, `index.qmd`, `data/`, and `figures/` folders.
 
 ```
 ScientificManuscriptTemplate/
@@ -55,7 +61,7 @@ Each project has its own profile pair - `default` (real author info) and `anonym
 
 **Render one project**, from inside that project's folder:
 
-```
+```bash
 cd Manuscript
 task render              # default profile, all formats
 task render:anonymized   # anonymized profile, all formats
@@ -67,7 +73,7 @@ task render:jats
 
 **Or run any project's task from the repo root**, using its namespace:
 
-```
+```bash
 task manuscript:render
 task researchreport:render:anonymized
 task supplements:render:docx
@@ -75,14 +81,14 @@ task supplements:render:docx
 
 **Render everything at once**, from the repo root:
 
-```
+```bash
 task render:all              # all three projects, default profile
 task render:all:anonymized   # all three projects, anonymized profile
 ```
 
 ## Packaging and finalizing
 
-```
+```bash
 task manuscript:package          # zip Manuscript's default output
 task manuscript:package:data     # zip Manuscript/data into data.zip
 task package:all                 # package every project, both profiles, plus data
@@ -97,7 +103,7 @@ task finalize                    # render everything, package everything,
 > [!WARNING]
 > Be careful using this: the command also cleans caches, meaning that all computations will have to be re-evaluated. 
 
-```
+```bash
 task manuscript:clean   # remove Manuscript's _output, .quarto, and stray cache folders
 task clean:all          # same, for all three projects
 ```
\ No newline at end of file