Skip to content

feat: improve project discoverability, sharing mechanics, and social proof #193

@vmorps

Description

@vmorps

Overview

OpenTDF.io has an opportunity to meaningfully improve how developers discover, evaluate, and share the project. This issue tracks a set of targeted improvements across the documentation site, the GitHub repo itself, and key SEO touch points.

Tasks

GitHub repo visibility

  • Update the GitHub repo social preview image (Settings → Social Preview) to match the new brand — this is what appears when the GitHub repo URL is shared on LinkedIn, Slack, or Twitter/X, and currently shows the old branding
  • Refresh README.md with new messaging, updated hero image, and a prominent link to opentdf.io

Social proof on the homepage

  • Add a live GitHub star count or star badge to the homepage — one of the highest-signal trust indicators for developers evaluating an open source project
  • Consider a "Used by" or adopter acknowledgment section if known organizations can be referenced

SEO & structured data

  • Verify and review the auto-generated /sitemap.xml; submit to Google Search Console
  • Add curated description frontmatter to high-value doc pages (Introduction, Quickstart, SDKs) to improve search result click-through rates over auto-generated descriptions
  • Expand Schema.org structured data beyond the current organization entry — add SoftwareApplication or TechArticle schema to key pages to improve how Google surfaces the project in search results

Sharing mechanics within the site

  • Add "Discuss on GitHub" links to documentation pages, linking to GitHub Discussions — encourages community engagement at the moment a developer is most actively reading docs
  • Confirm copy-to-clipboard is active on all code samples (reduces friction when developers share specific examples)

Acceptance criteria

  • GitHub repo social preview shows new brand when URL is shared on social platforms
  • README reflects current messaging and links to opentdf.io
  • GitHub star count is visible on the homepage
  • /sitemap.xml is verified and submitted to Google Search Console
  • Key doc pages have curated meta descriptions
  • Documentation pages link to GitHub Discussions

🤖 Generated with Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions