diff --git a/README.md b/README.md
index af9863637b3..9d41d03dd56 100644
--- a/README.md
+++ b/README.md
@@ -50,7 +50,7 @@ EOSIO currently supports the following operating systems:
 
 ## Software Installation
 
-If you are new to EOSIO, it is recommended that you install the [EOSIO Prebuilt Binaries](#prebuilt-binaries), then proceed to the [Getting Started](https://developers.eos.io/eosio-home/docs) walkthrough. If you are an advanced developer, a block producer, or no binaries are available for your platform, you may need to [Build EOSIO from source](https://eosio.github.io/eos/latest/install/build-from-source).
+If you are new to EOSIO, it is recommended that you install the [EOSIO Prebuilt Binaries](#prebuilt-binaries), then proceed to the [Getting Started Guide](https://developers.eos.io/welcome/latest/getting-started-guide). If you are an advanced developer, a block producer, or no binaries are available for your platform, you may need to [Build EOSIO from source](https://developers.eos.io/manuals/eos/latest/install/build-from-source).
 
 ---
 
@@ -69,6 +69,15 @@ Prebuilt EOSIO software packages are available for the operating systems below.
 brew tap eosio/eosio
 brew install eosio
 ```
+Note: On MacOS 10.15 (Catalina), there is a chance to face the linking error below which prevents successful installation of EOSIO:
+```
+Reinstalling 1 broken dependent from source:
+eosio/eosio/eosio
+```
+The following Homebrew commands will resolve this issue:
+```sh
+brew link eosio
+```
 #### Mac OS X Brew Uninstall
 ```sh
 brew remove eosio
@@ -121,13 +130,13 @@ To uninstall the EOSIO built/installed binaries and dependencies, run:
 ```
 
 ## Documentation
-1. [Nodeos](http://eosio.github.io/eos/latest/nodeos/)
-    - [Usage](http://eosio.github.io/eos/latest/nodeos/usage/index)
-    - [Replays](http://eosio.github.io/eos/latest/nodeos/replays/index)
-    - [Chain API Reference](http://eosio.github.io/eos/latest/nodeos/plugins/chain_api_plugin/api-reference/index)
-    - [Troubleshooting](http://eosio.github.io/eos/latest/nodeos/troubleshooting/index)
-1. [Cleos](http://eosio.github.io/eos/latest/cleos/)
-1. [Keosd](http://eosio.github.io/eos/latest/keosd/)
+1. [Nodeos](https://developers.eos.io/manuals/eos/latest/nodeos)
+    - [Usage](https://developers.eos.io/manuals/eos/latest/nodeos/usage)
+    - [Replays](https://developers.eos.io/manuals/eos/latest/nodeos/replays)
+    - [Chain API Reference](https://developers.eos.io/manuals/eos/latest/nodeos/plugins/chain_api_plugin/api-reference)
+    - [Troubleshooting](https://developers.eos.io/manuals/eos/latest/nodeos/troubleshooting)
+1. [Cleos](https://developers.eos.io/manuals/eos/latest/cleos)
+1. [Keosd](https://developers.eos.io/manuals/eos/latest/keosd)
 
 ## Resources
 1. [Website](https://eos.io)
@@ -140,7 +149,7 @@ To uninstall the EOSIO built/installed binaries and dependencies, run:
 1. [Roadmap](https://github.com/EOSIO/Documentation/blob/master/Roadmap.md)
 
 ## Getting Started
-Instructions detailing the process of getting the software, building it, running a simple test network that produces blocks, account creation and uploading a sample contract to the blockchain can be found in the [Getting Started](https://developers.eos.io/welcome/v2.1/getting-started-guide) walkthrough.
+Instructions detailing the process of getting the software, building it, running a simple test network that produces blocks, account creation and uploading a sample contract to the blockchain can be found in the [Getting Started Guide](https://developers.eos.io/welcome/latest/getting-started-guide).
 
 ## Contributing