Fold GraalVM CE and Oracle GraalVM install guides into one and add more install options

olyagpl · olyagpl · commit 5a8c9050a870 · 2024-07-17T12:59:36.000+03:00
diff --git a/docs/getting-started/graalvm-community/get-started-graalvm-community.md b/docs/getting-started/graalvm-community/get-started-graalvm-community.md
@@ -7,11 +7,10 @@ permalink: /docs/getting-started/
 
 # Getting Started with GraalVM
 
-GraalVM compiles your Java applications ahead of time into standalone binaries that start instantly, provide peak performance with no warmup, and use fewer resources.
-
+GraalVM is an advanced JDK with ahead-of-time Native Image compilation.
 Here you will find information about installing GraalVM and running basic applications with it.
 
-If you are new to GraalVM, we recommend starting with the [introduction to GraalVM](../../introduction.md), where you will find information about GraalVM's benefits, distributions available, supported platforms, features support, and licensing.
+If you are new to GraalVM, we recommend starting with the [introduction to GraalVM](../../introduction.md), where you will find information about GraalVM's benefits, distributions, certified platforms, available features, and licensing.
 
 If you have GraalVM already installed and have experience using it, you can skip this page and proceed to the in-depth [reference manuals](../../reference-manual/reference-manuals.md).
 
@@ -30,7 +29,7 @@ You can use the GraalVM JDK just like any other JDK in your IDE, so having insta
 The `java` launcher runs the JVM with Graal as the last-tier compiler.
 Check the installed Java version:
 ```shell
-$JAVA_HOME/bin/java -version
+java -version
 ```
 
 Using [GraalVM Native Image](../../reference-manual/native-image/README.md) you can compile Java bytecode into a platform-specific, self-contained native executable to achieve faster startup and a smaller footprint for your application.
