docs: update building & installation instructions

Author: wprzytula

docs/source/topics/building.md

@@ -1,27 +1,25 @@
 # Building
 
-The ScyllaDB C/C++ Driver will build on most standard Unix-like and Microsoft
-Windows platforms. Packages are available for the following platforms:
-
-* [CentOS 7 64-bit][cpp-driver-centos7]
-* [Ubuntu 18.04 LTS 64-bit][cpp-driver-ubuntu18-04]
+The ScyllaDB C/C++ Driver will build on most standard Unix-like platforms.
+Packages are available for the platforms listed in [Installation][installation.md].
 
 These packages can be successfully installed on other, compatible systems, but
 we do not support such configurations and recommend building from sources
-instead. Please note that although Microsoft Windows and OS X builds are possible,
-ScyllaDB does not support these platforms.
+instead.
 
 ## Compatibility
 
-* Compilers: GCC 4.1.2+ Clang 3.4+, and MSVC 2012+
+* Compilers:
+  - rustc 1.82+ (as part of the Rust toolchain, available at [rustup.rs]);
+  - any reasonable C/C++ compiler, such as GCC or Clang (for tests & examples).
 
 ## Dependencies
 
 The C/C++ driver depends on the following software:
 
-* [CMake] v2.6.4+
+* [CMake] v3.15+
 * [libuv] 1.x (only for tests and examples, not required for the driver itself)
-* [OpenSSL] v1.0.x or v1.1.x \*
+* [OpenSSL] versions 1.0.1 through 3.x.x are supported (optional, only if you want to enable TLS support in the driver)
 
 __\*__ Use the `CASS_USE_OPENSSL` CMake option to enable/disable OpenSSL
          support. Disabling this option will disable SSL/TLS protocol support
@@ -31,30 +29,23 @@ Note that only `CMake` is mandatory for building the driver. The others:
 - `libuv` is only required for building tests and some of the examples, not the driver itself.
 - `OpenSSL` is only required if you want to enable TLS support in the driver.
 
-## Linux/Mac OS
-
-The driver is known to build on CentOS/RHEL 6/7/8, Mac OS X 10.10/10.11 (Yosemite
-and El Capitan), Mac OS 10.12/10.13 (Sierra and High Sierra), and Ubuntu
-14.04/16.04/18.04 LTS.
-
-__NOTE__: The driver will also build on most standard Unix-like systems using
-          GCC 4.1.2+ or Clang 3.4+.
+## Linux/MacOS
 
 ### Installing dependencies
 
 #### Initial environment setup
 
-##### CentOS/RHEL (Yum)
+##### RHEL/Rocky (dnf)
 
 ```bash
-yum install automake cmake gcc-c++ git libtool
+dnf install automake cmake gcc-c++ git libtool
 ```
 
 ##### Ubuntu (APT)
 
 ```bash
-apt-get update
-apt-get install build-essential cmake git
+apt update
+apt install build-essential cmake git
 ```
 
 ##### Mac OS (Brew)
@@ -78,24 +69,16 @@ make sure you install v1.x.
 ##### Ubuntu
 
 ```bash
-sudo apt-get update
-sudo apt-get install libuv-dev
+sudo apt update
+sudo apt install libuv-dev
 ```
 
-##### CentOS/RHEL
+##### RHEL/Rocky
 
 ```bash
 sudo dnf install libuv-devel
 ```
 
-If your package manager is not able to locate `libuv`, you might still be able to
-install it from EPEL:
-
-```bash
-sudo yum install -y epel-release
-sudo yum install -y libuv-devel
-```
-
 ##### Mac OS (Brew)
 
 ```bash
@@ -112,16 +95,16 @@ Follow the instructions in the downloaded package to build and install it.
 
 #### OpenSSL
 
-##### CentOS (Yum)
+##### RHEL/Rocky (dnf)
 
 ```bash
-yum install openssl-devel
+dnf install openssl-devel
 ```
 
 ##### Ubuntu (APT)
 
 ```bash
-apt-get install libssl-dev
+apt install libssl-dev
 ```
 
 ##### Mac OS (Brew)
@@ -130,8 +113,7 @@ apt-get install libssl-dev
 brew install openssl
 ```
 
