Added more detailed dependency installation instructions as suggested…

… in openjournals/joss-reviews#1592 (comment)

.gitignore

@@ -25,4 +25,4 @@ status_code_test
 # Visual Studio 2015/2017 cache/options directory
 .vs
 
-doxygen/documentation
+docs/doxygen_output

.gitlab-ci.yml

@@ -39,8 +39,8 @@ pages:
   image: alpine
   script:
     - apk update && apk add doxygen
-    - cd .. && doxygen doxygen/Doxyfile
-    - mv doxygen/documentation/html/ public/
+    - cd .. && doxygen docs/Doxyfile
+    - mv docs/doxygen_output/html/ public/
   artifacts:
     paths:
     - public

README.md

@@ -1,11 +1,10 @@
-Simple-Web-Server
-=================
+# Simple-Web-Server
 
 A very simple, fast, multithreaded, platform independent HTTP and HTTPS server and client library implemented using C++11 and Asio (both Boost.Asio and standalone Asio can be used). Created to be an easy way to make REST resources available from C++ applications. 
 
 See https://gitlab.com/eidheim/Simple-WebSocket-Server for an easy way to make WebSocket/WebSocket Secure endpoints in C++. Also, feel free to check out the new C++ IDE supporting C++11/14/17: https://gitlab.com/cppit/jucipp. 
 
-### Features
+## Features
 
 * Asynchronous request handling
 * Thread pool if needed
@@ -18,21 +17,23 @@ See https://gitlab.com/eidheim/Simple-WebSocket-Server for an easy way to make W
 * Sending outgoing messages is thread safe
 * Client creates necessary connections and perform reconnects when needed
 
-### Usage
+## Usage
 
 See [http_examples.cpp](https://gitlab.com/eidheim/Simple-Web-Server/blob/master/http_examples.cpp) or
 [https_examples.cpp](https://gitlab.com/eidheim/Simple-Web-Server/blob/master/https_examples.cpp) for example usage.
 Particularly, the JSON-POST (using Boost.PropertyTree) and the GET /match/[number] examples might be relevant.
 
 [Documentation](https://eidheim.gitlab.io/Simple-Web-Server/annotated.html) is also available, generated from the master branch.
 
-### Dependencies
+## Dependencies
 
 * Boost.Asio or standalone Asio
 * Boost is required to compile the examples
-* For HTTPS: OpenSSL libraries 
+* For HTTPS: OpenSSL libraries
 
-### Compile and run
+See [dependency installation instructions](https://gitlab.com/eidheim/Simple-Web-Server/blob/master/docs/dependency_install.md) for further information.
+
+## Compile and run
 
 Compile with a C++11 compliant compiler:
 ```sh
@@ -43,21 +44,21 @@ make
 cd ..
 ```
 
-#### HTTP
+### HTTP
 
 Run the server and client examples: `./build/http_examples`
 
 Direct your favorite browser to for instance http://localhost:8080/
 
-#### HTTPS
+### HTTPS
 
 Before running the server, an RSA private key (server.key) and an SSL certificate (server.crt) must be created.
 
 Run the server and client examples: `./build/https_examples`
 
 Direct your favorite browser to for instance https://localhost:8080/
 
-### Contributing
+## Contributing
 
 Contributions are welcome, either by creating an issue or a merge request.
 However, before you create a new issue or merge request, please search for previous similar issues or requests.

doxygen/Doxyfile → docs/Doxyfile

@@ -58,7 +58,7 @@ PROJECT_LOGO           =
 # entered, it will be relative to the location where doxygen was started. If
 # left blank the current directory will be used.
 
-OUTPUT_DIRECTORY       = doxygen/documentation
+OUTPUT_DIRECTORY       = docs/doxygen_output
 
 # If the CREATE_SUBDIRS tag is set to YES then doxygen will create 4096 sub-
 # directories (in 2 levels) under the output directory of each output format and

docs/dependency_install.md

@@ -0,0 +1,23 @@
+# Dependency installation instructions
+
+Installation instructions for the dependencies of the example files on a selection of platforms.
+
+Default build with Boost.Asio is assumed. Turn on CMake option `USE_STANDALONE_ASIO` to instead use standalone Asio.
+
+## Debian based distributions
+
+```sh
+sudo apt-get install libssl-dev libboost-filesystem-dev libboost-thread-dev
+```
+
+## Arch Linux based distributions
+
+```sh
+sudo pacman -S boost
+```
+
+## MacOS
+
+```sh
+brew install openssl boost
+```