README fine tuning

Author: kkorotkov

README.md

@@ -9,13 +9,19 @@ C++ wrapper for Labs64 NetLicensing [RESTful API](http://l64.cc/nl10)
 Visit Labs64 NetLicensing at https://netlicensing.io
 
 ## Dependencies
-1. Standard C++ (v.11 and above) and C libraries.
-2. [curl](https://github.com/curl/curl) (include all transitive dependency)
-3. [jsoncpp](https://github.com/open-source-parsers/jsoncpp)(included)
+1. C++11 STL
+2. [libcurl](https://github.com/curl/curl) (with libcurl's transitive dependencies)
+3. [jsoncpp](https://github.com/open-source-parsers/jsoncpp) (included)
 
 ## Compatibility
 
-Building <b>NetLicensing C++ client library</b> with static linking is not supported.
+### Notes:
+
+- Building **NetLicensing C++ client library** with static linking is currently not supported, feel free to contribute.
+
+- **libcurl** version 7.64.0 was used for verified builds.
+
+### Verified builds:
 
 Platform | Build toolset | Supported
 ------------ | ------------- | -------------
@@ -29,47 +35,45 @@ macOS Mojave | Xcode 10.1 | :heavy_check_mark:
 
 ### Build curl
 1. Download <b>curl</b> from https://github.com/curl/curl/releases
-2. <code>cd curl_directory\winbuild</code>
-3. Read <code>BUILD_WINDOWS.txt</code> for building instructions
-4. In <b>VC command prompt:</b>
-    <pre>
-        <code>
-    nmake /f Makefile.vc VC=&#60;VC versions&#62; MACHINE=&#60;x86 or x64&#62; ENABLE_WINSSL=<b>yes</b> MODE=<b>dll</b>
-        </code>
-    </pre>
-5. If you get the error <code>U1073</code> or <code>U1077</code> - execute <code>curl_directory\buildconf.bat</code> first and repeat command
-6. Your <b>curl</b> build directory will be in sub directory <code>\builds</code>
+2. `cd curl_directory\winbuild`
+3. Read `BUILD_WINDOWS.txt` for building instructions
+4. In **VC command prompt**:
+   ```
+   nmake /f Makefile.vc VC=&#60;VC versions&#62; MACHINE=&#60;x86 or x64&#62; ENABLE_WINSSL=<b>yes</b> MODE=<b>dll</b>
+   ```
+5. If you get the error `U1073` or `U1077` - execute `curl_directory\buildconf.bat` first and repeat the `nmake` command
+6. Your `curl` build directory will be in sub directory `builds\`
 
 ### Build NetLicensing C++ client
-1. Download latest release and unpack to <code>NetLicensingClient-cpp</code> (checkout muster if you want to build latest development version)
-2. In <code>NetLicensingClient-cpp</code> create <code>build</code> directory
-3. Specify <b>curl</b> <code>build</code> directory using <code>CMAKE_PREFIX_PATH=your_curl_build_directory</code>. Build directory contains <code>bin, include, lib</code> subdirs.
-4. In <b>VC command prompt:</b>
-
-    <pre>
-        <code>
+1. Download the latest release and unpack to `NetLicensingClient-cpp` (or checkout [master](https://github.com/Labs64/NetLicensingClient-cpp.git) to build the latest development version)
+2. In the `NetLicensingClient-cpp` directory create `build\` subdirectory
+3. Specify **curl** location using `CMAKE_PREFIX_PATH=your_curl_build_directory`. **curl** build directory must contain `bin`, `include`, and `lib` subdirs.
+4. In **VC command prompt** execute:
+   ```
     cd NetLicensingClient-cpp\build
     cmake .. -G "Visual Studio <VC versions> Win&#60;86 or 64&#62;" -DCMAKE_PREFIX_PATH=your_curl_build_directory
-        </code>
-    </pre>
-5. Open solution from <code>NetLicensingClient-cpp\build</code> directory in VC and build library and demo client.
+   ```
+5. Open solution created in `NetLicensingClient-cpp\build` directory in Visual Studio and build the library and demo client.
 
 ## Linux build
 
 ### Build NetLincesing-cpp
-1. Download latest release and unpack to <code>NetLicensingClient-cpp</code> (checkout muster if you want to build latest development version)
-2. Install <b>curl</b> dev. For <b>Ubuntu:</b>
-    <pre><code>sudo apt-get install libcurl4-openssl</code></pre>
-3. In <code>NetLicensingClient-cpp</code> create <code>build</code> directory
-3. Run <code>cmake ..</code> from <code>build</code> directory
-4. Run <code>make</code>
+1. Download the latest release and unpack to `NetLicensingClient-cpp` (or checkout [master](https://github.com/Labs64/NetLicensingClient-cpp.git) to build the latest development version)
+2. Install **curl** (for development, including C headers and libraries). E.g. in **Ubuntu**:
+    ```sudo apt-get install libcurl4-openssl```
+3. In the `NetLicensingClient-cpp` directory create `build/` subdirectory
+4. Execute:
+   ```
+    cd NetLicensingClient-cpp/build
+    cmake ..
+    make
+   ```
 
 ### Unit tests
 
-For unit tests you need installed <b>boost</b> unit test library. To build project with unit tests activated use cmake option <code>-DBUILD_TESTS=yes</code>. For example <code>cmake -DBUILD_TESTS=yes ..</code> . Run tests from <code>tests</code> directory on Linux or <code>tests/Debug</code> on Windows because of expected locations of json source files.
-
+Unit tests require [**Boost**](https://www.boost.org) Unit Test Framework. To build project with the unit tests activated add cmake option `-DBUILD_TESTS=yes`. The tests must be executed from `tests/` subdirectory on Linux or `tests\Debug\` on Windows in order to properly locate the JSON files with test data.
 
-## Note
 
-The <b>curl</b> dynamic library should be installed either system-wide or placed along with your executable file.
+## Execution environment
 
+**libcurl** dynamic library should be either installed system-wide or otherwise available for the loading at run-time (typically located in the same directory as your executable)