This is an automated email from the ASF dual-hosted git repository. spmallette pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/tinkerpop.git
commit d42eaf4eb7ba92ad31a26d08527004c930e81c22 Author: Stephen Mallette <[email protected]> AuthorDate: Mon Jul 20 09:08:30 2026 -0400 Added rule about section title lengths to avoid wrapping CTR --- .skills/tinker-doc/SKILL.md | 5 +++-- .skills/tinker-doc/references/asciidoc-and-wiring.md | 5 +++++ 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/.skills/tinker-doc/SKILL.md b/.skills/tinker-doc/SKILL.md index e510c2f4c1..d09f918d8a 100644 --- a/.skills/tinker-doc/SKILL.md +++ b/.skills/tinker-doc/SKILL.md @@ -108,8 +108,9 @@ blocks — it does not. The authoring details — graph choice, output suppression, `<1>` callouts, and the multi-language story — are in [references/executable-blocks.md](references/executable-blocks.md). AsciiDoc -structure (anchors, cross-references, the `x.y.z` version placeholder, per-book -`index.asciidoc` wiring, admonitions, images) is in +structure (anchors, cross-references, section-title length limits for the TOC, +the `x.y.z` version placeholder, per-book `index.asciidoc` wiring, admonitions, +images) is in [references/asciidoc-and-wiring.md](references/asciidoc-and-wiring.md). ## The semantics document is load-bearing diff --git a/.skills/tinker-doc/references/asciidoc-and-wiring.md b/.skills/tinker-doc/references/asciidoc-and-wiring.md index b69572654d..ae904cf37b 100644 --- a/.skills/tinker-doc/references/asciidoc-and-wiring.md +++ b/.skills/tinker-doc/references/asciidoc-and-wiring.md @@ -36,6 +36,11 @@ This matters most in the upgrade book, which is nearly always talking about reference, provider, or IO material that lives elsewhere. Note that upgrade docs pin a concrete version rather than `x.y.z` — see the exception below. +## Section titles must fit the TOC + +Section titles that publish to the table of contents (the `====` level and above) +must not exceed 30 characters, or they wrap in the fixed-width TOC when published. + ## The `x.y.z` version placeholder Links into version-specific resources use the literal placeholder `x.y.z` in
