add intro & what is iroh

Author: okdistribute

index.mdx

@@ -13,41 +13,42 @@ description: "iroh establishes direct peer-to-peer connections whenever possible
   href="/quickstart"
   horizontal
 >
-  Follow our three step quickstart guide.
+  Follow our quickstart guide.
 </Card>
 
 ## Make it yours
 
-Design your protocols to fit your needs.
+Add the protocols and topologies to fit your needs. Iroh is modular and
+composable, so you can pick and choose what you need.
 
 <Columns cols={2}>
   <Card
-    title="Edit locally"
-    icon="pen-to-square"
-    href="/development"
+    title="Blobs protocol"
+    icon="image"
+    href="/protocols/blobs"
   >
-    Edit your docs locally and preview them in real time.
+    Store and transfer large binary files peer-to-peer.
   </Card>
   <Card
-    title="Customize your site"
-    icon="palette"
-    href="/essentials/settings"
+    title="Key-Value CRDTs"
+    icon="computer"
+    href="/protocols/kv-crdts"
   >
-    Customize the design and colors of your site to match your brand.
+    Collaborative key-value store with conflict-free replication.
   </Card>
     <Card
-    title="Set up navigation"
-    icon="map"
-    href="/essentials/navigation"
+    title="Streaming"
+    icon="video"
+    href="/protocols/streaming"
   >
-    Organize your docs to help users find what they need and succeed with your product.
+    Build low-latency peer-to-peer audio and video streaming applications.
   </Card>
   <Card
     title="API documentation"
     icon="terminal"
-    href="/api-reference/introduction"
+    href="https://docs.rs/iroh"
   >
-    Auto-generate API documentation from OpenAPI specifications.
+    Explore the full iroh Rust API documentation.
   </Card>
 </Columns>
 

what-is-iroh.mdx

@@ -1,3 +1,36 @@
 ---
 title: "What is iroh?"
 ---
+
+iroh is a modular peer-to-peer networking stack written in Rust. It provides
+the building blocks to create decentralized applications that can communicate
+securely and efficiently over the internet.
+
+## Core features
+- **Peer-to-peer connectivity**: iroh enables direct connections between
+  devices, allowing them to communicate without relying on centralized servers.
+  It uses relay servers as a fallback when direct connections are not possible.
+- **Secure communication**: All connections established through iroh are
+  authenticated and encrypted end-to-end using the QUIC protocol, ensuring data
+  privacy and integrity.
+- **Modular protocols**: iroh is built around a system of composable protocols
+  that can be mixed and matched to suit the needs of different applications. This
+  allows developers to easily add functionality such as file sharing, messaging,
+  and real-time collaboration.
+
+## Use cases
+- **Decentralized applications**: iroh provides the networking foundation for
+  building decentralized applications that can operate without central servers.
+- **File sharing**: With protocols like iroh-blobs, iroh enables efficient
+  peer-to-peer file sharing.
+- **Real-time collaboration**: iroh's support for flexible data protocols allows
+developers to build applications that support real-time collaborative editing
+and data synchronization. Any kind of CRDT or OT sync protocol can be integrated.
+
+## Getting started
+To get started with iroh, check out the [quickstart guide](/quickstart) or explore the
+[protocols documentation](/protocols) to see what protocols are available and
+how to use them in your applications.
+
+Read the [how it works documentation](/concepts) to understand the underlying
+principles and architecture of iroh.