Install: Implement suggestions by CodeRabbit

Author: amotl

docs/install/cloud/aws/aws-terraform-setup.md

@@ -2,7 +2,7 @@
 
 # Deploy using Terraform
 
-In {ref}`ec2_setup`, we elaborated on how to leverage EC2's functionality to set
+In {ref}`ec2-setup`, we elaborated on how to leverage EC2's functionality to set
 up a CrateDB cluster. Here, we will explore how to automate this kind of setup.
 
 [Terraform] is an infrastructure as code tool, often used as an abstraction

docs/install/cloud/aws/s3-setup.md

@@ -25,8 +25,8 @@ instances.
 
 ### Authentication
 
-It is recommended to restrict the permissions of CrateDB on the S3 to only the
-required extend. First, an IAM role is required. This [AWS guide] gives a
+It is recommended to restrict the permissions of CrateDB on S3 to only the
+required extent. First, an IAM role is required. This [AWS guide] gives a
 short description of how to create a policy offer using the CLI or the AWS
 management console. Further, access of the snapshot to the S3 bucket needs to
 be restricted. An example policy file granting anybody access to a bucket

docs/install/cloud/azure/terraform.md

@@ -2,7 +2,7 @@
 
 # Deploy using Terraform
 
-In {ref}`azure_vm_setup`, we elaborated on how to leverage Azure's functionality to
+In {ref}`azure-vm-setup`, we elaborated on how to leverage Azure's functionality to
 set up a CrateDB cluster. Here, we will explore how to automate this kind of
 setup.
 

docs/install/cloud/azure/vm.md

@@ -149,7 +149,7 @@ VM based on the 'Windows Server 2012 R2 Datacenter' image.
 *Note that these instructions should be followed on each VM in your cluster.*
 
 To install CrateDB on Windows Server, you will need a [Java JDK installed].
-Ensure that the `JAVA*HOME` environment variable is set.
+Ensure that the `JAVA_HOME` environment variable is set.
 
 ```{image} /_assets/img/install/cloud/azure-envvar.png
 :alt: Environment Variables

docs/install/container/docker.md

@@ -22,6 +22,8 @@ The official [CrateDB Docker image].
 
 ## Quick start
 
+(container-create-cluster)=
+
 ### Creating a cluster
 
 To get started with CrateDB and Docker, you will create a three-node cluster
@@ -55,7 +57,7 @@ container `crate03` will run cluster node `crate03`.
 
 You can then create your first CrateDB container and node, like this:
 
-```
+```shell
 sh$ docker run --rm -d \
       --name=crate01 \
       --net=crate \
@@ -79,7 +81,7 @@ Breaking the command down:
   {ref}`docker-compose` as reference).
 - Puts the container into the `crate` network and maps port `4201` on your
   host machine to port `4200` on the container (admin UI).
-- Defines the environment variable:ref:`CRATE_HEAP_SIZE <manual:conf-env-heap-size>`,
+- Defines the environment variable {ref}`CRATE_HEAP_SIZE <manual:conf-env-heap-size>`,
   which is used by CrateDB to allocate 1 GB for its heap memory.
 - Runs the command `crate` inside the container with parameters:
   : - `network.host`: The `_site_` value results in the binding of the
@@ -250,7 +252,8 @@ The CrateDB Shell, `crash`, is bundled with the Docker image.
 
 If you wanted to run `crash` inside a user-defined network called `crate`
 and connect to three hosts named `crate01`, `crate02`, and `crate03`
-(i.e. the example covered in the [Creating a Cluster] section) you could run:
+(i.e. the example covered in the {ref}`container-create-cluster` section)
+you could run:
 
 ```shell
 $ docker run --rm -ti \

docs/install/container/kubernetes/kubernetes.md

@@ -6,7 +6,7 @@
 CrateDB and Kubernetes are a great match.
 :::
 
-CrateDB’s [horizontally scalable] `shared-nothing architecture` lends itself
+CrateDB’s [horizontally scalable] [shared-nothing architecture] lends itself
 well to [containerization].
 
 [Kubernetes] is an open-source container orchestration system for the

docs/install/debian-ubuntu.md

@@ -4,13 +4,13 @@
 (install-debian)=
 (install-ubuntu)=
 
-# CrateDB on Debian, Ubuntu, and Derivates
+# CrateDB on Debian, Ubuntu, and derivatives
 
 :::{div} sd-text-muted
 Install CrateDB [deb] packages using the [apt] package manager.
 :::
 
-This installation method is suitable for Debian systems and derivates
+This installation method is suitable for Debian systems and derivatives
 like Ubuntu.
 
 ## Package repository

docs/install/redhat.md

@@ -3,7 +3,7 @@
 (install-redhat)=
 (install-suse)=
 
-# CrateDB on Red Hat, SUSE, and Derivates
+# CrateDB on Red Hat, SUSE, and derivatives
 
 :::{div} sd-text-muted
 Install CrateDB [RPM] packages using the [DNF], [YUM], or [ZYpp] package managers.

docs/install/windows.md

@@ -16,6 +16,11 @@ us][contact us] so we can work with you on a solution.
    command-line shell or by using a GUI tool like [7-Zip]. We recommend
    using [PowerShell] when using terminal:
 
+   ```powershell
+   # Extract Zip archive
+   Expand-Archive -Path .\crate-*.zip -DestinationPath .
+   ```
+
    ```doscon
    # Extract Zip archive
    unzip -o crate-*.zip