Update the README for the new doc

README.md

@@ -2,84 +2,40 @@
 
 _Ready to use AppImages of Python are available as GitHub [releases][RELEASES]._
 
-## Quickstart
-
-We provide relocatable Python runtimes as [AppImages][APPIMAGE]. These runtimes
-are extracted from [manylinux][MANYLINUX] Docker images. The corresponding
-images are available as GitHub [releases][RELEASES]. They are labeled according
-to [wheels][WHEEL] compatibility tags. Our Python AppImages are updated
-weekly.
-
-Running Python from these [AppImages][APPIMAGE] is as simple as downloading a
-single file and changing its mode to executable, e.g.  as:
-
-```sh
-wget https://github.com/niess/python-appimage/releases/download\
-/python3.10/python3.10.0-cp310-cp310-manylinux2010_x86_64.AppImage
-chmod +x python3.10.0-cp310-cp310-manylinux2010_x86_64.AppImage
-
-./python3.10.0-cp310-cp310-manylinux2010_x86_64.AppImage
-```
 
-This should start a Python 3.10 interactive session on _almost_ any Linux
-provided that `fuse` is available. Note that on WSL1 since `fuse` is not
-supported you will need to extract the AppImage as explained hereafter.
-
-The workflow described previously is enough if you only need vanilla Python with
-its standard library.  However, if you plan to install extra packages we
-recommend extracting the AppImage, e.g. as:
-
-```sh
-./python3.10.0-cp310-cp310-manylinux2010_x86_64.AppImage --appimage-extract
-mv squashfs-root python3.10
-rm -f python3.10.0-cp310-cp310-manylinux2010_x86_64.AppImage
-
-export PATH="$(pwd)/python3.10/usr/bin:$PATH"
-```
-
-Then, extra packages can be installed to the extracted AppDir using `pip`. For
-example upgrading pip can be done as:
+## Quickstart
 
-```sh
-pip install --upgrade pip
-```
+We provide relocatable Python runtimes as [AppImages][APPIMAGE] for Linux
+systems. These runtimes are extracted from [Manylinux][MANYLINUX] Docker images,
+and they are available as GitHub [releases][RELEASES].  Our Python AppImages are
+updated weekly, on every Sunday.
 
-## For applications developers
+Instructions for _installing_ and running _Python AppImages_ are provided on
+[Read the Docs][READTHEDOCS].
 
-Python [AppImages][APPIMAGE] are built using the `python_appimage` Python
-package. You can get it from [GitHub][GITHUB] or [PyPI][PYPI]. Examples of usage
-can be found by browsing GitHub [workflows][WORKFLOWS].
+In addition, the online documentation describes the [`python-appimage`][PYPI]
+utility, for application developers. This utility can facilitate the building of
+Python apps, given an existing Python AppImage and a recipe folder.
+[Examples][APPLICATIONS] of recipes are available from GitHub.
 
-The `python_appimage` package also allows to build basic Python apps from an
-existing Python AppImage and a recipe folder. The recipe folder contains the
-app metadata, a Python requirements file and an entry point script. Examples of
-recipes can be found on GitHub in the [applications][APPLICATIONS] folder.
 
-Alternatively, you can also manualy extract one of the Python [AppImages][APPIMAGE]
-as explained above and directly modify the content, e.g. `pip install` your custom
-packages. Then, simply rebuild the AppImage using your favourite tool, e.g.
-[appimagetool][APPIMAGETOOL], [linuxdeploy][LINUXDEPLOY] or `python-appimage`.
+## Projects using [`python-appimage`][GITHUB]
 
-## Projects using [python-appimage][PYTHON_APPIMAGE]
 * [grand/python](https://github.com/grand-mother/python) - Contained, portable
   and modern python for [GRAND][GRAND] running from an AppImage
-* [xxh](https://github.com/xxh/xxh) - Bring your favorite shell wherever you go
-  through the ssh
-* [xonsh](https://github.com/xonsh/xonsh) - Python-powered, cross-platform, Unix-gazing
-  shell language and command prompt
 * [rever](https://github.com/regro/rever) - Cross-platform software release tool.
 * [ssh-mitm](https://github.com/ssh-mitm/ssh-mitm) - ssh mitm server for security audits
+* [xonsh](https://github.com/xonsh/xonsh) - Python-powered, cross-platform, Unix-gazing
+  shell language and command prompt
+* [xxh](https://github.com/xxh/xxh) - Bring your favorite shell wherever you go
+  through the ssh
 
 
-[APPIMAGE]: https://appimage.org
-[APPIMAGETOOL]: https://appimage.github.io/appimagetool
 [APPLICATIONS]: https://github.com/niess/python-appimage/tree/master/applications
+[APPIMAGE]: https://appimage.org/
 [GITHUB]: https://github.com/niess/python-appimage
-[LINUXDEPLOY]: https://github.com/linuxdeploy/linuxdeploy
+[GRAND]: http://grand.cnrs.fr
 [MANYLINUX]: https://github.com/pypa/manylinux
-[PYPI]: https://pypi.org/project/python-appimage
+[PYPI]: https://pypi.org/project/python-appimage/
+[READTHEDOCS]: https://python-appimage.readthedocs.io/en/latest/
 [RELEASES]: https://github.com/niess/python-appimage/releases
-[WHEEL]: https://pythonwheels.com
-[WORKFLOWS]: https://github.com/niess/python-appimage/tree/master/.github/workflows
-[GRAND]: http://grand.cnrs.fr
-[PYTHON_APPIMAGE]: https://github.com/niess/python-appimage