CXX-2579 use standard directories in main install instructions

[kevinAlbs]

Description

This PR changes the main installation instructions to use standard directories. Installing to non-standard directories, as well as common fixes to failures to load libraries, have been moved to the "Advanced Configuration and Installation Options" instructions.

Documentation can be locally built with cmake --build cmake-build --target hugo.

Use standard install directories in main installation instructions

The error described in CXX-2579 is due to the runtime loader being unable to find the C++ driver libraries.

IMO installing to non-standard directories is not a common enough use case to add to the main installation instructions.

The C driver Unix install instructions do not set CMAKE_INSTALL_PREFIX.

A section named Installing to non-standard directories has been added to the Advanced Configuration and Installation Options page.

Add instructions for fixes to locate shared libraries

To assist users encountering errors locating shared libraries, suggested solutions were added to the "Advanced Configuration and Installation Options".

Solutions for the "Library not loaded" error on macOS were tested here.
Solutions for the "cannot open shared object file" error on Linux were tested here.

https://www.mikeash.com/pyblog/friday-qa-2009-11-06-linking-and-install-names.html suggests that application is responsible for adding paths to load:

Starting in 10.5, Apple provides rpath, which is a solution to this. When placed at the front of an install name, this asks the dynamic linker to search a list of locations for the library. That list is embedded in the application, and can therefore be controlled by the application's build process, not the framework's. A single copy of a framework can thus work for multiple purposes.

https://www.dribin.org/dave/blog/archives/2009/11/15/rpath/ also suggests this:

The linking application now needs to define what the rpath expands out to

Other improvements

• Replace /opt/ with $HOME in non-standard directory install instructions. Installing to /opt may be more likely to require root permissions.
• Include missing /lib in CMAKE_INSTALL_RPATH instruction.
• Fix link rendering on configuration page.

[rcsanchez97]

LGTM