-__Note__: For Mac OS X 10.11 (El Capitan) and Mac OS 10.12/10.13 (Sierra and
-          High Sierra) a link needs to be created in order to make OpenSSL
+__Note__: For Mac OS X, a link needs to be created in order to make OpenSSL
           available to the building libraries:
 
 ```bash
@@ -140,16 +122,8 @@ brew link --force openssl
 
 ##### Manually build and install
 
-```bash
-pushd /tmp
-wget --no-check-certificate https://www.openssl.org/source/openssl-1.0.2u.tar.gz
-tar xzf openssl-1.0.2u.tar.gz
-pushd openssl-1.0.2u
-CFLAGS=-fpic ./config shared
-make install
-popd
-popd
-```
+Browse [https://openssl-library.org/source/] and download the newest stable version available.
+Follow the instructions in the downloaded package to build and install it.
 
 ### Building and installing the C/C++ driver
 
@@ -181,7 +155,7 @@ Tests (integration and unit) are not built by default and need to be enabled.
 cmake -DCASS_BUILD_TESTS=On ..
 ```
 
-__Note__: This will build both the integration and unit tests
+__Note__: This will build both the integration and unit tests.
 
 ##### Integration tests
 
@@ -196,8 +170,6 @@ cmake -DCASS_BUILD_UNIT_TESTS=On ..
 ```
 
 [download server]: https://github.com/scylladb/cpp-rust-driver/releases
-[cpp-driver-centos7]: https://github.com/scylladb/cpp-driver/releases/download/2.15.2-1/scylla-cpp-driver-2.15.2-1.el7.x86_64.rpm
-[cpp-driver-ubuntu18-04]: https://github.com/scylladb/cpp-driver/releases/download/2.15.2-1/scylla-cpp-driver_2.15.2-1_amd64.deb
 [Homebrew]: https://brew.sh
 [CMake]: http://www.cmake.org/download
 [libuv]: http://libuv.org

docs/source/topics/getting-started.md

@@ -7,53 +7,51 @@
 #### Dependencies
 
 Packages for the dependencies: libuv (1.x), OpenSSL can be installed
-from distribution's repositories and/or EPEL. Please note that `apt-get` can
-handle the dependencies by itself, therefore this step can likely be omitted
-on Ubuntu.
+from distribution's repositories.
 
 ```bash
-# Example: Ubuntu 18.04:
-sudo apt-get update
-sudo apt-get install -y libuv1 openssl libssl
+# Example: Ubuntu/Debian:
+sudo apt update
+sudo apt install -y libuv1 openssl libssl
 
-# Example: CentOS 7:
-sudo yum install -y epel-release
-sudo yum install -y libuv openssl
+# Example: Rocky/RedHat:
+sudo dnf install -y libuv openssl
 ```
 
 The driver can also be [built from source], in which case dependencies need
 to be installed in `-dev` or `-devel` versions.
 
 ### Driver
 
-Packages are currently available for the following platforms:
-
-* CentOS 7
-* Ubuntu 18.04 LTS
+Packages are available for some platforms - see the [Installation section](installation.md) for a list.
 
 They are available for download from the [Releases][cpp-rust-driver-releases] section.
 
-NOTE: If you have Datastax cpp-driver installed you need to remove it first:
+NOTE: If you have Datastax or ScyllaDB C/C++ Driver installed, you need to remove it first:
 
 ```bash
 # Ubuntu/Debian:
-sudo apt-get remove cassandra-cpp-driver
+sudo apt remove cassandra-cpp-driver
+sudo apt remove scylla-cpp-driver
 
 
-# CentOS/RedHat:
-sudo yum remove cassandra-cpp-driver
+# Rocky/RedHat:
+sudo dnf remove cassandra-cpp-driver
+sudo dnf remove scylla-cpp-driver
 ```
 
+<!-- FIXME: Note that there is only a `dev` package for Ubuntu. Is it expected? -->
+<!-- Also, the name is `cpp-driver`, not `cpp-rust-driver`. -->
 ```bash
