Merge branch 'master' into productionrelease_29042026-1314

1 files changed, 35 insertions, 0 deletions

diff --git a/WORKFLOW.md b/WORKFLOW.md
index 6743d9d..e7cafd5 100644
--- a/WORKFLOW.md
+++ b/WORKFLOW.md
@@ -76,6 +76,41 @@ 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`.
+
+### Add an external link to the main menu
+
+Add a menu entry in `hugo.toml` with `params.external = true`:
+
+```toml
+[[menus.main]]
+  name = "GitHub"
+  url = "https://github.com/youruser"
+  weight = 10
+  [menus.main.params]
+    external = true
+```
+
+- `name` is used as-is (not looked up in i18n)
+- `url` must be a full URL including scheme
+- `weight` controls order relative to other menu items
+- External links open in a new tab with `rel="noopener noreferrer"` and include a screen-reader-only "(opens in new tab)" label for WCAG 2.1 AA compliance
+
 ---
 
 ## Working on the Theme