[GR-59084] Revise descriptions for Maven artifacts.

PullRequest: graalpython/3520

Author: fniephaus

README.md

@@ -54,20 +54,20 @@ Refer to our [embedding documentation](https://www.graalvm.org/latest/reference-
   <dependency>
       <groupId>org.graalvm.polyglot</groupId>
       <artifactId>polyglot</artifactId>
-      <version>24.1.0</version>
+      <version>24.1.1</version>
   </dependency>
   <dependency>
       <groupId>org.graalvm.polyglot</groupId>
       <artifactId>python</artifactId>
-      <version>24.1.0</version>
+      <version>24.1.1</version>
       <type>pom</type>
   </dependency>
   ```
 
 * Gradle
   ```kotlin
-  implementation("org.graalvm.polyglot:polyglot:24.1.0")
-  implementation("org.graalvm.polyglot:python:24.1.0")
+  implementation("org.graalvm.polyglot:polyglot:24.1.1")
+  implementation("org.graalvm.polyglot:python:24.1.1")
   ```
 
 </details>
@@ -85,12 +85,12 @@ Thanks to our integration with GraalVM Native Image, we can deploy Python applic
 * Linux
 
   The easiest way to install GraalPy on Linux is to use [Pyenv](https://github.com/pyenv/pyenv) (the Python version manager).
-  To install version 24.1.0 using Pyenv, run the following commands:
+  To install version 24.1.1 using Pyenv, run the following commands:
   ```bash
-  pyenv install graalpy-24.1.0
+  pyenv install graalpy-24.1.1
   ```
   ```bash
-  pyenv shell graalpy-24.1.0
+  pyenv shell graalpy-24.1.1
   ```
   > NOTE: There will be a delay between GraalPy release and its availability on Pyenv. Make sure to update Pyenv.
   
@@ -102,12 +102,12 @@ Thanks to our integration with GraalVM Native Image, we can deploy Python applic
 * macOS
 
   The easiest way to install GraalPy on macOS is to use [Pyenv](https://github.com/pyenv/pyenv) (the Python version manager).
-  To install version 24.1.0 using Pyenv, run the following commands:
+  To install version 24.1.1 using Pyenv, run the following commands:
   ```bash
-  pyenv install graalpy-24.1.0
+  pyenv install graalpy-24.1.1
   ```
   ```bash
-  pyenv shell graalpy-24.1.0
+  pyenv shell graalpy-24.1.1
   ```
   > NOTE: There will be a delay between GraalPy release and its availability on Pyenv. Make sure to update Pyenv.
 
@@ -120,20 +120,20 @@ Thanks to our integration with GraalVM Native Image, we can deploy Python applic
       ```
       For example:
       ```bash
-      sudo xattr -r -d com.apple.quarantine ~/.pyenv/versions/graalpy-24.1.0
+      sudo xattr -r -d com.apple.quarantine ~/.pyenv/versions/graalpy-24.1.1
       ```
   3. Uncompress the file and update your `PATH` environment variable to include to the _graalpy-XX.Y.Z-macos-amd64/bin_ (or _graalpy-XX.Y.Z-macos-aarch64/bin_) directory.
 
 * Windows
 
   The Windows support of GraalPy is still experimental, so not all features and packages may be available.
   The easiest way to install GraalPy on Windows is to use [Pyenv-win](https://pyenv-win.github.io/pyenv-win/) (the Python version manager for Windows).
-  To install version 24.1.0 using Pyenv-win, run the following commands:
+  To install version 24.1.1 using Pyenv-win, run the following commands:
   ```cmd
-  pyenv install graalpy-24.1.0-windows-amd64
+  pyenv install graalpy-24.1.1-windows-amd64
   ```
   ```cmd
-  pyenv shell graalpy-24.1.0-windows-amd64
+  pyenv shell graalpy-24.1.1-windows-amd64
   ```
   > NOTE: There will be a delay between GraalPy release and its availability on Pyenv. Make sure to update Pyenv.
 
@@ -179,7 +179,7 @@ To run Jython scripts, you need to use a GraalPy distribution running on the JVM
       ```
       For example:
       ```bash
-      sudo xattr -r -d com.apple.quarantine ~/.pyenv/versions/graalpy-24.1.0
+      sudo xattr -r -d com.apple.quarantine ~/.pyenv/versions/graalpy-24.1.1
       ```
   3. Uncompress the file and update your `PATH` environment variable to include to the _graalpy-jvm-XX.Y.Z-macos-amd64/bin_ (or _graalpy-jvm-XX.Y.Z-macos-aarch64/bin_) directory.
   4. Run your scripts with `graalpy --python.EmulateJython`.

mx.graalpython/suite.py

@@ -1,4 +1,4 @@
-# pylint: disable=anomalous-backslash-in-string
+# pylint: disable=anomalous-backslash-in-string,line-too-long
 suite = {
     # --------------------------------------------------------------------------------------------------------------
     #
@@ -13,7 +13,7 @@
     "graalpython:pythonVersion": "3.11.7",
     "release": False,
     "groupId": "org.graalvm.python",
-    "url": "http://www.graalvm.org/",
+    "url": "http://www.graalvm.org/python",
 
     "developer": {
         "name": "GraalVM Development",
@@ -943,7 +943,7 @@
             "distDependencies": [
                 "sdk:POLYGLOT",
             ],
-            "description": "GraalPy, an implementation of the Python language in Java, optimized for Graal. This artifact provides convenience APIs to make embedding GraalPy with Python packages easier.",
+            "description": "GraalPy, a high-performance embeddable Python 3 runtime for Java. This artifact provides convenience APIs to embed GraalPy into Java applications. Use this dependency if you install additional Python packages with the Maven or Gradle plugins for GraalPy.",
             "maven": {
                 "groupId": "org.graalvm.python",
                 "artifactId": "python-embedding",
@@ -966,7 +966,7 @@
             "distDependencies": [
                 "sdk:POLYGLOT",
             ],
-            "description": "GraalPy, an implementation of the Python language in Java, optimized for Graal. This artifact contains utilities for tools that want to integrate GraalPy packages into the build process of Java applications.",
+            "description": "GraalPy, a high-performance embeddable Python 3 runtime for Java. This artifact contains utilities for tools that want to integrate GraalPy packages into the build process of Java applications.",
             "maven": {
                 "groupId": "org.graalvm.python",
                 "artifactId": "python-embedding-tools",
@@ -1019,7 +1019,7 @@
                 "sdk:MAVEN_DOWNLOADER",
                 "sdk:NATIVEIMAGE",
             ],
-            "description": "GraalPy, an implementation of the Python language in Java, optimized for Graal. This artifact provides a command-line launcher for GraalPy.",
+            "description": "GraalPy, a high-performance embeddable Python 3 runtime for Java. This artifact provides a command-line launcher for GraalPy.",
             "maven": {
                 "groupId": "org.graalvm.python",
                 "artifactId": "python-launcher",
@@ -1092,7 +1092,7 @@
                 "java.base",
             ],
             "compress": True,
-            "description": "GraalPy, an implementation of the Python language in Java, optimized for Graal. This artifact includes the GraalPy standard library.",
+            "description": "GraalPy, a high-performance embeddable Python 3 runtime for Java. This artifact includes the GraalPy standard library. It is not recommended to depend on the artifact directly. Instead, use \'org.graalvm.polyglot:python\' or \'org.graalvm.polyglot:python-community\' to ensure all dependencies are pulled in correctly.",
             "maven": {
                 "artifactId": "python-resources",
                 "groupId": "org.graalvm.python",
@@ -1150,7 +1150,7 @@
             "javaProperties": {
                 "python.jni.library": "<lib:pythonjni>"
             },
-            "description": "GraalPy, an implementation of the Python language in Java, optimized for Graal. This artifact includes the core language runtime without standard libraries.",
+            "description": "GraalPy, a high-performance embeddable Python 3 runtime for Java. This artifact includes the core language runtime without standard libraries. It is not recommended to depend on the artifact directly. Instead, use \'org.graalvm.polyglot:python\' or \'org.graalvm.polyglot:python-community\' to ensure all dependencies are pulled in correctly.",
             "maven": {
                 "artifactId": "python-language",
                 "groupId": "org.graalvm.python",
@@ -1171,7 +1171,7 @@
                 "GRAALPYTHON_RESOURCES",
                 "truffle:TRUFFLE_RUNTIME",
             ],
-            "description": "GraalPy, an implementation of the Python language in Java, optimized for Graal. This is a meta POM that pulls in GraalPy and the community edition of Truffle.",
+            "description": "GraalPy, a high-performance embeddable Python 3 runtime for Java. This POM dependency pulls in GraalPy dependencies and Truffle Community Edition.",
             "maven": {
                 "groupId": "org.graalvm.python",
                 "artifactId": "python-community",