diff --git a/themes/chosto/archetypes/section.md b/themes/chosto/archetypes/section.md
index 147f846..85b641f 100644
--- a/themes/chosto/archetypes/section.md
+++ b/themes/chosto/archetypes/section.md
@@ -4,4 +4,4 @@ subtitle:
code:
draft: true
---
-
+{{/* We use sections to define "cases", i.e. serie of articles about a topic */}}
diff --git a/themes/chosto/layouts/_default/_markup/render-heading.html b/themes/chosto/layouts/_default/_markup/render-heading.html
index 6ece32d..aa53e92 100644
--- a/themes/chosto/layouts/_default/_markup/render-heading.html
+++ b/themes/chosto/layouts/_default/_markup/render-heading.html
@@ -1,2 +1,2 @@
-
+{{/* Overwrite default title rendering to add anchor */}}
{{ .Text | safeHTML }} ¶
\ No newline at end of file
diff --git a/themes/chosto/layouts/_default/list.html b/themes/chosto/layouts/_default/list.html
index d1a1fe0..7364cc7 100644
--- a/themes/chosto/layouts/_default/list.html
+++ b/themes/chosto/layouts/_default/list.html
@@ -1,13 +1,13 @@
{{ define "main" }}
-
+{{/* Default list used for homepage and taxonomy pages (e.g. tags),
+ but not for sections (see section.html template) */}}