Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@scripts/docs/gen_index.py`:
- Around line 39-77: The gfm_to_mkdocs function is flagged for high cognitive
complexity; refactor by extracting subroutines: create
parse_admonition_header(lines, i) to detect and return (note_type, new_index)
using GFM_MKDOCS_MAPPING, parse_title_line(lines, i) to return (title,
new_index) when matching the bold title pattern, and
parse_admonition_body(lines, i) to collect and return (note_body_lines,
new_index) handling the ">" trimming logic, then have gfm_to_mkdocs orchestrate
these helpers and call a small assemble_admonition(note_type, title, note_body)
to produce the "!!! ..." and indented body lines; this splits the main while
loop into clear units (functions referenced: gfm_to_mkdocs,
parse_admonition_header, parse_title_line, parse_admonition_body,
assemble_admonition) and will lower cognitive complexity without changing
behavior.

Verify each finding against the current code and only fix it if needed.

Duplicate comments:
In `@scripts/docs/gen_index.py`:
- Around line 61-64: Combine the nested ifs into one condition using the walrus
operator: replace the outer check "if i < len(lines)" and the inner "if match :=
re.match(..., lines[i])" with a single conditional that both verifies the index
and assigns match (e.g., test that i < len(lines) and bind match from re.match
on lines[i] in the same expression); update the block that sets title and
increments i to use the bound match variable (symbols to locate: i, lines,
match, re.match, title).
- Around line 45-81: The gfm_to_mkdocs function (in scripts/docs/gen_index.py)
is too complex; refactor by extracting discrete helpers to parse the admonition
header and body: create a helper like parse_admonition_header(lines, i) that
detects the "> [!TYPE]" line, returns the note_type and the next index, another
helper parse_admonition_title(lines, i) that returns the title (or empty) and
next index by matching the bold title pattern, and a
parse_admonition_body(lines, i) that collects and returns the unprefixed body
lines and the next index; then simplify gfm_to_mkdocs to use these helpers to
produce the "!!! {note_type}{title}" and indented body lines, reducing branching
and cognitive complexity in gfm_to_mkdocs.

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/examples.md`:
- Around line 528-535: The GFM admonition for the Tip block uses the marker
"[!tip]" without an explicit title, which causes ProperDocs to drop the "Tip"
header; update the admonition by adding an explicit title marker (e.g., change
"[!tip]" to "[!tip] Tip") for the block that describes the Holidays object's
language/default_language behavior so the generated docs retain the "Tip"
heading.
- Around line 14-17: The generated GFM admonition "!!! tip" lacks an explicit
title so ProperDocs drops the "Tip" header; update the source admonition so the
callout includes an explicit title marker immediately after the "!!! tip" token
(i.e., add the explicit title string for the tip admonition) so the converted
output preserves the "Tip" title in ProperDocs.