Documentation cleanup (#579)

absurdfarce · web-flow · commit f81cba452d0e · 2025-10-29T16:52:23.000-05:00
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -131,6 +131,6 @@ submit them in a new commit. These commits will be squashed before inclusion
 into the stable or unstable branches.
 
 [JIRA]: https://datastax-oss.atlassian.net/browse/CPP/?selectedTab=com.atlassian.jira.jira-projects-plugin:summary-panel
-[Google C++ Style Guide]: http://google-styleguide.googlecode.com/svn/trunk/cppguide.html
+[Google C++ Style Guide]: https://google.github.io/styleguide/cppguide.html
 [early exits]: http://llvm.org/docs/CodingStandards.html#use-early-exits-and-continue-to-simplify-code
-[testing guide]: http://datastax.github.io/cpp-driver/topics/testing
+[testing guide]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/testing
diff --git a/README.md b/README.md
@@ -236,30 +236,30 @@ specific language governing permissions and limitations under the License.
 [DataStax Astra]: https://astra.datastax.com
 [Kerberos]: https://web.mit.edu/kerberos
 
-[Asynchronous API]: http://datastax.github.io/cpp-driver/topics/#futures
-[Simple]: http://datastax.github.io/cpp-driver/topics/#executing-queries
-[Prepared]: http://datastax.github.io/cpp-driver/topics/basics/prepared_statements/
-[Batch]: http://datastax.github.io/cpp-driver/topics/basics/batches/
-[Asynchronous I/O]: http://datastax.github.io/cpp-driver/topics/#asynchronous-i-o
-[parallel execution]: http://datastax.github.io/cpp-driver/topics/#thread-safety
-[load balancing]: http://datastax.github.io/cpp-driver/topics/configuration/#load-balancing
-[Authentication]: http://datastax.github.io/cpp-driver/topics/security/#authentication
-[SSL]: http://datastax.github.io/cpp-driver/topics/security/ssl/
-[Latency-aware routing]: http://datastax.github.io/cpp-driver/topics/configuration/#latency-aware-routing
-[Performance metrics]: http://datastax.github.io/cpp-driver/topics/metrics/
-[Tuples]: http://datastax.github.io/cpp-driver/topics/basics/tuples/
-[UDTs]: http://datastax.github.io/cpp-driver/topics/basics/user_defined_types/
-[Nested collections]: http://datastax.github.io/cpp-driver/topics/basics/binding_parameters/#nested-collections
-[Data types]: http://datastax.github.io/cpp-driver/topics/basics/data_types/
-[Retry policies]: http://datastax.github.io/cpp-driver/topics/configuration/retry_policies/
-[Client-side timestamps]: http://datastax.github.io/cpp-driver/topics/basics/client_side_timestamps/
-[Idle connection heartbeats]: http://datastax.github.io/cpp-driver/topics/configuration/#connection-heartbeats
-[Blacklist]: http://datastax.github.io/cpp-driver/topics/configuration/#blacklist
-[whitelist DC]: http://datastax.github.io/cpp-driver/topics/configuration/#datacenter
-[blacklist DC]: http://datastax.github.io/cpp-driver/topics/configuration/#datacenter
-[Custom]: http://datastax.github.io/cpp-driver/topics/security/#custom
-[Reverse DNS]: http://datastax.github.io/cpp-driver/topics/security/ssl/#enabling-cassandra-identity-verification
-[Speculative execution]: http://datastax.github.io/cpp-driver/topics/configuration/#speculative-execution
+[Asynchronous API]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/#futures
+[Simple]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/#executing-queries
+[Prepared]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/basics/prepared_statements/
+[Batch]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/basics/batches/
+[Asynchronous I/O]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/#asynchronous-i-o
+[parallel execution]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/#thread-safety
+[load balancing]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/configuration/#load-balancing
+[Authentication]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/security/#authentication
+[SSL]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/security/ssl/
+[Latency-aware routing]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/configuration/#latency-aware-routing
+[Performance metrics]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/metrics/
+[Tuples]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/basics/tuples/
+[UDTs]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/basics/user_defined_types/
+[Nested collections]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/basics/binding_parameters/#nested-collections
+[Data types]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/basics/data_types/
+[Retry policies]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/configuration/retry_policies/
+[Client-side timestamps]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/basics/client_side_timestamps/
+[Idle connection heartbeats]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/configuration/#connection-heartbeats
+[Blacklist]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/configuration/#blacklist
+[whitelist DC]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/configuration/#datacenter
+[blacklist DC]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/configuration/#datacenter
+[Custom]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/security/#custom
+[Reverse DNS]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/security/ssl/#enabling-cassandra-identity-verification
+[Speculative execution]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/configuration/#speculative-execution
 [DSE authentication]: http://docs.datastax.com/en/developer/cpp-driver/latest/dse_features/authentication
 [DSE geospatial types]: http://docs.datastax.com/en/developer/cpp-driver/latest/dse_features/geotypes
 [DSE Proxy Authentication]: http://docs.datastax.com/en/developer/cpp-driver/latest/dse_features/authentication/#proxy-authentication
diff --git a/docs.yaml b/docs.yaml
@@ -39,7 +39,7 @@ nanoc_config:
         - '^https?://ci.appveyor.com/*'
         - 'https://twitter.com/datastax'
 rewrites:
-  - http://datastax.github.io/cpp-driver/: /
+  - https://docs.datastax.com/en/developer/cpp-driver/latest/: /
   - https://datastax.github.io/cpp-driver/: /
   # Compatability changes for older versions
   - /api/Cass(.*): /api/struct.Cass\1
diff --git a/packaging/debian/control b/packaging/debian/control
@@ -6,7 +6,7 @@ Build-Depends: debhelper (>= 9.0.0), dh-exec, cmake, make,
         libssl-dev
 Standards-Version: 3.9.2
 Section: libs
-Homepage: http://datastax.github.io/cpp-driver/
+Homepage: https://docs.datastax.com/en/developer/cpp-driver/latest/
 Vcs-Git: git://github.com/datastax/cpp-driver.git
 Vcs-Browser: https://github.com/datastax/cpp-driver
 
diff --git a/packaging/homebrew/cassandra-cpp-driver.rb b/packaging/homebrew/cassandra-cpp-driver.rb
@@ -1,7 +1,7 @@
 require "formula"
 
 class CassandraCppDriver < Formula
-  homepage "http://datastax.github.io/cpp-driver/"
+  homepage "https://docs.datastax.com/en/developer/cpp-driver/latest/"
   url "https://github.com/datastax/cpp-driver/archive/2.7.0.tar.gz"
   sha256 "44a97679e719b2b046ef90323beab4fe3a491ae79396e7f28e6a9677b618a0e4"
   version "2.7.0"
diff --git a/topics/README.md b/topics/README.md
@@ -253,15 +253,15 @@ with other drivers. The schedule for these features can be found on [JIRA].
 - Callback interfaces for load balancing, authentication, reconnection and retry
 
 [Artifactory server]: https://datastax.jfrog.io/artifactory/cpp-php-drivers/cpp-driver/builds
-[built from source]: http://datastax.github.io/cpp-driver/topics/building/
-[prepared statements]: http://datastax.github.io/cpp-driver/topics/basics/prepared_statements/
-[`cass_int32_t`]: http://datastax.github.io/cpp-driver/api/cassandra.h/#cass-int32-t
-[`cass_result_first_row()`]: http://datastax.github.io/cpp-driver/api/struct.CassResult/#cass-result-first-row
-[`cass_cluster_set_num_threads_io()`]: http://datastax.github.io/cpp-driver/api/struct.CassCluster/#function-cass_cluster_set_num_threads_io
-[`CassCluster`]: http://datastax.github.io/cpp-driver/api/struct.CassCluster/
-[`CassFuture`]: http://datastax.github.io/cpp-driver/api/struct.CassFuture/
-[`CassStatement`]: http://datastax.github.io/cpp-driver/api/struct.CassStatement/
-[`CassIterator`]: http://datastax.github.io/cpp-driver/api/struct.CassIterator/
-[`CassSession`]: http://datastax.github.io/cpp-driver/api/struct.CassSession/
+[built from source]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/building/
+[prepared statements]: https://docs.datastax.com/en/developer/cpp-driver/latest/topics/basics/prepared_statements/
+[`cass_int32_t`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/cassandra.h/#cass-int32-t
+[`cass_result_first_row()`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassResult/#cass-result-first-row
+[`cass_cluster_set_num_threads_io()`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassCluster/#function-cass_cluster_set_num_threads_io
+[`CassCluster`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassCluster/
+[`CassFuture`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassFuture/
+[`CassStatement`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassStatement/
+[`CassIterator`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassIterator/
+[`CassSession`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassSession/
 [post]: http://www.datastax.com/dev/blog/4-simple-rules-when-using-the-datastax-drivers-for-cassandra
 [JIRA]: https://datastax-oss.atlassian.net/browse/CPP
diff --git a/topics/basics/binding_parameters/README.md b/topics/basics/binding_parameters/README.md
@@ -39,7 +39,7 @@ resize) a statement's parameters.
 
 ## Constructing Collections
 
-Collections are supported using [`CassCollection`](http://datastax.github.io/cpp-driver/api/struct.CassCollection/) objects; supporting `list`, `map` and `set` Cassandra types. The code below shows how to construct a `list` collection; however, a set can be constructed in a very similar way. The only difference is the type `CASS_COLLECTION_TYPE_SET` is used to create the collection instead of `CASS_COLLECTION_TYPE_LIST`.
+Collections are supported using [`CassCollection`](https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassCollection/) objects; supporting `list`, `map` and `set` Cassandra types. The code below shows how to construct a `list` collection; however, a set can be constructed in a very similar way. The only difference is the type `CASS_COLLECTION_TYPE_SET` is used to create the collection instead of `CASS_COLLECTION_TYPE_LIST`.
 
 **Important**: Values appended to the collection can be freed immediately afterward because the values are copied.
 
@@ -95,4 +95,4 @@ Custom types can be bound using either the `cass_statement_bind_bytes[_by_name](
 name of the custom type matches the class name of the type being bound.
 
 [`cass_collection_append_collection()`]:
-http://datastax.github.io/cpp-driver/api/struct.CassCollection/#cass-collection-append-collection
+https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassCollection/#cass-collection-append-collection
diff --git a/topics/basics/client_side_timestamps/README.md b/topics/basics/client_side_timestamps/README.md
@@ -63,5 +63,5 @@ cass_batch_set_timestamp(batch, 123456789);
 /* Add statments to batch */
 ```
 
-[`CassStatement`]: http://datastax.github.io/cpp-driver/api/struct.CassStatement/
-[`CassBatch`]: http://datastax.github.io/cpp-driver/api/struct.CassBatch/
+[`CassStatement`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassStatement/
+[`CassBatch`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassBatch/
diff --git a/topics/basics/consistency/README.md b/topics/basics/consistency/README.md
@@ -81,7 +81,7 @@ level can be found
 
 ## Setting Consistency Level
 
-A ['CassStatement'](http://datastax.github.io/cpp-driver/api/struct.CassFuture/) object
+A ['CassStatement'](https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassFuture/) object
 can have its consistency level altered at anytime before the statement is
 executed by the session.
 
diff --git a/topics/basics/data_types/README.md b/topics/basics/data_types/README.md
@@ -132,13 +132,13 @@ cass_tuple_free(address);
 cass_collection_free(phone_numbers);
 ```
 
-[`CassDataType`]: http://datastax.github.io/cpp-driver/api/struct.CassDataType/
-[`CassUserType`]: http://datastax.github.io/cpp-driver/api/struct.CassUserType/
-[`CassPrepared`]: http://datastax.github.io/cpp-driver/api/struct.CassPrepared/
-[`CassResult`]: http://datastax.github.io/cpp-driver/api/struct.CassResult/
-[`CassValue`]: http://datastax.github.io/cpp-driver/api/struct.CassValue/
-[`CassSchemaMeta`]: http://datastax.github.io/cpp-driver/api/struct.CassSchemaMeta/
-[`cass_user_type_new_from_data_type()`]: http://datastax.github.io/cpp-driver/api/struct.CassUserType/#cass-user-type-new-from-data-type
-[`cass_result_column_data_type()`]: http://datastax.github.io/cpp-driver/api/struct.CassResult/#cass-result-column-data-type
-[`cass_prepared_parameter_data_type()`]: http://datastax.github.io/cpp-driver/api/struct.CassPrepared/#cass-prepared-parameter-data-type
-[`cass_value_data_type()`]: http://datastax.github.io/cpp-driver/api/struct.CassValue/#cass-value-data-type
+[`CassDataType`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassDataType/
+[`CassUserType`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassUserType/
+[`CassPrepared`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassPrepared/
+[`CassResult`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassResult/
+[`CassValue`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassValue/
+[`CassSchemaMeta`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassSchemaMeta/
+[`cass_user_type_new_from_data_type()`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassUserType/#cass-user-type-new-from-data-type
+[`cass_result_column_data_type()`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassResult/#cass-result-column-data-type
+[`cass_prepared_parameter_data_type()`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassPrepared/#cass-prepared-parameter-data-type
+[`cass_value_data_type()`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassValue/#cass-value-data-type
diff --git a/topics/basics/handling_results/README.md b/topics/basics/handling_results/README.md
@@ -1,6 +1,6 @@
 # Handling Results
 
-The [`CassResult`](http://datastax.github.io/cpp-driver/api/struct.CassResult/) object
+The [`CassResult`](https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassResult/) object
 is typically returned for `SELECT` statements. For mutations (`INSERT`, `UPDATE`,
 and `DELETE`) only a status code will be present and can be accessed using
 `cass_future_error_code()`. However, when using lightweight transactions a
@@ -28,7 +28,7 @@ void process_result(CassFuture* future) {
 
 The result object represents a collection of rows. The first row, if present,
 can be obtained using `cass_result_first_row()`. Multiple rows are accessed
-using a [`CassIterator`](http://datastax.github.io/cpp-driver/api/struct.CassIterator/)
+using a [`CassIterator`](https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassIterator/)
 object. After a row has been retrieved, the column value(s) can be accessed from
 a row by either index or by name. The iterator object can also be used with
 enumerated column values.
@@ -51,7 +51,7 @@ void process_first_row_by_name(const CassResult* result) {
 }
 ```
 
-Once the [`CassValue`](http://datastax.github.io/cpp-driver/api/struct.CassValue/)
+Once the [`CassValue`](https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassValue/)
 has been obtained from the column, the actual value can be retrieved and
 assigned into the proper datatype.
 
@@ -131,7 +131,7 @@ void iterator_over_map_value(CassFuture* future) {
 
 When communicating with Cassandra 2.0 or later, large result sets can be divided
 into multiple pages automatically. The
-[`CassResult`](http://datastax.github.io/cpp-driver/api/struct.CassResult/) object
+[`CassResult`](https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassResult/) object
 keeps track of the pagination state for the sequence of paging queries. When
 paging through the result set, the result object is checked to see if more pages
 exist where it is then attached to the statement before re-executing the query
@@ -187,6 +187,6 @@ accessed using [`cass_result_paging_state()`] and added to a statement using
 untrusted environments. That paging state could be spoofed and potentially used
 to gain access to other data.
 
-[`cass_statement_set_paging_state()`]: http://datastax.github.io/cpp-driver/api/struct.CassStatement/#cass-statement-set-paging-state
-[`cass_result_paging_state()`]: http://datastax.github.io/cpp-driver/api/struct.CassResult/#cass-result-paging-state
-[`cass_statement_set_paging_state_token()`]: http://datastax.github.io/cpp-driver/api/struct.CassStatement/#cass-statement-set-paging-state-token
+[`cass_statement_set_paging_state()`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassStatement/#cass-statement-set-paging-state
+[`cass_result_paging_state()`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassResult/#cass-result-paging-state
+[`cass_statement_set_paging_state_token()`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassStatement/#cass-statement-set-paging-state-token
diff --git a/topics/basics/schema_metadata/README.md b/topics/basics/schema_metadata/README.md
@@ -58,4 +58,4 @@ cass_cluster_set_use_schema(cluster, cass_false);
 
 cass_cluster_free(cluster);
 ```
-[`cass_session_get_schema_meta()`]: http://datastax.github.io/cpp-driver/api/struct.CassSession/#cass-session-get-schema-meta
+[`cass_session_get_schema_meta()`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassSession/#cass-session-get-schema-meta
diff --git a/topics/basics/tuples/README.md b/topics/basics/tuples/README.md
@@ -92,6 +92,6 @@ void iterate_tuple(const CassRow* row) {
 }
 ```
 
-[`CassTuple`]: http://datastax.github.io/cpp-driver/api/struct.CassTuple/
-[`CassUserType`]: http://datastax.github.io/cpp-driver/api/struct.CassUserType/
-[`cass_tuple_set_*()`]: http://datastax.github.io/cpp-driver/api/struct.CassTuple/#cass-tuple-set-null
+[`CassTuple`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassTuple/
+[`CassUserType`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassUserType/
+[`cass_tuple_set_*()`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassTuple/#cass-tuple-set-null
diff --git a/topics/basics/user_defined_types/README.md b/topics/basics/user_defined_types/README.md
@@ -92,7 +92,7 @@ void iterate_udt(const CassRow* row) {
   cass_iterator_free(udt_iterator);
 }
 ```
-[`CassSchemaMeta`]: http://datastax.github.io/cpp-driver/api/struct.CassSchemaMeta/
-[`CassUserType`]: http://datastax.github.io/cpp-driver/api/struct.CassUserType/
-[`CassDataType`]: http://datastax.github.io/cpp-driver/api/struct.CassDataType/
-[`cass_session_get_schema()`]: http://datastax.github.io/cpp-driver/api/struct.CassSession/#cass-session-get-schema
+[`CassSchemaMeta`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassSchemaMeta/
+[`CassUserType`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassUserType/
+[`CassDataType`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassDataType/
+[`cass_session_get_schema()`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassSession/#cass-session-get-schema
diff --git a/topics/basics/uuids/README.md b/topics/basics/uuids/README.md
@@ -63,5 +63,5 @@ cass_uint8_t version = cass_uuid_version(uuid);
 char uuid_str[CASS_UUID_STRING_LENGTH];
 cass_uuid_string(uuid, uuid_str);
 ```
-[`cass_uuid_timestamp()`]: http://datastax.github.io/cpp-driver/api/struct.CassUuid/#1a3980467a0bb6642054ecf37d49aebf1a
-[`CassUuidGen`]: http://datastax.github.io/cpp-driver/api/struct.CassUuidGen/
+[`cass_uuid_timestamp()`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassUuid/#1a3980467a0bb6642054ecf37d49aebf1a
+[`CassUuidGen`]: https://docs.datastax.com/en/developer/cpp-driver/latest/api/struct.CassUuidGen/
diff --git a/topics/configuration/README.md b/topics/configuration/README.md
diff --git a/topics/configuration/retry_policies/README.md b/topics/configuration/retry_policies/README.md
diff --git a/topics/metrics/README.md b/topics/metrics/README.md
diff --git a/topics/security/README.md b/topics/security/README.md
diff --git a/topics/security/ssl/README.md b/topics/security/ssl/README.md
diff --git a/topics/testing/README.md b/topics/testing/README.md
