Skip to content

Fix new Ahrefs audit issues: Discord redirect link and CLI reference meta descriptions - #53

Merged
flybayer merged 2 commits into
mainfrom
devin/1786662287-ahrefs-audit-fixes
Aug 14, 2026
Merged

Fix new Ahrefs audit issues: Discord redirect link and CLI reference meta descriptions#53
flybayer merged 2 commits into
mainfrom
devin/1786662287-ahrefs-audit-fixes

Conversation

@devin-ai-integration

@devin-ai-integration devin-ai-integration Bot commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Summary

Fixes two issues newly flagged in the 2026-08-13 Ahrefs crawl.

External redirect links (+145 new, 235 occurrences of one URL). https://discord.gg/pfP3ysX5m 301-redirects to https://discord.com/invite/pfP3ysX5m; every page inherits the link via docs.json navigation, so it dominated the report. Both the navigation entry and the contact-support link now point at the final URL.

Short meta descriptions on cli/reference/certificate.mdx (19 chars) and cli/reference/domain.mdx (14 chars): they fell back to the Cobra Short string. Regenerated from the CLI generator after adding seoDescriptions entries in ravionhq/flightcontrol#6941, then scripts/sync-og-images.mjs re-applied the OG/Twitter image frontmatter the generator does not emit.

Link to Devin session: https://app.devin.ai/sessions/9f22d1560a7344029cbf1702e004338e
Requested by: @flybayer

Greptile Summary

The PR resolves documentation audit findings by replacing a redirecting Discord invite URL with its canonical destination and expanding two CLI reference meta descriptions.

  • Updates both user-facing Discord invite references consistently.
  • Adds descriptive SEO metadata for the certificate and domain CLI reference pages while retaining their social-image metadata.

Confidence Score: 5/5

The PR appears safe to merge with no actionable defects identified in the changed documentation or navigation.

The new descriptions align with the documented CLI capabilities, and every repository reference to the Discord invite consistently uses the canonical destination.

Important Files Changed

Filename Overview
cli/reference/certificate.mdx Expands the certificate command description with capabilities represented by the documented ACM subcommands.
cli/reference/domain.mdx Expands the domain command description with capabilities represented by the documented domain subcommands.
contact-support.mdx Replaces the redirecting Discord short URL with the canonical invite URL.
docs.json Updates the navigation Discord link to the same canonical invite URL.

Reviews (1): Last reviewed commit: "restore og image frontmatter on regenera..." | Re-trigger Greptile

devin-ai-integration Bot and others added 2 commits August 13, 2026 23:06
Co-Authored-By: brandon <brandon@flightcontrol.dev>
Co-Authored-By: brandon <brandon@flightcontrol.dev>
@flybayer flybayer self-assigned this Aug 13, 2026
@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

@mintlify

mintlify Bot commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
Ravion 🟢 Ready View Preview Aug 13, 2026, 11:08 PM

Copy link
Copy Markdown
Member

@devin cli ref docs come form monorepo, are generated fix that and somehow notate this for future agents

@flybayer
flybayer merged commit f61b893 into main Aug 14, 2026
6 checks passed
@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

Re: the CLI reference pages being generated from the monorepo — they are, and that's where the description change was made (the seoDescriptions map in packages/cli/internal/cmdgen/mintlify-docs/main.go), then regenerated with make docs. Two follow-ups, in a new PR since this one is merged:

  • The generator omitted the og:image/twitter:image frontmatter, so every regeneration stripped those tags and someone had to re-run scripts/sync-og-images.mjs afterwards (exactly what happened here). The generator now emits them.
  • Notes for future agents: a filled-in "Content boundaries" section in this repo's AGENTS.md listing the generated paths with the rule to change the source in flightcontrol and regenerate, plus the reverse pointer in packages/cli/AGENTS.md.

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