Skip to content

Add H1s to Ahrefs-flagged docs pages#689

Closed
danstotts-ops wants to merge 1 commit into
mainfrom
fix/ahrefs-missing-h1-docs
Closed

Add H1s to Ahrefs-flagged docs pages#689
danstotts-ops wants to merge 1 commit into
mainfrom
fix/ahrefs-missing-h1-docs

Conversation

@danstotts-ops

Copy link
Copy Markdown
Contributor

Summary

  • Adds explicit page-level H1s to the seven docs pages currently flagged in Ahrefs for missing H1 tags.
  • Uses descriptive headings for generic overview pages, for example Runpod CLI and Serverless workers.

Validation

  • node scripts/validate-tooltips.js
  • git diff --check

Ahrefs context

Issue: missing H1 tags from project 3648513, issue c64d9d0b-d0f4-11e7-8ed1-001e67ed4656.

@mintlify

mintlify Bot commented Jul 2, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
runpod-docs 🟢 Ready View Preview Jul 2, 2026, 11:09 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@danstotts-ops

Copy link
Copy Markdown
Contributor Author

Context for review: Ahrefs flagged these seven docs URLs for missing H1 tags. This PR only adds explicit page-level H1s, with descriptive headings where the existing title was generic. Local and GitHub tooltip validation passed.

@danstotts-ops

Copy link
Copy Markdown
Contributor Author

Review routing update: the older README reviewer no longer has write access, so I requested review from @lavanya-gunreddi based on recent docs PR ownership and write access. This is still only the seven Ahrefs H1 inserts.

@lavanya-gunreddi lavanya-gunreddi left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Hi Dan, I don't understand these changes. Did you go through the changes in the preview links. The headings are appearing twice.

@lavanya-gunreddi lavanya-gunreddi left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

image.png

image.png

Copy link
Copy Markdown
Contributor

Let us review it together next week.

@danstotts-ops

Copy link
Copy Markdown
Contributor Author

Lavanya is right: this PR creates duplicate visible headings in the Mintlify preview. I rechecked the seven Ahrefs-flagged docs URLs live, and each now renders exactly one Mintlify-generated H1, so this PR is no longer needed. Closing to avoid introducing duplicate headings.

@danstotts-ops danstotts-ops deleted the fix/ahrefs-missing-h1-docs branch July 3, 2026 01:14
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.

2 participants