Skip to content

Conversation

@okdistribute
Copy link
Contributor

@okdistribute okdistribute commented Dec 16, 2025

This PR updates the marketing site to align with new messaging and documentation infrastructure changes. The overall goal is to point developers to the new documentation site and better communicate Iroh's value proposition as a modular, reliable connectivity layer rather than just a p2p solution.

Verification to get ready to merge!

  • Used co-pilot to run through for spellcheck
  • Manually ensured links point to valid documentation pages, but please help double check!
  • Messaging concerns: Are there any technical inaccuracies or positioning concerns with the new copy?
  • User experience: Does the new navigation flow make sense? Any broken user journeys?
  • Do the protocol card links make sense?
  • Is the messaging shift from "p2p" to "modular networking stack" technically accurate and aligned with how we talk about Iroh?

1. Documentation Links Migration

All internal /docs references have been migrated to the external documentation site at https://docs.iroh.computer. This affects:

  • Navigation menus (desktop and mobile)
  • Hero CTAs
  • Footer links
  • Protocol documentation references

2. Messaging Updates

Updated the homepage copy to better reflect the product positioning:

  • Hero headline: "p2p that just works" → "fast, efficient, reliable connections"
  • Hero description: More focused on Iroh as a "modular networking stack" rather than just p2p library
  • Protocol section: Reframed as "Vibrant ecosystem of developers" to emphasize the open-source community
  • Build your own protocol section: Repositioned as "Modular toolkit" to clarify Iroh's flexibility

3. Protocol Page

We see this protocol page as a curated list of protocols that we want to highlight, either on the documentation or otherwise on github or even other documentation sites.

Protocol cards now link directly to their respective documentation pages or repositories instead of internal /proto/[slug] pages. This gets developers more quickly directed to the source material so they can start building apps using the protocols listed as well as discover new protocols and the rest of the documentation.

@vercel
Copy link

vercel bot commented Dec 16, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
iroh-computer Ready Ready Preview, Comment Jan 7, 2026 6:03pm

@okdistribute okdistribute marked this pull request as ready for review December 16, 2025 00:35
@n0bot n0bot bot added this to iroh Dec 16, 2025
@github-project-automation github-project-automation bot moved this to 🏗 In progress in iroh Dec 16, 2025
@okdistribute okdistribute requested a review from b5 December 16, 2025 20:12
@flub
Copy link
Contributor

flub commented Jan 7, 2026

on https://docs.iroh.computer/protocols/using-quic there is:

iroh uses a fork of Quinn, a pure-Rust implementation of QUIC maintained by the n0 team. Quinn is production-ready, actively maintained, and used by projects beyond iroh. If you need lower-level QUIC access or want to understand the implementation details, check out the Quinn documentation.

I'm not sure how much the last sentence makes sense. All the relevant quinn types are also available directly on the iroh crate docs. With equally detailed docs, but with some inaccessible things removed.

Copy link
Contributor

@flub flub left a comment

Choose a reason for hiding this comment

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

lgtm!

@dignifiedquire
Copy link
Contributor

Screenshot 2026-01-07 at 12 04 20

it is very confusing, but both main CTAs on the landing page redirect away from the page, but to different places, can we simplify this to single CTA maybe?

@dignifiedquire
Copy link
Contributor

What about removing the existing/old docs from this repo? it would be nice to not have so much unused stuff in this repo

Copy link
Member

@matheus23 matheus23 left a comment

Choose a reason for hiding this comment

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

Good stuff

Thank you for all the redirects!

@okdistribute
Copy link
Contributor Author

@b5 and i were talking today about updating the language to include more numbers & making the use cases more up front, i'll do that in a next pass in a different PR since this push was mostly about getting the docs site shipped. Thanks for all your review!

@okdistribute okdistribute merged commit e7e6bef into main Jan 7, 2026
4 checks passed
@github-project-automation github-project-automation bot moved this from 🏗 In progress to ✅ Done in iroh Jan 7, 2026
@okdistribute okdistribute deleted the rae/docs-v2 branch January 7, 2026 18:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: ✅ Done

Development

Successfully merging this pull request may close these issues.

5 participants