From 981108e77a305ad19603fe14fe6bef6e5479274f Mon Sep 17 00:00:00 2001
From: Vinzenz Schroeter <vinzenz.f.s@gmail.com>
Date: Sat, 7 Jun 2025 15:35:43 +0200
Subject: [PATCH] update readme, markdown lint

---
 README.md         | 19 ++++++++++++-------
 TODO.md           |  4 +---
 content/_index.md |  2 +-
 3 files changed, 14 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index c657b59..9b54d24 100644
--- a/README.md
+++ b/README.md
@@ -19,15 +19,13 @@ This is the website of the CCCB.
    cd cccb-website
    ```
 
-### Run site locally
+4. Run hugo webserver
 
-Run hugo webserver:
+   ```shell
+   hugo serve
+   ```
 
-```shell
-hugo serve
-```
-
-Point your browser to: <http://localhost:1313/>
+5. Point your browser to: <http://localhost:1313/>
 
 To ready your site for upload, run `./build.sh`, which also generates `all.ics`
 and adds the calendar table to `index.html`.
@@ -46,6 +44,13 @@ as long as `hugo serve` is running.
    - If successfull, check [Website](https://berlin.ccc.de/) if change is correct.
 7. Profit!
 
+## Nix stuff
+
+- After entering the shell with `nix develop`, hugo is available and `hugo serve` should work
+- Python including required packages will be available, so the `build.sh` should work without a venv
+- You can build the staging and production builds with `nix build .#staging-content` and `nix build .#production-content`
+- Do not update the nixpkgs branch - 25.05 contains a newer hugo version that is incompatible with the theme (last checked June 2025)
+
 ---
 
 Made with ❤️ and [Hugo](https://gohugo.io).
diff --git a/TODO.md b/TODO.md
index 10121f4..2d75a8b 100644
--- a/TODO.md
+++ b/TODO.md
@@ -3,9 +3,7 @@
 - DSGVO-compliant Datenschutzerklärung reinbasteln
 - Entscheiden, welche Seiten sonst noch konvertiert werden sollen und welche in die ewigen Datengründe gehen können
 
-
-
-# Done
+## Done
 
 - Template aussuchen
 - Rausfinden, wie man eine Seite konvertiert
diff --git a/content/_index.md b/content/_index.md
index b507cf8..531fa85 100644
--- a/content/_index.md
+++ b/content/_index.md
@@ -23,7 +23,7 @@ description: "Startseite CCCB mit Kurzkalender"
 
 -->
 
-### Nächste Veranstaltungen:
+### Nächste Veranstaltungen
 
 CALENDAR