From 3f3397ed83a8594ba752f3fbd1e2ab788290e3c5 Mon Sep 17 00:00:00 2001 From: Alfredo Di Stasio Date: Mon, 6 Jul 2026 15:00:03 +0200 Subject: [PATCH] Aggiunte convenzioni sui titoli Markdown --- il_valore_di_un_ricordo/README.md | 36 +++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/il_valore_di_un_ricordo/README.md b/il_valore_di_un_ricordo/README.md index 0356204..9084490 100644 --- a/il_valore_di_un_ricordo/README.md +++ b/il_valore_di_un_ricordo/README.md @@ -188,10 +188,46 @@ Questo permette di distinguere chiaramente ciò che è ancora in discussione da ## Convenzioni +### Convenzioni - Titoli Markdown + Ogni file Markdown deve contenere un solo titolo di primo livello (`#`), corrispondente al titolo del documento. Le sezioni principali utilizzano titoli di secondo livello (`##`), mentre le sottosezioni utilizzano titoli di terzo livello (`###`). +Ogni titolo deve essere univoco all'interno dello stesso file. + +Nei documenti strutturati con sezioni ripetute, i titoli ricorrenti devono essere contestualizzati. + +Esempio consigliato: + +```markdown +## Titolo della campagna + +### Titolo della campagna - Decisione + +### Titolo della campagna - Motivazione + +### Titolo della campagna - Conseguenze +``` + +Esempio da evitare: + +```markdown +## Titolo della campagna + +### Decisione + +## Struttura della campagna + +### Decisione +``` + +Questa convenzione evita errori dei linter Markdown e rende più chiari gli anchor link generati da Git, editor e visualizzatori Markdown. + +--- + +### Convenzioni - Struttura dei documenti + La struttura consigliata per ogni documento è la seguente: ```markdown