Update EOSIO documentation (develop)

docs/00_install/00_install-prebuilt-binaries.md

@@ -1,10 +1,13 @@
+---
+content_title: Install Prebuilt Binaries
+---
 
 [[info | Previous Builds]]
-| If you have previously installed EOSIO from source using shell scripts, you must first run the [Uninstall Script](01_build-from-source/05_uninstall-eosio.md) before installing any prebuilt binaries on the same OS.
+| If you have previously installed EOSIO from source using shell scripts, you must first run the [Uninstall Script](01_build-from-source/01_shell-scripts/05_uninstall-eosio.md) before installing any prebuilt binaries on the same OS.
 
 ## Prebuilt Binaries
 
-EOSIO prebuilt binary packages are available for specific [Operating Systems](index.md#supported-operating-systems). Find the instructions below for your given OS:
+Prebuilt EOSIO software packages are available for the operating systems below. Find and follow the instructions for your OS:
 
 ### Mac OS X:
 
@@ -49,7 +52,13 @@ $ sudo yum remove eosio
 
 ## Location of EOSIO binaries
 
-After installing the prebuilt binaries, the actual EOSIO binaries will be located under the `~/eosio/x.y/bin` folder, where `x.y` is the EOSIO release version that was installed.
+After installing the prebuilt packages, the actual EOSIO binaries will be located under:
+* `/usr/opt/eosio/<version-string>/bin` (Linux-based); or
+* `/usr/local/Cellar/eosio/<version-string>/bin` (MacOS )
+
+where `version-string` is the EOSIO version that was installed; e.g. `2.0.0-rc2`.
+
+Also, soft links for each EOSIO program (`nodeos`, `cleos`, `keosd`, etc.) will be created under `usr/bin` or `usr/local/bin` to allow them to be executed from any directory.
 
 ## Previous Versions
 

docs/00_install/01_build-from-source/01_download-eosio-source.md → docs/00_install/01_build-from-source/01_shell-scripts/01_download-eosio-source.md

@@ -1,3 +1,6 @@
+---
+content_title: Download EOSIO Source
+---
 
 To download the EOSIO source code, clone the `eos` repo and its submodules. It is adviced to create a home `eosio` folder first and download all the EOSIO related software there:
 
@@ -23,3 +26,6 @@ When pulling changes, especially after switching branches, the submodules *must*
 $ [git checkout <branch>]  (optional)
 $ git pull --recurse-submodules
 ```
+
+[[info | What's Next?]]
+| [Build EOSIO binaries](02_build-eosio-binaries.md)

docs/00_install/01_build-from-source/02_build-eosio-binaries/00_build-script.md → docs/00_install/01_build-from-source/01_shell-scripts/02_build-eosio-binaries.md

@@ -1,3 +1,6 @@
+---
+content_title: Build EOSIO Binaries
+---
 
 [[info | Shell Scripts]]
 | The build script is one of various automated shell scripts provided in the EOSIO repository for building, installing, and optionally uninstalling the EOSIO software and its dependencies. They are available in the `eos/scripts` folder.
@@ -12,4 +15,4 @@ $ ./scripts/eosio_build.sh
 The build process writes temporary content to the `eos/build` folder. After building, the program binaries can be found at `eos/build/programs`.
 
 [[info | What's Next?]]
-| [Install EOSIO binaries](../03_install-eosio-binaries.md)
+| [Installing EOSIO](03_install-eosio-binaries.md) is strongly recommended after building from source as it makes local development significantly more friendly.

docs/00_install/01_build-from-source/03_install-eosio-binaries.md → docs/00_install/01_build-from-source/01_shell-scripts/03_install-eosio-binaries.md

@@ -1,3 +1,6 @@
+---
+content_title: Install EOSIO Binaries
+---
 
 ## EOSIO install script
 
@@ -16,3 +19,6 @@ In lieu of the `eosio_install.sh` script, you can install the EOSIO binaries dir
 $ cd ~/eosio/eos/build
 $ sudo make install
 ```
+
+[[info | What's Next?]]
+| Configure and use [Nodeos](../../../01_nodeos/index.md), or optionally [Test the EOSIO binaries](04_test-eosio-binaries.md).

docs/00_install/01_build-from-source/04_build-validation.md → docs/00_install/01_build-from-source/01_shell-scripts/04_test-eosio-binaries.md

@@ -1,3 +1,6 @@
+---
+content_title: Test EOSIO Binaries
+---
 
 Optionally, a set of tests can be run against your build to perform some basic validation of the EOSIO software installation.
 
@@ -25,5 +28,5 @@ cd ~/eosio/eos/build
 make test
 ```
 
-[[info | Recommend]]
-| It is strongly suggested to [Install the EOSIO binaries](03_install-eosio-binaries.md) after building EOSIO from source as it makes local development significantly more friendly.
+[[info | What's Next?]]
+| Configure and use [Nodeos](../../../01_nodeos/index.md).

docs/00_install/01_build-from-source/05_uninstall-eosio.md → docs/00_install/01_build-from-source/01_shell-scripts/05_uninstall-eosio.md

@@ -1,3 +1,6 @@
+---
+content_title: Uninstall EOSIO
+---
 
 If you have previously built EOSIO from source and now wish to install the prebuilt binaries, or to build from source again, it is recommended to run the `eosio_uninstall.sh` script within the `eos/scripts` folder:
 

docs/00_install/01_build-from-source/01_shell-scripts/index.md

@@ -0,0 +1,17 @@
+---
+content_title: Shell Scripts
+---
+
+[[info | Did you know?]]
+| Shell scripts automate the process of building, installing, testing, and uninstalling the EOSIO software and dependencies.
+
+To build EOSIO from the source code using shell scripts, visit the sections below:
+
+1. [Download EOSIO Source](01_download-eosio-source.md)
+2. [Build EOSIO Binaries](02_build-eosio-binaries.md)
+3. [Install EOSIO Binaries](03_install-eosio-binaries.md)
+4. [Test EOSIO Binaries](04_test-eosio-binaries.md)
+5. [Uninstall EOSIO](05_uninstall-eosio.md)
+
+[[info | Building EOSIO is for Advanced Developers]]
+| If you are new to EOSIO, it is recommended that you install the [EOSIO Prebuilt Binaries](../../00_install-prebuilt-binaries.md) instead of building from source.