Revision control
+ # R58 (skill-language-style): a module landing page ({module}-index.qdoc)
+ # must include an Examples section and a Reference section. Modeled directly
+ # on styles/QtSelectors/PageOverview.yml's proven pattern: an `occurrence`
+ # rule with `min: 1` on a `doc(section:has(> h2:contains("...")))` selector
+ # reports once per file, at 1:1, if the required section is absent.
+ # Verified: fires on a page missing the section, stays silent on one that
+ # has it (see styles/Qt/Structure/README.md).
+ #
+ # `:contains()` is case-insensitive and matches substrings (see
+ # SectionSubtree.yml's own warning), so a heading like "Example Gallery"
+ # also satisfies "Examples" -- an accepted false-negative-avoidance
+ # trade-off, not a bug.
+ # APPLICABILITY: this is a whole-file presence check, scoped in
+ # .vale-qdoc.ini to a [*-index.qdoc] section, not the general [*.{qdoc,...}]
+ # section, so it only applies to {module}-index.qdoc files -- the real Qt
+ # filename convention for module landing pages (verified against
+ # qtwidgets-index.qdoc, qtcore-index.qdoc, qtxml-index.qdoc in qtbase/qtdeclarative).
+ extends: occurrence
+ message: "This page has no Examples section (see R58)."
+ link: https://doc.qt.io/qt-6/qdoc-guide-writing.html
+ level: warning
+ scope: 'doc(section:has(> h2:contains("Examples")))'
+ token: '(?s).'
+ min: 1