lint: add markdown linter (#5254)

docs/introduction/architecture.md

@@ -1,11 +1,13 @@
 # Tendermint Architectural Overview
-_November 2019_
+
+> **November 2019**
 
 Over the next few weeks, @brapse, @marbar3778 and I (@tessr) are having a series of meetings to go over the architecture of Tendermint Core. These are my notes from these meetings, which will either serve as an artifact for onboarding future engineers; or will provide the basis for such a document.
 
 ## Communication
 
 There are three forms of communication (e.g., requests, responses, connections) that can happen in Tendermint Core: *internode communication*, *intranode communication*, and *client communication*. 
+
 - Internode communication: Happens between a node and other peers. This kind of communication happens over TCP or HTTP. More on this below. 
 - Intranode communication: Happens within the node itself (i.e., between reactors or other components). These are typically function or method calls, or occasionally happen through an event bus. 
 - Client communiation: Happens between a client (like a wallet or a browser) and a node on the network.
@@ -13,6 +15,7 @@ There are three forms of communication (e.g., requests, responses, connections)
 ### Internode Communication
 
 Internode communication can happen in two ways:
+
 1. TCP connections through the p2p package
     - Most common form of internode communication
     - Connections between nodes are persisted and shared across reactors, facilitated by the switch. (More on the switch below.)
@@ -24,10 +27,12 @@ Internode communication can happen in two ways:
 ### P2P Business (the Switch, the PEX, and the Address Book)
 
 When writing a p2p service, there are two primary responsibilities:
+
 1. Routing: Who gets which messages?
 2. Peer management: Who can you talk to? What is their state? And how can you do peer discovery? 
 
 The first responsibility is handled by the Switch:
+
 - Responsible for routing connections between peers
 - Notably _only handles TCP connections_; RPC/HTTP is separate
 - Is a dependency for every reactor; all reactors expose a function `setSwitch`
@@ -42,12 +47,14 @@ The second responsibility is handled by a combination of the PEX and the Address
 	TODO: What is the PEX and the Address Book? 
 	
 #### The Nature of TCP, and Introduction to the `mconnection`
-Here are some relevant facts about TCP:
-1. All TCP connections have a "frame window size" which represents the packet size to the "confidence;" i.e., if you are sending packets along a new connection, you must start out with small packets. As the packets are received successfully, you can start to send larger and larger packets. (This curve is illustrated below.) This means that TCP connections are slow to spin up.
-3. The syn/ack process also means that there's a high overhead for small, frequent messages 
-4. Sockets are represented by file descriptors.
 
-![](../imgs/tcp-window.png)
+Here are some relevant facts about TCP:
+
+1. All TCP connections have a "frame window size" which represents the packet size to the "confidence;" i.e., if you are sending packets along a new connection, you must start out with small packets. As the packets are received successfully, you can start to send larger and larger packets. (This curve is illustrated below.) This means that TCP connections are slow to spin up.
+2. The syn/ack process also means that there's a high overhead for small, frequent messages 
+3. Sockets are represented by file descriptors.
+
+![tcp](../imgs/tcp-window.png)
 
 In order to have performant TCP connections under the conditions  created in Tendermint, we've created the `mconnection`, or the multiplexing connection. It is our own protocol built on top of TCP. It lets us reuse TCP connections to minimize overhead, and it keeps the window size high by sending auxiliary messages when necessary.
 
@@ -57,22 +64,25 @@ The `mconnection` has two methods: `send`, which takes a raw handle to the socke
 
 The `mconnection` is owned by a peer, which is owned (potentially with many other peers) by a (global) transport, which is owned by the (global) switch: 
 
+<!-- markdownlint-disable -->
 ```
 switch
-	transport
-		peer
-			mconnection
-		peer
-			mconnection
-		peer
-			mconnection	
+  transport
+    peer
+      mconnection
+    peer
+      mconnection
+    peer
+      mconnection	
 ```
+<!-- markdownlint-restore -->
 
 ## node.go 
 
 node.go is the entrypoint for running a node. It sets up reactors, sets up the switch, and registers all the RPC endpoints for a node.
 
 ## Types of Nodes
+
 1. Validator Node: 
 2. Full Node:
 3. Seed Node:
@@ -82,6 +92,7 @@ TODO: Flesh out the differences between the types of nodes and how they're confi
 ## Reactors 
 
 Here are some Reactor Facts: 
+
 - Every reactor holds a pointer to the global switch (set through `SetSwitch()`)
 - The switch holds a pointer to every reactor (`addReactor()`)
 - Every reactor gets set up in node.go (and if you are using custom reactors, this is where you specify that)
@@ -90,6 +101,7 @@ Here are some Reactor Facts:
 - Sometimes reactors talk to each other by fetching references to one another via the switch (which maintains a pointer to each reactor). **Question: Can reactors talk to each other in any other way?**
 
 Furthermore, all reactors expose:
+
 1. A TCP channel
 2. A `receive` method 
 3. An `addReactor` call
@@ -99,6 +111,7 @@ The `receive` method can be called many times by the mconnection. It has the sam
 The `addReactor` call does a for loop over all the channels on the reactor and creates a map of channel IDs->reactors. The switch holds onto this map, and passes it to the _transport_, a thin wrapper around TCP connections.
 
 The following is an exhaustive (?) list of reactors:
+
 - Blockchain Reactor
 - Consensus Reactor 
 - Evidence Reactor 
@@ -108,6 +121,8 @@ The following is an exhaustive (?) list of reactors:
 Each of these will be discussed in more detail later.
 
 ### Blockchain Reactor 
+
 The blockchain reactor has two responsibilities: 
+
 1. Serve blocks at the request of peers 
-2. TODO: learn about the second responsibility of the blockchain reactor 
+2. TODO: learn about the second responsibility of the blockchain reactor