Merge remote-tracking branch 'upstream/main'

Author: softhack007

AGENTS.md

@@ -101,7 +101,7 @@ When reviewing a pull request, verify the following:
 
 - [ ] Front matter block (`---`) is present and includes a `title` field.
 - [ ] Page title in front matter matches the entry in `mkdocs.yml`.
-- [ ] Heading hierarchy is correct (`#` (optional) → `##` → `###` → `####`, no skipping levels).
+- [ ] Heading hierarchy is correct (`##` → `###` → `####`, no skipping levels).
 - [ ] Admonitions use the correct type (`info`, `tip`, `warning`, `danger`) for the context.
 - [ ] Tables are properly formatted with pipe characters.
 - [ ] Code blocks use language identifiers.
@@ -110,7 +110,7 @@ When reviewing a pull request, verify the following:
 ### Writing Style & Readability
 
 - [ ] Tone is **informal, friendly, and inviting** — avoid overly formal or academic language.
-- [ ] Title case: Use title case for section and subsection headings; articles and short prepositions stay lowercase.
+- [ ] Title case: Use title case for page title and section headings; articles and short prepositions stay lowercase.
 - [ ] Language is **simple and clear** — short sentences, common words, no unexplained jargon — so non-native English speakers can easily follow.
 - [ ] Logic is easy to follow, examples are kept simple.
 - [ ] Claim calibration: Calibrate verbs to evidence; do not write "proves" when the evidence is "suggests".