Update main README.rst.

Author: tillahoffmann

Makefile

@@ -40,4 +40,4 @@ ${TESTS} : tests/% : image/%
 # Target to build the documentation
 
 docs :
-	sphinx-build -nW docs docs/_build/html
+	sphinx-build -nW . docs/_build

README.rst

@@ -8,45 +8,32 @@ testcontainers-python
 .. image:: https://readthedocs.org/projects/testcontainers-python/badge/?version=latest
    :target: http://testcontainers-python.readthedocs.io/en/latest/?badge=latest
 
-Python port for testcontainers-java that allows using docker containers for functional and integration testing. Testcontainers-python provides capabilities to spin up docker containers (such as a database, Selenium web browser, or any other container) for testing.
-
-Currently available features:
-
-* Generic docker container
-* ArangoDB container
-* Azurite container
-* ClickHouse container
-* ElasticSearch container
-* Kafka container
-* Keycloak container
-* LocalStack container
-* MariaDb container
-* Microsoft SQL Server container
-* Minio container
-* MongoDB container
-* MySql Db container
-* Neo4j container
-* NGINX container
-* OpenSearch container
-* OracleDb container
-* PostgreSQL Db container
-* RabbitMQ container
-* Redis container
-* Selenium Grid container
-* Selenium Standalone container
+testcontainers-python facilitates the use of Docker containers for functional and integration testing. The collection of packages currently supports the following features.
 
-Installation
-------------
-
-The testcontainers package is available from `PyPI <https://pypi.org/project/testcontainers/>`_, and it can be installed using :code:`pip`. Depending on which containers are needed, you can specify additional dependencies as `extras <https://setuptools.readthedocs.io/en/latest/setuptools.html#declaring-extras-optional-features-with-their-own-dependencies>`_:
-
-.. code-block:: bash
+.. toctree::
 
-    # Install without extras
-    pip install testcontainers
-    # Install with one or more extras
-    pip install testcontainers[mysql]
-    pip install testcontainers[mysql,oracle]
+    core/README
+    arangodb/README
+    azurite/README
+    clickhouse/README
+    compose/README
+    elasticsearch/README
+    google/README
+    kafka/README
+    keycloak/README
+    localstack/README
+    minio/README
+    mongodb/README
+    mssql/README
+    mysql/README
+    neo4j/README
+    nginx/README
+    opensearch/README
+    oracle/README
+    postgres/README
+    rabbitmq/README
+    redis/README
+    selenium/README
 
 Basic usage
 -----------
@@ -64,9 +51,15 @@ Basic usage
     >>> version
     'PostgreSQL 9.5...'
 
-The snippet above will spin up a Postgres database in a container. The :code:`get_connection_url()` convenience method returns a :code:`sqlalchemy` compatible url we use to connect to the database and retrieve the database version.
+The snippet above will spin up a postgres database in a container. The :code:`get_connection_url()` convenience method returns a :code:`sqlalchemy` compatible url we use to connect to the database and retrieve the database version. More extensive documentation can be found at `Read The Docs <http://testcontainers-python.readthedocs.io/>`_.
+
+Installation
+------------
+
+The suite of testcontainers packages is available on `PyPI <https://pypi.org/project/testcontainers/>`_, and individual packages can be installed using :code:`pip`. We recommend installing the package you need by running :code:`pip install testcontainers-<feature>`, e.g., :code:`pip install testcontainers-mysql`.
+
+For backwards compatibility, packages can also be installed by specifying `extras <https://setuptools.readthedocs.io/en/latest/setuptools.html#declaring-extras-optional-features-with-their-own-dependencies>`_, e.g., :code:`pip install testcontainers[mysql]`.
 
-More extensive documentation can be found at `Read The Docs <http://testcontainers-python.readthedocs.io/>`_.
 
 Usage within Docker (e.g., in a CI)
 -----------------------------------
@@ -76,7 +69,6 @@ When trying to launch a testcontainer from within a Docker container two things
 1. The container has to provide a docker client installation. Either use an image that has docker pre-installed (e.g. the `official docker images <https://hub.docker.com/_/docker>`_) or install the client from within the `Dockerfile` specification.
 2. The container has to have access to the docker daemon which can be achieved by mounting `/var/run/docker.sock` or setting the `DOCKER_HOST` environment variable as part of your `docker run` command.
 
-
 Setting up a development environment
 ------------------------------------
 
@@ -100,28 +92,3 @@ You can contribute a new container in three steps:
 1. Create a new module at :code:`testcontainers/[my fancy container].py` that implements the new functionality.
 2. Create a new test module at :code:`tests/test_[my fancy container].py` that tests the new functionality.
 3. Add :code:`[my fancy container]` to the list of test components in the GitHub Action configuration at :code:`.github/workflows/main.yml`.
-
-.. toctree::
-
-    core/README
-    arangodb/README
-    azurite/README
-    clickhouse/README
-    compose/README
-    elasticsearch/README
-    google/README
-    kafka/README
-    keycloak/README
-    localstack/README
-    minio/README
-    mongodb/README
-    mssql/README
-    mysql/README
-    neo4j/README
-    nginx/README
-    opensearch/README
-    oracle/README
-    postgres/README
-    rabbitmq/README
-    redis/README
-    selenium/README