rework doc about env

Author: Fabien Coelho

docs/documentation.md

@@ -38,26 +38,28 @@ The package provides two fixtures:
   - `setAuth` to add authentication data to a request `kwargs` and `cookies`.  
     This method is called automatically for adding credentials to a request.
 
-- `ft_client` for app testing, which depends on the previous fixture, plus the
-  `FLASK_TESTER_APP` environment variables which allow to find the application,
-  which contains either:
+- `ft_client` for app testing, which depends on the previous fixture and
+  is configured from two environment variables:
 
-  - The URL of the running application for external tests.
-    The application is expected to be already running when the test is started.
+  - `FLASK_TESTER_APP` tells where to find the application:
 
-  - The package (filename without `.py`) to be imported for the application.
-    - for `pkg:name`, `name` is the application in `pkg`.
-    - for `pkg` only, look for app as `app`, `application`, `create_app`, `make_app`.
-    - in both cases, `name` is called if callable and not a Flask application.
+    - The URL of the running application for external tests.
+      The application is expected to be already running when the test is started.
+  
+    - The package (filename without `.py`) to be imported for the application.
+      - for `pkg:name`, `name` is the application in `pkg`.
+      - for `pkg` only, look for app as `app`, `application`, `create_app`, `make_app`.
+      - in both cases, `name` is called if callable and not a Flask application.
+  
+    If not set, the default is `app`, which is to behave like Flask.
 
-  If not set, the default is `app`, which is to behave like Flask.
-
-  Moreover:
   - `FLASK_TESTER_DEFAULT` default login for authentication, default is _None_.
 
   The fixture then provides test methods to issue test requests against a Flask application:
+
   - `request` generic request with `login`, `auth`, `status` end `content` extensions.
   - `get post put patch delete` methods with the same extensions.
+
   Moreover, `setPass`, `setToken` and `setCookie` are forwarded to the internal authenticator.
 
 Authenticator environment variables can be set from the pytest Python test file by

docs/versions.md

@@ -5,6 +5,10 @@ Packages are distributed from [PyPI](https://pypi.org/project/FlaskTester/),
 see also the [documentation](https://zx80.github.io/flask-tester/),
 please report any [issues](https://github.com/zx80/flask-tester/issues).
 
+## ? on ?
+
+Improved documentation.
+
 ## 3.6 on 2024-03-30
 
 Only use `FLASK_TESTER_APP`, hide `FLASK_TESTER_URL`, which is only kept for