-# Example: Ubuntu 18.04/Debian:
-wget https://github.com/scylladb/cpp-driver/releases/download/2.15.2-1/scylla-cpp-driver_2.15.2-1_amd64.deb https://github.com/scylladb/cpp-driver/releases/download/2.15.2-1/scylla-cpp-driver-dev_2.15.2-1_amd64.deb
-sudo apt-get update
-sudo apt-get install -y ./scylla-cpp-driver_2.15.2-1_amd64.deb ./scylla-cpp-driver-dev_2.15.2-1_amd64.deb
+# Example: Ubuntu/Debian:
+wget https://github.com/scylladb/cpp-rust-driver/releases/download/v0.5.1/libscylla-cpp-driver-dev_0.5.1-0.20250716.8a3d0fe0c219-0ubuntu1.noble_amd64.deb
+sudo apt update
+sudo apt install -y ./libscylla-cpp-driver-dev_0.5.1-0.20250716.8a3d0fe0c219-0ubuntu1.noble_amd64.deb
 
 
-# Example: CentOS 7/RedHat:
-wget https://github.com/scylladb/cpp-driver/releases/download/2.15.2-1/scylla-cpp-driver-2.15.2-1.el7.x86_64.rpm https://github.com/scylladb/cpp-driver/releases/download/2.15.2-1/scylla-cpp-driver-devel-2.15.2-1.el7.x86_64.rpm
-sudo yum localinstall -y scylla-cpp-driver-2.15.2-1.el7.x86_64.rpm scylla-cpp-driver-devel-2.15.2-1.el7.x86_64.rpm
+# Example: Rocky/RedHat:
+wget https://github.com/scylladb/cpp-rust-driver/releases/download/v0.5.1/scylla-cpp-rust-driver-0.5.1-0.20250716.8a3d0fe0c219.fc41.x86_64.rpm https://github.com/scylladb/cpp-rust-driver/releases/download/v0.5.1/scylla-cpp-rust-driver-devel-0.5.1-0.20250716.8a3d0fe0c219.fc41.x86_64.rpm
+sudo dnf install -y ./scylla-cpp-rust-driver-0.5.1-0.20250716.8a3d0fe0c219.fc41.x86_64.rpm ./scylla-cpp-rust-driver-devel-0.5.1-0.20250716.8a3d0fe0c219.fc41.x86_64.rpm
 ```
 
 ## Connecting

docs/source/topics/installation.md

@@ -2,31 +2,33 @@
 
 ## Packages
 
-Pre-built packages are available for CentOS 7 and Ubuntu 18.04.
+Pre-built packages are available for:
+- Rocky Linux 9,
+- Fedora 41 and 42,
+- Ubuntu 22.04 LTS and 24.04 LTS.
 
-### CentOS
+### RHEL/Rocky
 
-To install the dependencies we recommend using EPEL:
+To install the dependencies:
 
 ```bash
-sudo yum install -y epel-release
-sudo yum -y install libuv openssl
+sudo dnf -y install libuv openssl
 ```
 
 Install the runtime library. Replace `<VERSION>` with the version+platform string:
 
 ```bash
-sudo yum localinstall -y scylla-cpp-driver-<VERSION>.rpm
+sudo dnf install -y scylla-cpp-driver-<VERSION>.rpm
 ```
 
 When developing against the driver you'll also want to install the development
 package and the debug symbols:
 
 ```bash
-sudo yum localinstall -y scylla-cpp-driver-devel-<VERSION>.rpm scylla-cpp-driver-debuginfo-<VERSION>.rpm
+sudo dnf install -y scylla-cpp-driver-devel-<VERSION>.rpm scylla-cpp-driver-debuginfo-<VERSION>.rpm
 ```
 
-### Ubuntu
+### Ubuntu/Debian
 
 Ubuntu's apt-get will resolve and install the dependencies by itself.
 Replace `<VERSION>` with the appropriate version+platform string:
@@ -45,6 +47,6 @@ sudo apt-get install -y ./scylla-cpp-driver-dev_<VERSION>.deb ./scylla-cpp-drive
 
 ## Building
 
-If pre-built packages are not available for your platform or architecture you
-will need to build the driver from source. Directions for building and
+If pre-built packages are not available for your platform or architecture,
+you will need to build the driver from source. Directions for building and
 installing the ScyllaDB C/C++ Driver can be found [here](building.md).