Apply documentation patch from @arjenmarkus

 Fixes #582

Author: zbeekman

INSTALL

@@ -66,7 +66,7 @@ Before you start
  * Your environment is setup to use the compilers you wish to build and use
    OpenCoarrays with. (LD_LIBRARY_PATH is set, if needed, etc.)
 
- Also, you will need the OpenCoarrays source, which, you presumably already
+ Also, you will need the OpenCoarrays source, which you presumably already
  have if you are reading this. The latest stable OpenCoarrays release can be
  obtained at:
 
@@ -81,7 +81,7 @@ Before you start
 Configure, build and install OpenCoarrays
 -----------------------------------------
 
- OpenCoarrays does *NOT* allow in source builds. Once you have obtained the
+ OpenCoarrays does *NOT* allow in-source builds. Once you have obtained the
  source code, you must create a build directory. This may be a subdirectory of
  the top level source directory, or in a completely un-related location.
 
@@ -113,7 +113,7 @@ Configure, build and install OpenCoarrays
 Configure options
 -----------------
 
- The OpenCoarrays build system attempts to set the best possible defailt
+ The OpenCoarrays build system attempts to set the best possible default
  settings for your Fortran compiler and MPI implementation through intro-
  spection. However, some bugs or use cases may warrant tweaking the config-
  uration. Each of the following options may be set using the `-D` flag to
@@ -125,7 +125,7 @@ Configure options
 
  CMAKE_INSTALL_PREFIX
 	Tell cmake where to install OpenCoarrays. Default=/usr/local
-	Example: cmake .. -DCMAKE_INSTALL_PREFIX=/opt/OpenCoarrays/1.9.1
+	Example: cmake .. -DCMAKE_INSTALL_PREFIX=/opt/OpenCoarrays/2.2.0
 
  CMAKE_BUILD_TYPE
 	Specify the build type. Default value: Release
@@ -140,7 +140,7 @@ Configure options
  CAF_ENABLE_FAILED_IMAGES
 	Enable failed image support. Defaults to TRUE if experimental fault
 	tolerance features are detected to be present in the MPI
-	implementation. FALSE/unavailable if no MPI support is present
+	implementation. FALSE/unavailable if the MPI installation does not support it
 	Example: cmake .. -DCAF_ENABLE_FAILED_IMAGES=FALSE
 
  CAF_EXPOSE_INIT_FINALIZE

INSTALL.md

@@ -85,9 +85,9 @@ source.
 
 ### macOS ###
 
-* [Homebrew]:  
-  [![homebrew][Homebrew badge]][braumeister link]  
-  This is the recommend OpenCoarrays installation method on macOS.
+* [Homebrew]:
+  [![homebrew][Homebrew badge]][braumeister link]
+  This is the recommended OpenCoarrays installation method on macOS.
   Basic Homebrew installation steps:
 
   ```
@@ -106,7 +106,7 @@ source.
   brew bundle
   ```
 
-* [MacPorts]:  
+* [MacPorts]:
   An unmaintained [OpenCoarrays Portfile] exists for the [MacPorts] package
   manager.  Although the current OpenCoarrays contributors have no plans to
   update the portfile, new contributors are welcome to asssume the port
@@ -140,9 +140,13 @@ or pre-installed copies:
    distributions
 
 [linuxbrew] does not require `sudo` privileges and will generally
-provide the most up-to-date OpenCoarrays release because linxubrew
+provide the most up-to-date OpenCoarrays release because linuxbrew
 pulls directly from macOS homebrew, which updates automatically.
 
+Note that distributions are often split into two parts: a "binary" package with the
+runtime libraries and a "development" package for developing programs yourself.
+Be sure to install both packages.
+
 <a name="easybuild"></a>
 With [EasyBuild], the following bash commands install OpenCoarrays:
 
@@ -175,9 +179,9 @@ spack spec opencoarrays
 # to be installed to compile OpenMPI)
 spack install opencoarrays
 
-# Or, To install with customisations (e.g., to install OpenCoarrays [version 1.9.0]
+# Or, To install with customisations (e.g., to install OpenCoarrays [version 2.2.0]
 # with MPICH [version default] and GCC [version 7.1.0]).
-spack install opencoarrays@1.9.0 ^mpich %[email protected]
+spack install opencoarrays@2.2.0 ^mpich %[email protected]
 ```
 
 In the previous example, it was assumed that GCC [version 7.1.0] is
@@ -275,6 +279,7 @@ of flags. Each flag also has a single-character version not shown here.
    ```
 
 4. Install only a specific prerequisite package (the default version):
+
    ```
    ./install.sh --package mpich
    ```
@@ -352,7 +357,7 @@ this document [here][Developer Build and Install].
 Unlike the Makefiles that CMake generates automatically for the chosen
 platform, static Makefiles require a great deal more maintenance and are
 less portable.  Also, the static Makefiles provided in [src] lack several
-several important capabilities.  In particular, they will not build the tests;
+important capabilities.  In particular, they will not build the tests;
 they will not generate the `caf` compiler wrapper that ensures correct linking
 and `cafrun` program launcher that ensures support for advanced features such
 as Fortran 2015 failed images; they will not build the [opencoarrays] module