Improve documentation of installation steps

Signed-off-by: Torsten Long <[email protected]>

Author: razziel89

README.md

@@ -35,10 +35,10 @@ and `golang/mock`.
 ## Installation
 
 To get started, just head over to the [releases] and download the
-[latest release][latest-release].
-Then, you can write your [bats-core]-based tests.
-Just make sure to use `load shellmock` in your `setup` function.
-See [below](#documentation-overview) for `shellmock`'s documentation.
+[latest release][latest-release] to the root directory of your repository.
+We recommend to add the downloaded file `shellmock.bash` to your `.gitignore`.
+Please see [below](#documentation-overview) for `shellmock`'s detailed
+documentation.
 
 ### Dependencies
 
@@ -52,7 +52,8 @@ The following tools are needed to use `shellmock`:
 - `mktemp`
 - `rm`
 
-On Debian-based systems, they can be installed via:
+On Debian-based systems, if they are not already pre-installed, they can be
+installed via:
 
 ```bash
 sudo apt install -yqq bash coreutils

docs/quickstart.md

@@ -18,6 +18,8 @@
 
 # Quickstart Guide
 
+First up, if we haven't already done so, we follow [these steps][installation]
+to download and install `shellmock`.
 Now that we have downloaded `shellmock` to the root directory of our repository
 and installed [bats-core] on our system, we can create a simple test.
 We put the following in a file called `test.bats`:
@@ -105,5 +107,6 @@ You may also check out our [how-to for creating tests].
 [bats-core]: https://bats-core.readthedocs.io/ "bats core website"
 [full command reference]: ./usage.md
 [how-to for creating tests]: ./howto.md
+[installation]: ../#installation
 [shellmock-tests]: ../tests/main.bats "shellmock tests"
 [this detailed example]: ./example.md