cleanup markdown docs across multiple files (#14296)

enable markdown-linter

docs/distributed/DECOMMISSION.md

@@ -1,21 +1,23 @@
-## Decommissioning
+# Decommissioning
 
 Decommissiong is a mechanism in MinIO to drain older pools (usually with old hardware) and migrate the content from such pools to a newer pools (usually better hardware). Decommissioning spreads the data across all pools - for example if you decommission `pool1`, all the data from `pool1` shall be spread across `pool2` and `pool3` respectively.
 
-### Features
+## Features
 
 - A pool in decommission still allows READ access to all its contents, newer WRITEs will be automatically scheduled to only new pools.
 - All versioned buckets maintain the same order for "versions" for each objects after being decommissioned to the newer pools.
 - A pool in decommission resumes from where it was left off (for example - in-case of cluster restarts or restarts attempted after a failed decommission attempt).
 
-### How to decommission a pool?
+## How to decommission a pool?
+
 ```
 λ mc admin decommission start alias/ http://minio{1...2}/data{1...4}
 ```
 
-### Status decommissioning a pool
+## Status decommissioning a pool
+
+### Decommissioning without args lists all pools
 
-#### Decommissioning without args lists all pools
 ```
 λ mc admin decommission status alias/
 ┌─────┬─────────────────────────────────┬──────────────────────────────────┬────────┐
@@ -25,7 +27,8 @@ Decommissiong is a mechanism in MinIO to drain older pools (usually with old har
 └─────┴─────────────────────────────────┴──────────────────────────────────┴────────┘
 ```
 
-#### Decommissioning status
+### Decommissioning status
+
 ```
 λ mc admin decommission status alias/ http://minio{1...2}/data{1...4}
 Decommissioning rate at 36 MiB/sec [4 TiB/50 TiB]
@@ -39,13 +42,15 @@ Once it is **Complete**
 Decommission of pool http://minio{1...2}/data{1...4} is complete, you may now remove it from server command line
 ```
 
-#### A pool not under decommissioning will throw an error
+### A pool not under decommissioning will throw an error
+
 ```
 λ mc admin decommission status alias/ http://minio{1...2}/data{1...4}
 ERROR: This pool is not scheduled for decommissioning currently.
 ```
 
-### Canceling a decommission?
+## Canceling a decommission?
+
 Stop an on-going decommission in progress, mainly used in situations when the load may be too high and you may want to schedule the decommission at a later point in time.
 
 `mc admin decommission cancel` without an argument, lists out any on-going decommission in progress.
@@ -69,6 +74,7 @@ Stop an on-going decommission in progress, mainly used in situations when the lo
 ```
 
 If for some reason decommission fails in between, the `status` will indicate decommission as failed instead.
+
 ```
 λ mc admin decommission status alias/
 ┌─────┬─────────────────────────────────┬──────────────────────────────────┬──────────────────┐
@@ -78,14 +84,16 @@ If for some reason decommission fails in between, the `status` will indicate dec
 └─────┴─────────────────────────────────┴──────────────────────────────────┴──────────────────┘
 ```
 
-### Restart a canceled or failed decommission?
+## Restart a canceled or failed decommission?
 
 ```
 λ mc admin decommission start alias/ http://minio{1...2}/data{1...4}
 ```
 
-### When decommission is 'Complete'?
+## When decommission is 'Complete'?
+
 Once decommission is complete, it will be indicated with *Complete* status.  *Complete* means that now you can now safely remove the first pool argument from the MinIO command line.
+
 ```
 λ mc admin decommission status alias/
 ┌─────┬─────────────────────────────────┬──────────────────────────────────┬──────────┐
@@ -103,10 +111,12 @@ Once decommission is complete, it will be indicated with *Complete* status.  *Co
 
 > Without a 'Complete' status any 'Active' or 'Draining' pool(s) are not allowed to be removed once configured.
 
-### NOTE
+## NOTE
+
 - Empty delete marker's i.e objects with no other successor versions are not transitioned to the new pool, to avoid any empty metadata being recreated on the newer pool. We do not think this is needed, please open a GitHub issue if you think otherwise.
 
-### TODO
+## TODO
+
 - Richer progress UI is not present at the moment, this will be addressed in subsequent releases. Currently however a RATE of data transfer and usage increase is displayed via `mc`.
 - Transitioned Hot Tier's as pooled setups are not currently supported, attempting to decommission buckets with ILM Transition will be rejected by the server. This will be supported in future releases.
 - Embedded Console UI does not support Decommissioning through the UI yet. This will be supported in future releases.