From: Danilo M. <redacted>
Date: Wed, 29 Apr 2026 10:32:30 +0000 (+0200)
Subject: docs: add obsolete article banner usage to workflow guide
X-Git-Tag: release_29042026-1232
X-Git-Url: https://git.danix.xyz/?a=commitdiff_plain;h=9c50525b7ecf4f93e057ecbe162ea818b105319e;p=danix.xyz-2.git

docs: add obsolete article banner usage to workflow guide
---

diff --git a/WORKFLOW.md b/WORKFLOW.md
index f8e6fee..c95141f 100644
--- a/WORKFLOW.md
+++ b/WORKFLOW.md
@@ -66,6 +66,23 @@ git commit -m "config: ..."
 git push origin master
 ```
 
+### Mark an article as obsolete
+
+Add `obsolete = true` to the article's front matter. Optionally link to a successor article with `successor = "/path/to/article"`:
+
+```toml
++++
+title = "My Old Article"
+# ... other fields ...
+obsolete = true
+successor = "/articles/my-new-article"
++++
+```
+
+The banner appears automatically below the article header. If `successor` is set, it resolves the article title and links to it. Both EN and IT i18n strings are customizable in `i18n/en.yaml` and `i18n/it.yaml`.
+
+Paths are Hugo permalinks — for English articles, use `/articles/slug`, not `/en/articles/slug`.
+
 ---
 
 ## Working on the Theme