Merge pull request #12 from n0-computer/b5/moar_kubo_compat_notes

add kubo compat notes

Author: b5

content/docs/iroh-and-kubo/_index.md

@@ -6,9 +6,36 @@ template="docs/page.html"
 section="iroh"
 +++
 
-# Kubo Command Comparison
+# Feature Support
 
-[kubo](https://github.com/ipfs/kubo) is the reference implementation for the IPFS protocol. The following table maps commands within kubo to their corresponding support in iroh flavors:
+[Iroh](https://iroh.computer) & [Kubo](https://docs.ipfs.tech) (formerly go-ipfs) are both implementations of [IPFS](https://ipfs.io).
+
+|  | Kubo | Iroh |
+| --- | --- | --- |
+| Language | go | rust |
+| License | dual MIT/Apache-2.0 | dual MIT/Apache-2.0 |
+| Project Start | Feb 2015 | April 2022 |
+
+[kubo](https://github.com/ipfs/kubo) is the reference implementation for the IPFS protocol. Iroh doesn’t aim to implement all features that kubo supports. Instead iroh focuses on the most-used parts of the protocol that can be integrated into a performance sensitive context.
+
+# Hash compatibility
+
+UnixFS content created with kubo can be read by iroh, and vice versa. However, **content added to Iroh will not output the same hash as the same content created with kubo.** This is because Iroh uses different defaults for adding content.
+
+# HTTP Gateway
+
+What started as the [Kubo HTTP Gateway](https://docs.ipfs.tech/reference/http/gateway/) has been codified into a [specification](https://github.com/ipfs/specs/tree/main/http-gateways) which both iroh and kubo support. Iroh has the following caveats:
+
+- iroh does not yet support [subdomain gateways](https://github.com/ipfs/specs/blob/main/http-gateways/SUBDOMAIN_GATEWAY.md)
+- HTML templates for items like UnixFS directories will differ when rendered with iroh
+
+# Kubo RPC API
+
+The [Kubo RPC API](https://docs.ipfs.tech/reference/kubo/rpc/) provides an HTTP an interface for controlling a kubo node. Iroh does not have the same API and instead uses the `iroh` command line client to issue requests that control iroh services.
+
+# Detailed command comparison
+
+The following table maps commands within kubo to their corresponding support in iroh:
 
 <div>
   <div id="commands_table"></div>