Skip to content

docs: convert tech-debt audit to AsciiDoc (last Estate Rules blocker) - #25

Merged
hyperpolymath merged 1 commit into
mainfrom
fix/asciidoc-tech-debt-doc
Jul 27, 2026
Merged

docs: convert tech-debt audit to AsciiDoc (last Estate Rules blocker)#25
hyperpolymath merged 1 commit into
mainfrom
fix/asciidoc-tech-debt-doc

Conversation

@hyperpolymath

Copy link
Copy Markdown
Owner

Estate Rules stayed red on main after the CI-blocker PRs merged. The failing step was AsciiDoc-by-default, on one file: docs/tech-debt-2026-05-26.md.

Converted to .adoc rather than allowlisted — it is ordinary documentation, so the estate rule applies with no justification available. Content preserved verbatim; only markup changed.

Verified locally on main:

check-no-md-in-docs.sh  clean -> exit 0   with probe .md -> exit 1
check-root-shape.sh     clean -> exit 0

Gate red-teamed both directions, so this is not a fake pass.

🤖 Generated with Claude Code

Estate Rules was still red on main after the CI-blocker PRs landed. Root-shape
passes; the failing step was the AsciiDoc-by-default gate, on a single file:
docs/tech-debt-2026-05-26.md.

Converted to .adoc rather than allowlisted -- the estate rule is AsciiDoc by
default and this is ordinary documentation, so there is no justification to add.
Content preserved verbatim (headings, tables, code block, links, SPDX header);
only the markup changed. CC-BY-SA-4.0 header retained, correct for docs.

Verified locally on main: check-no-md-in-docs.sh exits 0, and still exits 1 when
a probe .md is dropped under docs/ -- the gate can still fail. check-root-shape.sh
also exits 0.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@sonarqubecloud

Copy link
Copy Markdown

@gitar-bot

gitar-bot Bot commented Jul 27, 2026

Copy link
Copy Markdown
Code Review ✅ Approved

Converts the tech-debt audit document from Markdown to AsciiDoc to satisfy the estate rules CI check. No issues found.

Auto-approved: No blocking issues found.
Please see Auto-approve Docs for details on setting custom approval criteria.

Options

Auto-apply is off → Gitar will not commit updates to this branch.
Display: compact → Showing less information.

Comment with these commands to change the behavior for this request:

Auto-apply Compact
gitar auto-apply:on         
gitar display:verbose         

Was this helpful? React with 👍 / 👎 | Gitar

@gitar-bot gitar-bot Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Gitar has auto-approved this PR (configure)

hyperpolymath added a commit to hyperpolymath/recon-silly-ation that referenced this pull request Jul 27, 2026
…#22)

Same fix as hyperpolymath/bitfuckit#25 — this file is a template
sibling.

Estate Rules' residual failure on `main` was the AsciiDoc-by-default
step on `docs/tech-debt-2026-05-26.md`. Converted to `.adoc` rather than
allowlisted; content preserved verbatim.

**Verified locally:** `check-no-md-in-docs.sh` exits 0 clean / 1 with a
probe `.md`; `check-root-shape.sh` exits 0.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
@hyperpolymath
hyperpolymath merged commit dd8643b into main Jul 27, 2026
43 checks passed
@hyperpolymath
hyperpolymath deleted the fix/asciidoc-tech-debt-doc branch July 27, 2026 21:09
hyperpolymath added a commit to hyperpolymath/contractiles that referenced this pull request Jul 27, 2026
…#24)

Same fix as hyperpolymath/bitfuckit#25 — this file is a template
sibling.

Estate Rules' residual failure on `main` was the AsciiDoc-by-default
step on `docs/tech-debt-2026-05-26.md`. Converted to `.adoc` rather than
allowlisted; content preserved verbatim.

**Verified locally:** `check-no-md-in-docs.sh` exits 0 clean / 1 with a
probe `.md`; `check-root-shape.sh` exits 0.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant