add badges

Author: timfel

README.md

@@ -1,25 +1,25 @@
 # GraalPy, the GraalVM Implementation of Python
 
+[![](https://img.shields.io/badge/pyenv-graalpy-blue)](#start-replacing-cpython-with-graalpy) 
+[![](https://img.shields.io/badge/maven-org.graalvm.polyglot/python-orange)](https://central.sonatype.com/artifact/org.graalvm.polyglot/python)
+</a> [![Join Slack][badge-slack]][slack] [![GraalVM on Twitter][badge-twitter]][twitter] [![License](https://img.shields.io/badge/license-UPL-green)](#license)
+
 GraalPy is a high-performance implementation of the [Python](https://www.python.org/) language for the JVM built on [GraalVM](https://www.graalvm.org/) technology.
 GraalPy has first-class support for embedding in Java and can turn Python applications into fast, standalone binaries.
 
-![](docs/showcase.png)<sup>
-[Java AWT app with Python graph library](https://github.com/timfel/graalpy-jbang) using [JBang](https://www.jbang.dev/)  |  [Standalone binary](https://github.com/timfel/racing-all-afternoon) of a Python game by [Joey Navarro](https://github.com/josephnavarro/racing-all-afternoon) with all dependencies included.
-</sup>
-
 ## Why GraalPy?
 
 **Low-overhead integration with Java and other languages.**
 
-* [Interoperate](docs/user/Interoperability.md) with Java, JavaScript, Ruby, and other languages on GraalVM JDK, Oracle JDK, or OpenJDK
+* Use [Python in Java](docs/user/Interoperability.md) applications on GraalVM JDK, Oracle JDK, or OpenJDK
 * Use JVM tools like [Maven](docs/user/PythonStandaloneBinaries.md#embedding-graalpy-in-a-java-application), JFR, or [GraalVM Native Image](docs/user/PythonNativeimages.md)
 * Manage Python libraries' system access thanks to GraalPy's [Java-based emulation of Python OS APIs](docs/user/OsInterface.md#java-backend)
 
 **Compatible with the Python ecosystem**
 
-* Use almost any standard Python feature, the CPython tests run on every commit and pass ~85%
 * Install [packages](https://pypi.org/) like *NumPy*, *PyTorch*, or *Tensorflow*; run [Hugging Face](https://huggingface.co/) models like *Stable Diffusion* or *GPT*
 * See if the packages you need work with our [Python Compatibility Checker](https://www.graalvm.org/python/compatibility/)
+* Use almost any standard Python feature, the CPython tests run on every commit and pass ~85%
 ![](docs/mcd.svg)<sup>
 We run the tests of the [top PyPI packages](https://hugovk.github.io/top-pypi-packages/) on GraalPy every day.
 For more than 96% of the top PyPI packages, there is at least one recent version that installs successfully and we are currently passing over 50% of all tests those top packages.
@@ -40,7 +40,7 @@ Geomean speedup was calculated against CPython on the intersection of benchmarks
 ## Getting Started
 
 <details>
-<summary><strong>Embedding GraalPy in Java</strong></summary>
+<summary><strong><a name="start-embedding-graalpy-in-java"></a>Embedding GraalPy in Java</strong></summary>
 
 GraalPy is [available on Maven Central](https://central.sonatype.com/artifact/org.graalvm.polyglot/python) for inclusion in Java projects.
 Refer to our [embedding documentation](https://www.graalvm.org/latest/reference-manual/embed-languages/) for more details.
@@ -69,7 +69,7 @@ Refer to our [embedding documentation](https://www.graalvm.org/latest/reference-
 </details>
 
 <details>
-<summary><strong>Replacing CPython with GraalPy</strong></summary>
+<summary><strong><a name="start-replacing-cpython-with-graalpy"></a>Replacing CPython with GraalPy</strong></summary>
 
 GraalPy should in many cases work as a drop-in replacement for CPython.
 You can use `pip` to install packages as usual.
@@ -126,20 +126,20 @@ Thanks to our integration with GraalVM Native Image, we can deploy Python applic
 
 </details>
 <details>
-<summary><strong>Using GraalPy in Github Actions</strong></summary>
+<summary><strong><a name="start-using-graalpy-in-github-actions"></a>Using GraalPy in Github Actions</strong></summary>
 
 The _setup-python_ action supports GraalPy:
 
-```
+```yaml
     - name: Setup GraalPy
-      uses: actions/setup-python@main
+      uses: actions/setup-python@v5
       with:
         python-version: graalpy # or graalpy23.1 to pin a version
 ```
 
 </details>
 <details>
-<summary><strong>Migrating Jython Scripts to GraalPy</strong></summary>
+<summary><strong><a name="start-migrating-jython-scripts-to-graalpy"></a>Migrating Jython Scripts to GraalPy</strong></summary>
 
 Most existing Jython code that uses Java integration will be based on a stable Jython release&mdash;however, these are only available in Python 2.x versions.
 To migrate your code from Python 2 to Python 3, follow [the official guide from the Python community](https://docs.python.org/3/howto/pyporting.html).
@@ -174,20 +174,25 @@ To run Jython scripts, you need to use a GraalPy distribution running on the JVM
 
 </details>
 
+### Examples
+![](docs/showcase.png)<sup>
+[Java AWT app with Python graph library](https://github.com/timfel/graalpy-jbang) using [JBang](https://www.jbang.dev/)  |  [Standalone binary](https://github.com/timfel/racing-all-afternoon) of a Python game by [Joey Navarro](https://github.com/josephnavarro/racing-all-afternoon) with all dependencies included.
+</sup>
+
 ## Documentation
 
 Our [Quick Reference Sheet](https://www.graalvm.org/uploads/quick-references/GraalPy_v1/quick-reference-graalpy-v1(eu_a4).pdf) should help you get started.
 More GraalPy-specific user documentation is available in [docs/user](docs/user).
 General documentation about [polyglot programming](https://www.graalvm.org/latest/reference-manual/polyglot-programming/) and [language embedding](https://www.graalvm.org/latest/reference-manual/embed-languages/) is available on the GraalVM website.
 
-## Contact
+## Community
 
-The best way to get in touch with us is to join the `#graalpy` channel on [GraalVM Slack](https://www.graalvm.org/slack-invitation/).
+The best way to get in touch with us is to join the `#graalpy` channel on [GraalVM Slack][slack] or write to us on [Twitter][twitter]
 
 ## Contributing
 
-If you're thinking about contributing something to this repository, you will need to sign the [Oracle Contributor Agreement](http://www.graalvm.org/community/contributors/) for us to able to merge your work.
-Please also take note of our [code of conduct](http://www.graalvm.org/community/conduct/) for contributors.
+If you're thinking about contributing something to this repository, you will need to sign the [Oracle Contributor Agreement](https://www.graalvm.org/community/contributors/) for us to able to merge your work.
+Please also take note of our [code of conduct](https://www.graalvm.org/community/conduct/) for contributors.
 
 This project welcomes contributions from the community. Before submitting a pull request, please [review our contribution guide](./CONTRIBUTING.md).
 
@@ -199,3 +204,8 @@ Please consult the [security guide](./SECURITY.md) for our responsible security
 
 This GraalVM implementation of Python is Copyright (c) 2017, 2024 Oracle and/or its affiliates and is made available to you under the terms the Universal Permissive License v 1.0 as shown at [https://oss.oracle.com/licenses/upl/](https://oss.oracle.com/licenses/upl/).
 This implementation is in part derived from and contains additional code from 3rd parties, the copyrights and licensing of which is detailed in the [LICENSE](./LICENSE.txt) and [THIRD_PARTY_LICENSE](THIRD_PARTY_LICENSE.txt) files.
+
+[badge-slack]: https://img.shields.io/badge/Slack-join-active?logo=slack
+[badge-twitter]: https://img.shields.io/badge/Twitter-@graalvm-active?logo=twitter
+[slack]: https://www.graalvm.org/slack-invitation/
+[twitter]: https://twitter.com/graalvm