Skip to content

docs: add Open Graph and Twitter card meta tags to docs page#32

Open
dmchaledev wants to merge 1 commit into
mainfrom
claude/elegant-edison-savhc1
Open

docs: add Open Graph and Twitter card meta tags to docs page#32
dmchaledev wants to merge 1 commit into
mainfrom
claude/elegant-edison-savhc1

Conversation

@dmchaledev

Copy link
Copy Markdown
Contributor

Summary

The interactive API docs page (docs/index.html) had a <meta name="description"> tag but no social-sharing or canonical metadata. When someone shares https://hailbytes.github.io/hailbytes-api-docs/ on LinkedIn, Slack, X, or Discord, it renders as a bare link with no preview.

Changes:

  • Add og:type, og:site_name, og:title, og:description, og:url (Open Graph — Facebook, LinkedIn, Slack, Discord)
  • Add twitter:card, twitter:title, twitter:description (Twitter/X summary card)
  • Add <link rel="canonical"> pointing to the GitHub Pages URL — prevents duplicate-content penalties if the page is ever mirrored

No functional changes to the Redoc viewer or navigation; purely <head> additions.

Test plan

  • Paste https://hailbytes.github.io/hailbytes-api-docs/ into OpenGraph.xyz or the Twitter Card Validator after the page re-deploys and confirm the preview card shows the correct title and description
  • Verify the CI validation workflow (validate-openapi.yml) still passes — no OpenAPI spec changes were made
  • Confirm the deploy workflow (deploy-docs.yml) copies the updated index.html to _site/ as before

🤖 Generated with Claude Code

https://claude.ai/code/session_01ByPYveekU5QnrTykFFo582


Generated by Claude Code

Adds og:type, og:site_name, og:title, og:description, og:url,
twitter:card, twitter:title, twitter:description, and a canonical
link to docs/index.html. Without these, social shares of the docs
page show a bare link with no preview card.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01ByPYveekU5QnrTykFFo582
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