diff --git a/README.md b/README.md
index 1fd39e34..b3c4458b 100644
--- a/README.md
+++ b/README.md
@@ -40,19 +40,26 @@
 This Git repo has [Git submodules](https://git-scm.com/book/en/v2/Git-Tools-Submodules). They are the subdirectories of `external/`. Each one is basically another Git repo, i.e. an external Git repo that just _looks_ like it's part of this Git repo. It's very easy to get Git into a confusing state when there are submodules. If you follow the following tips, you should probably be okay:
 
 1. Clone this repo using:
+
    ```bash
    git clone --recurse-submodules git@github.com:oceanprotocol/docs.git
    ```
+
 1. Don't edit anything in the submodules (i.e. in `external/`). Instead, edit it over in the other Git repository and merge your changes over there.
 1. Get all the submodules up-to-date using:
+
    ```bash
    git submodule update --remote
    ```
+
    That will get each submodule up-to-date with the HEAD commit of some branch in a remote repository. Which branch? That's set in the `.gitmodules` file. You can check the current commit hashes of all the submodules using `git submodule status`
+
 1. Before doing any `git checkout ...` or other normal Git operations, do this:
+
    ```bash
    git config --global submodule.recurse true
    ```
+
    That's like adding the `--recurse-submodules` option to all those Git commands (except for `git clone`) so you don't have to.
 
 ## Content
diff --git a/content/concepts/components.md b/content/concepts/components.md
index 81129edc..3f8ad18c 100644
--- a/content/concepts/components.md
+++ b/content/concepts/components.md
@@ -55,7 +55,7 @@ OceanDB is an off-chain database for storing metadata about data assets.
 <repo name="oceandb-bigchaindb-driver"></repo>
 <repo name="oceandb-elasticsearch-driver"></repo>
 
-These drivers are extended from a high-level module implementing OceanDB functions.  You can create your own plugins based on its abstracted interface:
+These drivers are extended from a high-level module implementing OceanDB functions. You can create your own plugins based on its abstracted interface:
 
 <repo name="oceandb-driver-interface"></repo>