Ongoing editing

README.md

@@ -3,11 +3,11 @@
 [![Build Status](https://github.com/radical-cybertools/radical.pilot/actions/workflows/ci.yml/badge.svg)](https://github.com/radical-cybertools/radical.pilot/actions/workflows/ci.yml)
 [![codecov](https://codecov.io/gh/radical-cybertools/radical.pilot/branch/devel/graph/badge.svg)](https://codecov.io/gh/radical-cybertools/radical.pilot)
 
-RADICAL-Pilot (RP) executes workloads made of heterogeneous tasks with maximum concurrency and at scale. 
+RADICAL-Pilot (RP) executes heterogeneous tasks with maximum concurrency and at scale. 
 
-RP is a Pilot system, i.e., it separates resource acquisition from using those resources to execute application tasks. Resources are acquired by submitting a job to the batch system of an HPC machine. Once the job is scheduled on the requested resources, RP can directly schedule and launch computational tasks on those resources. Thus, tasks are not scheduled via the batch system of the HPC platform, but directly on the acquired resources.
+RP is a [Pilot system](https://doi.org/10.1145/3177851), i.e., it separates resource acquisition from using those resources to execute application tasks. Resources are acquired by submitting a job to an HPC platform and RP can directly schedule and launch computational tasks on those resources. Thus, tasks are directly scheduled on the acquired resources, not via the batch system of the HPC platform.
 
-RP is written in Python and exposes a simple yet powerful API. In 15 lines of code you can execute an arbitrary number of arbitrary executables with maximum concurrency on your Linux machine or, by changing a key of a dictionary, on the largest HPC platforms available to scientists.
+RP is written in Python and exposes a simple yet powerful [API](https://radicalpilot.readthedocs.io/en/stable/apidoc.html). In 15 lines of code you can execute an arbitrary number of executables with maximum concurrency on a [Linux container]() or, by changing `resource`, on the [supported HPC platforms](https://radicalpilot.readthedocs.io/en/stable/supported.html).
 
 ```python
 import radical.pilot as rp
@@ -49,14 +49,9 @@ Additional information is provided in the [wiki](https://github.com/radical-cybe
 
 ## Code
 
-Generally, the `master` branch reflects the RP release published on
-[PyPI](https://pypi.org/project/radical.pilot/), and is considered stable:
-it should work 'out of the box' for the supported backends. For a list of
-supported backends, please refer to the documentation.
+Generally, the `master` branch reflects the RP release published on [PyPI](https://pypi.org/project/radical.pilot/), and is considered stable: it should work 'out of the box' for the supported backends. For a list of supported backends, please refer to the documentation.
 
-The `devel` branch (and any branch other than master) may not correspond to the
-published documentation and, specifically, may have dependencies which need to
-be resolved manually.
+The `devel` branch (and any branch other than master) may not correspond to the published documentation and, specifically, may have dependencies which need to be resolved manually.
 
 ## Integration Tests status
 These badges show the state of the current integration tests on different HPCs RADICAL Pilot supports