Follow reviewers suggestions

docs/enterprise-overview/overview.md

@@ -37,4 +37,4 @@ Start with installing Oracle GraalVM by following the [installation guide](../ge
 
 Whether you are new to Oracle GraalVM and Native Image or have little experience using it, continue to [Getting Started](../reference-manual/native-image/README.md).
 
-Developers, who have Oracle GraalVM already installed or have experience using it in the past, can proceed to the [Reference Manuals](../reference-manual/reference-manuals.md) for in-depth coverage.
+Developers who already have Oracle GraalVM installed, or have experience using it, should proceed to the [Reference Manuals](../reference-manual/reference-manuals.md) for in-depth coverage.

docs/enterprise-overview/solutions.md

@@ -5,19 +5,19 @@ permalink: /solutions-overview/
 
 # Oracle GraalVM
 
-## Challenges Today’s Businesses Face
+## Challenges Faced By Today’s Businesses
 
-Today’s online global enterprises and microservices alike face the same needs:
-achieving better performance, and reducing ever-increasing infrastructure costs.
+Today’s online global enterprises and microservices alike face the same challenges:
+achieve better performance, and reduce ever-increasing infrastructure costs.
 The evolution from older, layered architectures to microservices requires new,
-innovative approaches to running a business either on premises or on the cloud.
+innovative approaches to running a business either on premises or in the cloud.
 
-Speed, dexterity, and leanness are key, then, to commanding the modern
+Speed, dexterity, and leanness are key, then, to command the modern
 online marketplace.
 
 ## Faster, Smaller, Leaner Applications
 
-Oracle GraalVM is a foundation for innovation and improvement for both large
+Oracle GraalVM is the foundation for innovation and improvement for both large
 enterprise applications and microservices alike.
 
 Built on trusted and secure Oracle Java SE, Oracle GraalVM accelerates
@@ -28,25 +28,24 @@ In data centers with ever-growing workloads, being able to service more
 requests with the same computing infrastructure reduces the need to purchase
 additional hardware. Thus Oracle GraalVM's reduction of required compute
 resources can lower capital cost expenditures on premise and lower operation
-costs on cloud.
+costs in the cloud.
 
 ## Trusted Oracle Support and Updates
 
-Oracle GraalVM customers take advantage of 24/7 access to the experienced Oracle GraalVM
+Oracle GraalVM customers can take advantage of 24/7 access to the experienced Oracle GraalVM
 support team who work closely with the Oracle Java support team.
 
 Oracle GraalVM releases include all Oracle Java critical patch updates
-(CPUs) which are released on a regular schedule to remedy defects and known
-vulnerabilities.
+(CPUs) which are released on a regular schedule to remedy defects and known vulnerabilities.
 
 ### Summary
 
 Start using Oracle GraalVM and:
-* reduce IT and storage costs
-* provide customers with quicker response time
+* reduce your IT and storage costs
+* provide your customers with quicker response times
 * employ fewer resources, freeing up CPU
 * enjoy seamless language interoperability
-* take advantage of full support
+* take advantage of Oracle's full support
 * receive regularly scheduled updates
 * rest assured with the security and stability of Java
 

docs/enterprise-overview/support.md

@@ -14,7 +14,7 @@ Oracle GraalVM is available for Linux, macOS, and Windows platforms on x64 syste
 
 ## Certified Platforms
 
-The following are the certified platforms for Oracle GraalVM:
+The following platforms are certified for Oracle GraalVM:
 
 | Operating System 	| Version 	| Architecture 	| Installation Guide 	|
 |------------------------------------	|--------------	|--------------	|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------	|
@@ -25,11 +25,11 @@ The following are the certified platforms for Oracle GraalVM:
 
 ## Features Support
 
-Oracle GraalVM features are distributed as fully supported and experimental.
+Oracle GraalVM features are distributed as _fully supported_ or _experimental_.
 
-Experimental features are being considered for future versions of Oracle GraalVM.
-They are not meant to be used in production and are not supported by Oracle.
-The development team welcomes feedback on experimental features, but users should be aware that experimental features might never be included in a final version, or might change significantly before being considered production-ready.
+_Experimental_ features are being considered for future versions of Oracle GraalVM.
+They are not meant for use in production and are **not** supported by Oracle.
+The development team welcomes feedback on experimental features, but users should be aware that experimental features may not be included in a final version, or may change significantly before being considered production-ready.
 
 For more information, check the [Graal Free Terms and Conditions (GFTC) including License for Early Adopter Versions](https://www.oracle.com/downloads/licenses/graal-free-license.html).
 

docs/getting-started/graalvm-community/container-images/graalvm-ce-container-images.md

@@ -87,4 +87,4 @@ Version: truffleruby 22.3.1, like ruby 3.0.3, GraalVM CE Native [x86_64-darwin]
 
 Check what other configuration types of container images are available [here](https://github.com/graalvm/container). 
 
-If you look for Oracle GraalVM container images, they are published in the [Oracle Container Registry](https://container-registry.oracle.com/ords/f?p=113:10::::::).
+If you are looking for Oracle GraalVM container images, they are published in the [Oracle Container Registry](https://container-registry.oracle.com/ords/f?p=113:10::::::).

docs/getting-started/graalvm-community/installation.md

@@ -6,7 +6,7 @@ permalink: /docs/installation/
 redirect_from: /docs/getting-started/
 ---
 
-# GraalVM Installation
+# 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.
 
@@ -36,7 +36,7 @@ $JAVA_HOME/bin/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.
 
-Compile this simplest _HelloWorld.java_ application to bytecode and then build a native executable:
+Compile this simple _HelloWorld.java_ application to bytecode and then build a native executable:
 ```java
 public class HelloWorld {
   public static void main(String[] args) {
@@ -65,7 +65,7 @@ Hello, World!
 
 ### New Users
 
-Continue to [Native Image basics](../../reference-manual/native-image/NativeImageBasics.md) to gradually educate yourself about the technology.
+Continue to [Native Image basics](../../reference-manual/native-image/NativeImageBasics.md) for more information about the technology.
 For users who are familiar with GraalVM Native Image but may have little experience using it, proceed to [User Guides](../../reference-manual/native-image/guides/guides.md).
 
 For more information on the Graal compiler, see the [compiler documentation](../../reference-manual/java/compiler.md). 

docs/getting-started/graalvm-community/linux.md

@@ -14,16 +14,15 @@ You can install GraalVM on Linux from an archive (_.tar.gz_) for the current use
 Follow these steps to install GraalVM: 
 
 1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **17** or **20** for the Java version, **Linux** for the operating system, **x64** or **aarch64** for the architecture, and download. It will download Oracle GraalVM. 
-To download GraalVM Community Edition, go to the [GraalVM Releases repository on GitHub](https://github.com/graalvm/graalvm-ce-builds/releases).
 
-2. Change directory to the location where you want to install GraalVM, then move the _.tar.gz_ file to that directory.
+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-ce-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:
-  - Point the `PATH` environment variable to the GraalVM _bin_ directory:
+  - Set the value of the `PATH` environment variable to the GraalVM _bin_ directory:
     ```shell
     export PATH=/path/to/<graalvm>/bin:$PATH
     ```

docs/getting-started/graalvm-community/macos.md

@@ -13,8 +13,7 @@ Note that on macOS the JDK installation path is: _/Library/Java/JavaVirtualMachi
 
 Follow these steps to install GraalVM: 
 
-1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **17** or **20** for the Java version, **macOS** for the operating system, **x64** or **aarch64** for the architecture, and download. It will download Oracle GraalVM. 
-To download GraalVM Community Edition, go to the [GraalVM Releases repository on GitHub](https://github.com/graalvm/graalvm-ce-builds/releases).
+1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **17** or **20** for the Java version, **macOS** for the operating system, **x64** or **aarch64** for the architecture, and download. It will download Oracle GraalVM.
 
 2. Unzip the archive.
     ```shell
@@ -34,7 +33,7 @@ To download GraalVM Community Edition, go to the [GraalVM Releases repository on
   To verify if the move is successful and to get a list of all installed JDKs, run `/usr/libexec/java_home -V`.
 
 4. There can be multiple JDKs installed on the machine. The next step is to configure the runtime environment:
-  - Point the `PATH` environment variable to the GraalVM _bin_ directory:
+  - Set the value of the `PATH` environment variable to the GraalVM _bin_ directory:
     ```shell
     export PATH=/Library/Java/JavaVirtualMachines/<graalvm>/Contents/Home/bin:$PATH
     ```

docs/getting-started/graalvm-community/windows.md

@@ -12,15 +12,14 @@ You can install it on Windows from an archive file (_zip_).
 
 Follow these steps to install GraalVM: 
 
-1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **17** or **20** for the Java version, **Windows** for the operating system, and download. It will download Oracle GraalVM. 
-To download GraalVM Community Edition, go to the [GraalVM Releases repository on GitHub](https://github.com/graalvm/graalvm-ce-builds/releases).
+1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **17** or **20** for the Java version, **Windows** for the operating system, and download. It will download Oracle GraalVM.
 
-2. Change the directory to the location where you want to install GraalVM, then move the _.zip_ archive file to it.
+2. Change to the directory where you want to install GraalVM, then move the _.zip_ archive file to it.
 
 3. Unzip the archive to your file system.
 
 4. There can be multiple JDKs installed on the machine. The next step is to configure the runtime environment. Setting environment variables via the command line will work the same way for Windows 8, 10, and 11.
-  - Point the `PATH` environment variable to the GraalVM _bin_ directory:
+  - Set the value of the `PATH` environment variable to the GraalVM _bin_ directory:
     ```shell
     setx /M PATH "C:\Progra~1\Java\<graalvm>\bin;%PATH%"
     ```
@@ -39,11 +38,11 @@ To download GraalVM Community Edition, go to the [GraalVM Releases repository on
 Alternatively, you can set up environment variables through a Windows GUI:
 
 1. Go to Windows Start Menu - Settings - ... - Advanced.
-2. Click **Environment Variables**. In the section System Variables find the `JAVA_HOME` variable and select it.
+2. Click **Environment Variables**. In the section "System Variables" find the `JAVA_HOME` variable and select it.
 3. Click **Edit**.
 4. Click **New**.
 5. Click **Browse** to find the directory to add. Confirm by clicking **OK**.
-6. Restart Command Prompt to reload the environment variables.
+6. Restart the Command Prompt to reload the environment variables.
 
 Repeat the same for the `PATH` environment variable.
 

docs/getting-started/graalvm-enterprise/installation-linux.md

@@ -9,7 +9,7 @@ Oracle GraalVM is available for Linux on x64 and AArch64 architectures.
 You can install Oracle GraalVM on Linux from an archive (_.tar.gz_) for the current user into any location, without affecting other JDK installations.
 
 ### Note on AArch64 Distribution
-This distribution can be installed on Oracle Linux and Red Hat Enterprise Linux(RHEL) systems for the AArch64 architecture.
+This distribution can be installed on Oracle Linux and Red Hat Enterprise Linux (RHEL) systems for the AArch64 architecture.
 
 Follow these steps to install Oracle GraalVM:
 
@@ -23,7 +23,7 @@ Select the preferred Oracle GraalVM version, **17** or **20** for the Java versi
     tar -xzf graalvm-jdk-<version>_linux-<architecture>.tar.gz
     ```
 4. There can be multiple JDKs installed on your machine. The next step is to configure your runtime environment:
-  - Point the `PATH` environment variable to the Oracle GraalVM _bin_ directory:
+  - Set the value of the `PATH` environment variable to the GraalVM _bin_ directory:
     ```shell
     export PATH=/path/to/<graalvm>/bin:$PATH
     ```

docs/getting-started/graalvm-enterprise/installation-macos.md

@@ -32,7 +32,7 @@ Select the preferred Oracle GraalVM version, **17** or **20** for the Java versi
 To verify if the move is successful and to get a list of all installed JDKs, run `/usr/libexec/java_home -V`.
 
 4. There can be multiple JDKs installed on the machine. The next step is to configure the runtime environment:
-  - Point the `PATH` environment variable to the Oracle GraalVM _bin_ directory:
+  - Set the value of the `PATH` environment variable to the GraalVM _bin_ directory:
     ```shell
     export PATH=/Library/Java/JavaVirtualMachines/<graalvm>/Contents/Home/bin:$PATH
     ```

docs/getting-started/graalvm-enterprise/installation-windows.md

@@ -17,7 +17,7 @@ Select the preferred Oracle GraalVM version, **17** or **20** for the Java versi
 3. Unzip the archive to your file system.
 
 4. There can be multiple JDKs installed on the machine. The next step is to configure the runtime environment. Setting environment variables via the command line will work the same way for Windows 8, 10, and 11.
-  - Point the `PATH` environment variable to the Oracle GraalVM _bin_ directory:
+  - Set the value of the `PATH` environment variable to the GraalVM _bin_ directory:
     ```shell
     setx /M PATH "C:\Progra~1\Java\<graalvm>\bin;%PATH%"
     ```

docs/introduction.md

@@ -37,9 +37,9 @@ See the [installation guide](getting-started/graalvm-community/installation.md)
 
 ## Features Support
 
-GraalVM technologies are distributed as supported and experimental.
+GraalVM technologies are distributed as _supported_ or _experimental_.
 
-Experimental features are being considered for future versions of GraalVM and are not meant to be used in production.
+_Experimental_ features are being considered for future versions of GraalVM and are **not** meant to be used in production.
 The development team welcomes feedback on experimental features, but users should be aware that experimental features might never be included in a final version, or might change significantly before being considered stable.
 
 The following table lists stable and experimental features in GraalVM Community Edition by platform.