Skip to content

Put Markdown field headings below their section - #1810

Open
shadromani wants to merge 1 commit into
mainfrom
sromani/uhu-3504-field-headings-in-the-markdown-api-reference-sit-one-level
Open

shadromani wants to merge 1 commit into
mainfrom
sromani/uhu-3504-field-headings-in-the-markdown-api-reference-sit-one-level

Conversation

@shadromani

Copy link
Copy Markdown
Contributor

Fixes UHU-3504: https://linear.app/maxmind/issue/UHU-3504/field-headings-in-the-markdown-api-reference-sit-one-level-below-their

The Markdown output wrote every schema field as an H4 heading. On /minfraud/alerts/index.md the table is under #### Parameters, so the fields were siblings of that section, not its children.

  • schema-table takes a headingLevel parameter for the field headings. The default is 4, which is correct for the tables under H3 sections. A value outside 2 to 6 stops the build.
  • The geoip and minFraud row shortcodes pass the level to the row partial.
  • content/minfraud/alerts.md sets headingLevel="5".

Verified with a full build on main and on this branch: all HTML files are identical. In the Markdown, only the 16 field headings on the alerts page change (#### to #####). Lint passes.

Follow-up to the review of #1771 (#1771 (comment)). UHU-3616 adds a build check for the heading levels.

🤖 Generated with Claude Code

The Markdown output wrote each schema field as an H4 heading. On the
minFraud alerts page the table is under an H4 section, so the fields
were siblings of that section, not its children.

Add a headingLevel parameter to schema-table. It sets the level of the
field headings and is 4 by default, which is correct for the tables
under H3 sections. The rows read the level from their table. The alerts
table sets it to 5. A value outside 2 to 6 stops the build.

The HTML output does not change.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 5, 2026 •

Copy link
Copy Markdown

Deploying dev-site with  Cloudflare Pages  Cloudflare Pages

Latest commit: 30b8f2d
Status: ✅  Deploy successful!
Preview URL: https://073e7851.dev-site-4ua.pages.dev
Branch Preview URL: https://sromani-uhu-3504-field-headi.dev-site-4ua.pages.dev

View logs

@coderabbitai

coderabbitai Bot commented Nov 5, 2026

Copy link
Copy Markdown

Important

  • Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: e83b7ca9-42d9-48aa-9c18-7418d55a1653
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Tip

🎯 Customize your risk assessments

Guide how CodeRabbit assesses merge risk and security architecture risk. Highlight sensitive changes and explain your security boundaries using Merge Risk Instructions and Security Risk Instructions in your review settings. Security architecture risk assessments require the Advanced plan or above.

✅ Automatic approvals, with your rules

Let CodeRabbit approve pull requests once required threads are resolved, pre-merge checks pass, and your risk limits are met. Enable Automatic approvals in review settings, with overrides for teams or file paths.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant