docs: add obsolete article banner usage to workflow guiderelease_29042026-1232

1 files changed, 17 insertions, 0 deletions

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