chore: move bitswap to exchange/

incl. cosmetic editorials

BITSWAP.md

@@ -1,3 +1,3 @@
 # Bitswap
 
-Moved to https://specs.ipfs.tech/architecture/bitswap/
+Moved to https://specs.ipfs.tech/exchange/bitswap/

src/architecture/bitswap.md → src/exchange/bitswap.md

@@ -1,37 +1,40 @@
 ---
 title: Bitswap
 description: >
-  Bitswap is a data exchange protocol for sending and receiving content addressed
-  blocks of data. It attempts to acquire blocks from the network that have been
-  requested by the client, and also send blocks to others who want them.
+  Bitswap is a libp2p data exchange protocol for sending and receiving content
+  addressed blocks of data. It attempts to acquire blocks from the p2p network
+  that have been requested by the client, and also send blocks to others who
+  want them.
 date: 2022-08-26
 maturity: reliable
 editors:
-  - name: Adin Schmahmann
-    github: aschmahmann
+  - name: Juan Benet
+    github: jbenet
     affiliation:
       name: Protocol Labs
       url: https://protocol.ai/
-  - name: David Dias
-    github: daviddias
+  - name: Jeromy Johnson
+    github: whyrusleeping
     affiliation:
       name: Protocol Labs
       url: https://protocol.ai/
-  - name: Jeromy Johnson
-    github: whyrusleeping
+  - name: David Dias
+    github: daviddias
     affiliation:
       name: Protocol Labs
       url: https://protocol.ai/
-  - name: Juan Benet
-    github: jbenet
+  - name: Adin Schmahmann
+    github: aschmahmann
     affiliation:
       name: Protocol Labs
       url: https://protocol.ai/
-tags: ['architecture']
+tags: ['exchange']
 order: 1
 ---
 
-Bitswap is a data exchange protocol for sending and receiving content addressed blocks of data.
+Bitswap is a libp2p data exchange protocol for sending and receiving content
+addressed blocks of data.
+
 Bitswap has two primary jobs:
 
 1. Attempt to acquire blocks from the network that have been requested by the client.
@@ -238,7 +241,7 @@ message Message {
 
 ## Implementations
 
-- [Boxo Bitswap](https://github.com/ipfs/boxo/tree/main/bitswap)
-- [js-ipfs-bitswap](https://github.com/ipfs/js-ipfs-bitswap)
+- GO: [`boxo/bitswap`](https://github.com/ipfs/boxo/tree/main/bitswap)
+- JS: [js-ipfs-bitswap](https://github.com/ipfs/js-ipfs-bitswap)
 
-[unsigned-varint]: https://github.com/multiformats/unsigned-varint
+[unsigned-varint]: https://github.com/multiformats/unsigned-varint

src/exchange/index.html

@@ -0,0 +1,13 @@
+---
+title: Exchange
+description: |
+  Exchange is the way to for sending and receiving content addressed blocks of data.
+---
+
+{% include 'header.html' %}
+
+<main>
+  {% include 'list.html', posts: collections.exchange %}
+</main>
+
+{% include 'footer.html' %}

src/index.html

@@ -79,6 +79,21 @@ <h3><a href="/meta/">Meta</a></h3>
         </p>
         {% include 'list.html', posts: collections.meta %}
       </section>
+      <section>
+        <h3><a href="/routing/">Routing</a></h3>
+        <p>
+          Routing is the way to determine where to find a given CID, Peer, or IPNS Record on the network;
+          specifically, which network peers provide specific CIDs.
+        </p>
+        {% include 'list.html', posts: collections.routing %}
+      </section>
+      <section>
+        <h3><a href="/exchange/">Exchange</a></h3>
+        <p>
+          Exchange is the way to for sending and receiving content addressed blocks of data.
+        </p>
+        {% include 'list.html', posts: collections.exchange %}
+      </section>
       <section>
         <h3><a href="/http-gateways/">HTTP Gateways</a></h3>
         <p>
@@ -94,14 +109,6 @@ <h3><a href="/ipns/">InterPlanetary Naming System</a></h3>
         </p>
         {% include 'list.html', posts: collections.ipns %}
       </section>
-      <section>
-        <h3><a href="/routing/">Routing</a></h3>
-        <p>
-          Content routing is the way to determine where to find a given CID on the network;
-          specifically, which network peers provide specific CIDs. 
-        </p>
-        {% include 'list.html', posts: collections.routing %}
-      </section>
       <section>
         <h3><a href="/ipips/">InterPlanetary Improvement Proposals</a></h3>
         <p>

src/routing/index.html

@@ -1,8 +1,8 @@
 ---
 title: Routing
 description: |
-  Content routing is the way to determine where to find a given CID on the network;
-  specifically, which network peers provide specific CIDs. 
+  Routing is the way to determine where to find a given CID, Peer, or IPNS Record on the network;
+  specifically, which network peers provide specific CIDs.
 ---
 
 {% include 'header.html' %}