@@ -47,6 +46,7 @@ public class HelloWorld {
 ```shell
 javac HelloWorld.java
 ```
+
 ```shell
 native-image HelloWorld
 ```
diff --git a/docs/getting-started/graalvm-community/linux.md b/docs/getting-started/graalvm-community/linux.md
@@ -8,28 +8,65 @@ permalink: /docs/getting-started/linux/
 ## Installation on Linux Platforms
 
 GraalVM is available for Linux on x64 and AArch64 architectures.
+You can install GraalVM on Linux:
+* [using SDKMAN!](#sdkman)
+* [from an archive](#from-an-archive)
+* [using script-friendly URLs](#script-friendly-urls)
 
-You can install GraalVM on Linux from an archive (_.tar.gz_) for the current user into any location, without affecting other JDK installations.
+Select the installation option that you prefer.
 
-Follow these steps to install GraalVM: 
+## SDKMAN!
 
-1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **22** for the Java version, **Linux** for the operating system, **x64** or **aarch64** for the architecture, and download.
+Install GraalVM with [SDKMAN!](https://sdkman.io/):
+```
+sdk install java 23-graalce
+```
+
+SDKMAN! helps you install and easily switch between JDKs.
+Check which GraalVM releases are available for installation by running: 
+```bash
+sdk list java
+```
+
+## From an Archive
+
+Install GraalVM from an archive (_.tar.gz_) for the current user into any location, without affecting other JDK installations.
+
+1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **23** for the Java version, **Linux** for the operating system, **x64** or **aarch64** for the architecture, and download.
 
 2. Change to directory where you want to install GraalVM, then move the _.tar.gz_ file to that directory.
 
 3. Unzip the archive:
     ```shell
     tar -xzf graalvm-jdk-<version>_linux-<architecture>.tar.gz
     ```
-4. There can be multiple JDKs installed on the machine. The next step is to configure the runtime environment:
+
+4. There can be multiple JDKs installed on the machine. Configure the runtime environment:
   - Set the value of the `JAVA_HOME` environment variable to the installation directory:
     ```shell
     export JAVA_HOME=/path/to/<graalvm>
     ```
   - Set the value of the `PATH` environment variable to the GraalVM _bin_ directory:
     ```shell
     export PATH=/path/to/<graalvm>/bin:$PATH
-    ```  
-5. To confirm that the installation was successful, run the `java -version` command.
+    ```
+
+To confirm that the installation was successful, run the `java -version` command.
+Optionally, you can specify GraalVM as the default JRE or JDK installation in your Java IDE.
+
+## Script-Friendly URLs
+
+[Script-friendly URLs](https://www.oracle.com/java/technologies/jdk-script-friendly-urls/) enable you to download GraalVM from a command line, or automatically in your script and Dockerfile by using a download URL. 
+Substitute `<version>` and `<architecture>` with the JDK version and `aarch64` or `x64` architecture.
+```bash
+# Download with wget
+wget https://download.oracle.com/graalvm/23/latest/graalvm-jdk-23_linux-<architecture>_bin.tar.gz
+
+# Download with curl
+curl https://download.oracle.com/graalvm/23/latest/graalvm-jdk-23_linux-<architecture>_bin.tar.gz
+
+# Download from archive
+curl https://download.oracle.com/java/23/archive/jdk-23_linux-<architecture>_bin.tar.gz
+```
 
-Optionally, you can specify GraalVM as the default JRE or JDK installation in your Java IDE.
+For other installation options, visit the [GraalVM Downloads page](https://www.graalvm.org/downloads/).
diff --git a/docs/getting-started/graalvm-community/macos.md b/docs/getting-started/graalvm-community/macos.md
@@ -8,12 +8,33 @@ permalink: /docs/getting-started/macos/
 ## Installation on macOS Platforms
 
 GraalVM is available for macOS on x64 and AArch64 architectures.
+You can install GraalVM on macOS:
+* [using SDKMAN!](#sdkman)
+* [from an archive](#from-an-archive)
+* [using script-friendly URLs](#script-friendly-urls)
 
 Note that on macOS the JDK installation path is: <em>/Library/Java/JavaVirtualMachines/&lt;graalvm&gt;/Contents/Home</em>.
 
-Follow these steps to install GraalVM: 
+Select the installation option that you prefer.
 
-1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **22** for the Java version, **macOS** for the operating system, **x64** or **aarch64** for the architecture, and download.
+## SDKMAN!
+
+Install GraalVM with [SDKMAN!](https://sdkman.io/):
+```
+sdk install java 23-graalce
+```
+
+SDKMAN! helps you install and easily switch between JDKs.
+Check which GraalVM releases are available for installation by running: 
+```bash
+sdk list java
+```
+
+## From an Archive
+
+Install GraalVM from an archive (_.tar.gz_) for the current user into any location, without affecting other JDK installations.
+
+1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **23** for the Java version, **macOS** for the operating system, **x64** or **aarch64** for the architecture, and download.
   
 2. Remove the quarantine attribute (required for macOS Catalina and later):
     ```shell
@@ -40,16 +61,32 @@ Follow these steps to install GraalVM:
   - Set the value of the `PATH` environment variable to the GraalVM _bin_ directory:
     ```shell
     export PATH=/Library/Java/JavaVirtualMachines/<graalvm>/Contents/Home/bin:$PATH
-    ```  
-
-6. To check whether the installation was successful, run the `java -version` command.
+    ```
 
+To confirm that the installation was successful, run the `java -version` command.
 Optionally, you can specify GraalVM as the default JRE or JDK installation in your Java IDE.
 
+## Script-Friendly URLs
+
+[Script-friendly URLs](https://www.oracle.com/java/technologies/jdk-script-friendly-urls/) enable you to download GraalVM from a command line, or automatically in your script and Dockerfile by using a download URL. 
+Substitute `<version>` and `<architecture>` with the JDK version and `aarch64` or `x64` architecture.
+```bash
+# Download with wget
+wget https://download.oracle.com/graalvm/23/latest/graalvm-jdk-23_macos-<architecture>_bin.tar.gz
+
+# Download with curl
+curl https://download.oracle.com/graalvm/23/latest/graalvm-jdk-23_macos-<architecture>_bin.tar.gz
+
+# Download from archive
+curl https://download.oracle.com/java/23/archive/jdk-23_macos-<architecture>_bin.tar.gz
+```
+
+For other installation options, visit the [GraalVM Downloads page](https://www.graalvm.org/downloads/).
+
 ## Installation Notes
 
 ### On JAVA_HOME Command
 The information property file, _Info.plist_, is in the top level _Contents_ directory.
-This means that GraalVM participates in the macOS-specific `/usr/libexec/java_home` mechanism. Depending on other JDK installation(s) available, it is now possible that `/usr/libexec/java_home -v22` returns `/Library/Java/JavaVirtualMachines/<graalvm>/Contents/Home`.
-You can run `/usr/libexec/java_home -v22 -V` to see the complete list of JVMs available to the `java_home` command. This command sorts the JVMs in decreasing version order and chooses the top one as the default for the specified version.
+This means that GraalVM participates in the macOS-specific `/usr/libexec/java_home` mechanism. Depending on other JDK installation(s) available, it is now possible that `/usr/libexec/java_home -v23` returns `/Library/Java/JavaVirtualMachines/<graalvm>/Contents/Home`.
+You can run `/usr/libexec/java_home -v23 -V` to see the complete list of JVMs available to the `java_home` command. This command sorts the JVMs in decreasing version order and chooses the top one as the default for the specified version.
 Within a specific version, the sort order appears to be stable but is unspecified.
diff --git a/docs/getting-started/graalvm-community/windows.md b/docs/getting-started/graalvm-community/windows.md
@@ -7,12 +7,16 @@ permalink: /docs/getting-started/windows/
 
 # Installation on Windows Platforms
 
-GraalVM Community Edition is available for Windows on the x64 architecture. 
-You can install it on Windows from an archive file (_zip_).
+GraalVM is available for Windows on the x64 architecture.
+We recommend installing GraalVM on Windows from an archive.
 
-Follow these steps to install GraalVM:
+* [Installing from an Archive](#installing-from-an-archive)
+* [Prerequisites for Native Image on Windows](#prerequisites-for-native-image-on-windows)
+* [Other Installation Options](#other-installation-options)
 
-1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **22** for the Java version, **Windows** for the operating system, and download.
+## Installing from an Archive
+
+1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **23** for the Java version, **Windows** for the operating system, and download.
 
 2. Change to the directory where you want to install GraalVM, then move the _.zip_ archive file to it.
 
@@ -99,4 +103,8 @@ To build a project using the [Native Build Tools Gradle plugin](https://graalvm.
 gradlew.bat nativeCompile
 ```
 
-This guide was written for Windows 11, but should be valid for Windows 8 and 10.
+This guide was written for Windows 11, but should be valid for Windows 8 and 10.
+
+## Other Installation Options
+
+For other installation options for Windows, visit the [GraalVM Downloads page](https://www.graalvm.org/downloads/).
