Merge pull request #497 from ipfs/dht

Add IPFS Kademlia DHT Specification

Author: lidel

.gitignore

@@ -1,3 +1,4 @@
 out/
 node_modules/
 super-linter.log
+node_modules/

src/bitswap-protocol.md

@@ -29,7 +29,7 @@ editors:
       name: Protocol Labs
       url: https://protocol.ai/
 tags: ['exchange', 'routing']
-order: 1
+order: 2
 ---
 
 Bitswap is a libp2p data exchange protocol for sending and receiving content

src/ipns/ipns-record.md

@@ -34,6 +34,7 @@ editors:
         name: Protocol Labs
         url: https://protocol.ai/
 xref:
+  - kad-dht
   - ipip-0337
   - ipns-pubsub-router
 tags: ['ipns']
@@ -290,7 +291,7 @@ Once the record is created, it is ready to be spread through the network. This w
 
 The means of distribution are left unspecified. Implementations MAY choose to
 publish signed record using multiple routing systems, such as
-[libp2p Kademlia DHT](https://github.com/libp2p/specs/tree/master/kad-dht) or :cite[ipns-pubsub-router] (see [Routing record](#routing-record)).
+:cite[kad-dht] or :cite[ipns-pubsub-router] (see [Routing record](#routing-record)).
 
 On the other side, each peer must be able to get a record published by another node. It only needs to have the unique identifier used to publish the record to the network. Taking into account the routing system being used, we may obtain a set of occurrences of the record from the network. In this case, records can be compared using the sequence number, in order to obtain the most recent one.
 
@@ -474,7 +475,11 @@ Note: Base32 according to the :cite[rfc4648].
 #### Routing Record
 
 The routing record is spread across the network according to the available routing systems.
-The two routing systems currently available in IPFS are the [libp2p Kademlia DHT](https://github.com/libp2p/specs/tree/master/kad-dht) and :cite[ipns-pubsub-router].
+The two routing systems currently available in IPFS are the :cite[kad-dht] and :cite[ipns-pubsub-router].
+
+When using :cite[kad-dht] for routing, implementations SHOULD follow the retrieval strategies
+documented in the IPFS Kademlia DHT specification, including the recommended quorum value
+for IPNS record lookups.
 
 **Key format:** `/ipns/BINARY_ID`
 

src/routing/http-routing-v1.md

@@ -51,7 +51,7 @@ thanks:
 xref:
   - ipip-0337
   - ipns-record
-order: 0
+order: 3
 tags: ['routing']
 ---