Skip to content

Conversation

@jevansnyc
Copy link
Collaborator

Summary

This PR adds comprehensive documentation to the VitePress site including:

  • Roadmap page organized by GitHub Initiatives
  • Business Value page with 12 ROI-focused use cases
  • Partner Integrations section with 8 integration guides

Changes

New Pages (11 files)

Top-Level Documentation:

  • /roadmap.md - 2026 roadmap with quarterly timeline
  • /business-use-cases.md - Business value and ROI calculations (18.4x ROI example)

Integration Guides (8 pages):

  • Lockr - Identity management (production)
  • Didomi - CMP integration (production)
  • Permutive - Audience data platform (production)
  • Prebid - Header bidding (production)
  • Next.js - Framework support (production)
  • GAM - Google Ad Manager (planned 2026)
  • APS - Amazon Publisher Services (planned 2026)
  • Kargo - SSP integration (in development)

Navigation Updates

Top Navigation:

  • Added "Business Value" menu item
  • Added "Roadmap" menu item

Sidebar:

  • Added "Partner Integrations" section at bottom
  • Organized by taxonomy:
    • Identity: Lockr
    • CMP: Didomi
    • Data: Permutive
    • Ad Serving: GAM
    • Demand Wrapper: Prebid, APS
    • SSP: Kargo
    • Framework Support: Next.js

Content Highlights

Roadmap

  • Organized by 3 GitHub Initiatives (Edge Platform, Monetization, Transaction Trust)
  • Includes in-flight and 2026 planned features
  • Quarterly timeline (Q1-Q4 2026)

Integration Guides

  • Production integrations have comprehensive docs (Lockr, Didomi, Prebid, Next.js)
  • Planned integrations have placeholder pages with roadmap status
  • Each guide includes: configuration, use cases, implementation details

Testing

  • VitePress builds successfully
  • All navigation links work
  • Sidebar structure renders correctly
  • Pages render with proper formatting
  • Local dev server tested at http://localhost:5173/trusted-server/

Preview

You can preview the changes by running:

cd docs
npm run dev

Then visit:

Next Steps

After this PR merges, suggested follow-ups:

  1. Expand placeholder integration pages (GAM, APS, Kargo) as development progresses
  2. Add screenshots/diagrams to integration guides
  3. Update existing guide pages with more detailed examples (separate PR)

Checklist

  • Documentation follows style guide
  • All links are valid
  • Spelling and grammar checked
  • Business language (not overly technical)
  • VitePress config updated
  • No breaking changes to existing docs

… Integrations

Documentation Additions:
- Roadmap page organized by GitHub Initiatives (Edge Platform, Monetization, Transaction Trust)
- Business Use Cases page with 12 detailed ROI scenarios
- Partner Integrations section with 8 integration guides

New Pages:
- /roadmap.md - 2026 roadmap with quarterly timeline
- /business-use-cases.md - Business value and ROI calculations
- /guide/integrations/lockr.md - Identity management (production)
- /guide/integrations/didomi.md - CMP integration (production)
- /guide/integrations/permutive.md - Audience data platform (production)
- /guide/integrations/prebid.md - Header bidding (production)
- /guide/integrations/nextjs.md - Framework support (production)
- /guide/integrations/gam.md - Ad serving (planned 2026)
- /guide/integrations/aps.md - Amazon demand (planned 2026)
- /guide/integrations/kargo.md - SSP integration (in development)

Navigation Updates:
- Added "Business Value" to top navigation
- Added "Roadmap" to top navigation
- Added "Partner Integrations" sidebar section with taxonomy:
  - Identity: Lockr
  - CMP: Didomi
  - Data: Permutive
  - Ad Serving: GAM
  - Demand Wrapper: Prebid, APS
  - SSP: Kargo
  - Framework Support: Next.js

Business Impact:
- Comprehensive business use cases showing 18.4x ROI for mid-sized publishers
- Clear product roadmap aligned with GitHub initiatives
- Detailed integration guides for partners and developers
Copy link
Collaborator

@aram356 aram356 left a comment

Choose a reason for hiding this comment

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

👍 Looks good.

I will will resolve after # #159 after we merge this

@aram356 aram356 merged commit 23adc24 into main Jan 20, 2026
4 checks passed
@aram356 aram356 deleted the feature/docs-roadmap-integrations-usecases branch January 20, 2026 17:28
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.

Review and fix Trusted Server documentation

3 participants