CrateDB 3.x: Documentation for 3.3 turned off, so refer to sources instead

Author: amotl

docs/admin/clustering/multi-node-setup.md

@@ -191,7 +191,7 @@ discovers the rest of the cluster via the seed nodes.
 :::{TIP}
 If you are using CrateDB 3.x or below, you can use the
 [discovery.zen.ping.unicast.hosts] setting instead of
-`discovery.seed_hosts`.
+{ref}`crate-reference:discovery.seed_hosts`.
 :::
 
 (unicast-discovery)=
@@ -444,8 +444,8 @@ transport.publish_port: 4321
 [configuration]: https://cratedb.com/docs/crate/reference/en/latest/config/index.html
 [crate_home]: https://cratedb.com/docs/crate/reference/en/latest/config/environment.html#conf-env-crate-home
 [daemon]: https://en.wikipedia.org/wiki/Daemon_(computing)
-[discovery.zen.minimum_master_nodes]: https://cratedb.com/docs/crate/reference/en/3.3/config/cluster.html#discovery-zen-minimum-master-nodes
-[discovery.zen.ping.unicast.hosts]: https://cratedb.com/docs/crate/reference/en/3.3/config/cluster.html#unicast-host-discovery
+[discovery.zen.minimum_master_nodes]: https://github.com/crate/crate/blob/3.3/blackbox/docs/config/cluster.rst#discovery
+[discovery.zen.ping.unicast.hosts]: https://github.com/crate/crate/blob/3.3/blackbox/docs/config/cluster.rst#unicast-host-discovery
 [gateway.expected_data_nodes]: https://cratedb.com/docs/crate/reference/en/latest/config/cluster.html#gateway-expected-data-nodes
 [gateway.recover_after_data_nodes]: https://cratedb.com/docs/crate/reference/en/latest/config/cluster.html#gateway-recover-after-data-nodes
 [hostname]: https://en.wikipedia.org/wiki/Hostname

docs/admin/clustering/scale/kubernetes.md

@@ -121,12 +121,14 @@ because CrateDB must recover and rebalance shards as the nodes drop out.
 :::{NOTE}
 The following only applies to CrateDB versions 3.x and below.
 
-The `discovery.zen.minimum_master_nodes` setting is {ref}`no longer used
-<node-discovery>` in CrateDB versions 4.x and above.
+The [discovery.zen.minimum_master_nodes] setting is no longer used in CrateDB
+versions 4.x and above. Please refer to the current documentation section
+about {ref}`crate-reference:conf_discovery`.
 :::
 
 The [discovery.zen.minimum_master_nodes] setting affects {ref}`metadata
-master <crate-reference:concept-clusters>` election.
+master <crate-reference:concept-clusters>` election with previous versions
+of CrateDB.
 
 This setting can be changed while CrateDB is running, like so:
 
@@ -144,11 +146,11 @@ Changes to the Kubernetes controller configuration can then be deployed using
 Control][using version control].
 
 :::{CAUTION}
-If `discovery.zen.minimum_master_nodes` is set to more than the current
+If [discovery.zen.minimum_master_nodes] is set to more than the current
 number of nodes in the cluster, the cluster will disband. On the other
 hand, a number that is too small might lead to a [split-brain] scenario.
 
-Accordingly, it is important to [adjust this number carefully] when
+Accordingly, it is important to adjust this number carefully when
 scaling CrateDB.
 :::
 
@@ -185,11 +187,11 @@ However, you should only do this on a production cluster if you need to
 scale to handle a load spike quickly.
 :::
 
-[adjust this number carefully]: https://cratedb.com/docs/crate/reference/en/3.3/config/cluster.html#discovery-zen-minimum-master-nodes
+
 [containerization]: https://www.docker.com/resources/what-container
 [cratedb docker image]: https://hub.docker.com/_/crate/
 [deleted and recreated]: https://kubernetes.io/docs/concepts/cluster-administration/manage-deployment/#disruptive-updates
-[discovery.zen.minimum_master_nodes]: https://cratedb.com/docs/crate/reference/en/3.3/config/cluster.html#discovery-zen-minimum-master-nodes
+[discovery.zen.minimum_master_nodes]: https://github.com/crate/crate/blob/3.3/blackbox/docs/config/cluster.rst#discovery
 [docker]: https://www.docker.com/
 [gateway.expected_data_nodes]: https://cratedb.com/docs/crate/reference/en/latest/admin/system-information.html#recovery-expected-data-nodes
 [gateway.recover_after_data_nodes]: https://cratedb.com/docs/crate/reference/en/latest/admin/system-information.html#recovery-after-data-nodes

docs/conf.py

@@ -80,8 +80,6 @@
     r"https://www.computerhope.com/",
     # Out of service.
     r"https://s3.amazonaws.com/nyc-tlc/.*",
-    # 2025-09-29: Phased out CrateDB 3.3 docs
-    r"https://cratedb.com/docs/crate/reference/en/3.3/",
     # 403 Client Error: Forbidden for url
     r"https://docs.docker.com/",
     # 500 Server Error: Internal Server Error

docs/install/cloud/aws/ec2-setup.rst

@@ -196,7 +196,7 @@ discovery by availability zone::
 
 See also :ref:`crate-reference:discovery.ec2.availability_zones`.
 
-.. _3.3: https://cratedb.com/docs/crate/reference/en/3.3/config/cluster.html#discovery
+.. _3.3: https://github.com/crate/crate/blob/3.3/blackbox/docs/config/cluster.rst#discovery
 .. _Amazon EC2: https://aws.amazon.com/ec2/
 .. _assign them with an IAM role: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/attach-iam-role.html
 .. _AWS guide: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html

docs/install/cloud/azure/vm.rst

@@ -174,7 +174,7 @@ We need to allow the ports CrateDB uses through the Windows Firewall
 Start crate by running ``bin/crate``.
 
 
-.. _3.3: https://cratedb.com/docs/crate/reference/en/3.3/config/cluster.html#discovery
+.. _3.3: https://github.com/crate/crate/blob/3.3/blackbox/docs/config/cluster.rst#discovery
 .. _Java JDK installed: https://www.oracle.com/java/technologies/downloads/#java8
 .. _latest: https://cratedb.com/docs/crate/reference/en/latest/config/cluster.html#discovery
 .. _Learn how to install here: https://docs.microsoft.com/en-us/cli/azure/install-azure-cli