fixup: review iteration

Author: pedro-psb

docs/admin/guides/configure-pulp/configure-storages.md

@@ -8,7 +8,7 @@ See the reference for the [`STORAGES` settings](site:pulpcore/docs/admin/referen
 The settings can be updated via the `settings.py` file or through environment variables
 and have support to dynaconf merge features (learn more on the [Settings Introduction](site:pulpcore/docs/admin/guides/configure-pulp/introduction/)).
 
-To learn where and how to modify the files and envvars, refer to the appropriate installation method documentation:
+To learn where and how to modify the files and environment variables, refer to the appropriate installation method documentation:
 
 * [Container (single-process) quickstart](site:pulp-oci-images/docs/admin/tutorials/quickstart/#single-container)
 * [Container (multi-process) quickstart](site:pulp-oci-images/docs/admin/tutorials/quickstart/#podman-or-docker-compose)
@@ -37,7 +37,7 @@ Notes:
 
 * The [`MEDIA_ROOT`](site:pulpcore/docs/admin/reference/settings/#media_root) setting specifies where Pulp
 will save the files.
-* Pulp customizes Django's default class, `django.core.files.storage.FileSystemStorage`.
+* Pulp customizes Django's default class, `django.core.files.storage.FileSystemStorage`. The original can't be used.
 * There are some other related global definitions provided by django:
     * `MEDIA_URL`
     * `FILE_UPLOAD_PERMISSIONS`
@@ -46,9 +46,9 @@ will save the files.
 Comprehensive options for Local Filesystem can be found in
 [Django docs](https://docs.djangoproject.com/en/4.2/ref/files/storage/#django.core.files.storage.FileSystemStorage).
 
-### Amazon S3
+## Amazon S3
 
-#### Setup
+### Setup
 
 Before you can configure Amazon S3 storage to use with Pulp, ensure that you complete the following steps
 (consult the official Amazon S3 docs for precise steps).
@@ -58,7 +58,7 @@ Before you can configure Amazon S3 storage to use with Pulp, ensure that you com
 3. In AWS Identity and Access Management (IAM), create a user that Pulp can use to access your S3 bucket.
 4. Save the access key id and secret access key.
 
-#### Example
+### Example
 
 In this example, the storage uses a bucket called `pulp3` that is hosted in region `eu-central-1`:
 
@@ -89,9 +89,16 @@ Notes:
 Comprehensive options for Amazon S3 can be found in
 [`django-storages` docs](https://django-storages.readthedocs.io/en/latest/backends/amazon-S3.html#configuration-settings).
 
-### Azure Blob storage
+## S3 Compatible
+
+The same `storages.backends.s3.S3Storage` backend can be used for S3 Compatible API services, such [Minio](https://min.io/), [Ceph/RADOS](https://docs.ceph.com/en/reef/man/8/rados/) and [Backblaze B2](https://www.backblaze.com/cloud-storage).
+
+The [django-storages](https://django-storages.readthedocs.io/en/latest/backends/s3_compatible/index.html) documentation
+provides a reference for setting up some of these services.
 
-#### Setup
+## Azure Blob storage
+
+### Setup
 
 Before you can configure Azure Blob storage to use with Pulp, ensure that you complete the following steps
 (consult the official Azure documentation for precise steps).
@@ -101,7 +108,7 @@ Before you can configure Azure Blob storage to use with Pulp, ensure that you co
 3. Obtain the access credentials so that you can later configure Pulp to access your Azure Blob storage. You can find the access credentials
    at the storage account level, at Access keys (these are automatically generated).
 
-#### Example
+### Example
 
 In this example, the storage uses a container called `pulp3` with the `pulp-account` username.
 

docs/admin/reference/settings.md

@@ -87,34 +87,30 @@ instructions on how to configure the database, refer to `database installation <
 Pulp uses [django-storages](https://django-storages.readthedocs.io/en/latest/index.html) to support multiple storage backends.
 If no backend is configured, Pulp will by default use the local filesystem (`pulpcore.app.models.storage.FileSystem`).
 
-To use another backend storage, you'll need to:
-
-1. Setup your storage and gather required credentials and specific configs.
-2. Ensure the `django-storage[s3|google|azure]` python package is installed. This depends on the installation method.
-3. Configure the default `BACKEND` storage class.
-4. Configure available `OPTIONS` for that backend.
-
-Learn more on the
-[Configure Storages](site:pulpcore/docs/admin/guides/configure-pulp/configure-storages/) guide.
-
-As an example, an Amazon S3 might look like this:
+The storage setting has the form:
 
 ```python
 STORAGES = {
     "default": {
-        "BACKEND": "storages.backends.s3.S3Storage",
+        "BACKEND": "{storage-class}",
         "OPTIONS": {
-            "access_key": 'AKIAIT2Z5TDYPX3ARJBA',
-            "secret_key": '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',
-            "bucket_name": 'pulp3',
-            "signature_version": "s3v4",
-            "addressing_style": "path",
-            "region_name": "eu-central-1",
+            "{option-key}": "{option-value}",
+            ...
         },
     },
 }
 ```
 
+To use another backend storage, you'll need to:
+
+1. Setup your storage and gather required credentials and specific configs.
+2. Ensure the `django-storage[s3|google|azure]` python package is installed. This depends on the installation method.
+3. Configure the default `BACKEND` storage class.
+4. Configure available `OPTIONS` for that backend.
+
+Learn more on the
+[Configure Storages](site:pulpcore/docs/admin/guides/configure-pulp/configure-storages/) guide.
+
 Overview of the integration with Pulp:
 
 - **Supported**: We support (test) Amazon S3 and Azure.