Update S3 configuration documentation

content/docs/integrations/aws-s3/index.md

@@ -14,11 +14,11 @@ S3 can be a useful place to store certain resources used by backstage plugins li
 
 This guide describes how to set up access for Roadie to your S3 buckets in your infrastructure and configure it.
 
-##  Step 1: Get the roadie IAM details
+To configure autodiscovery of entities from S3 buckets, see documentation about [AWS S3 Autodiscovery.](docs/details/location-management/#aws-s3-autodiscovery)
 
-Navigate to `Administration > Settings > AWS S3` and make a note of the Roadie backend role ARN and account ID.
+##  Step 1: Get the roadie IAM details
 
-![Role Details](./role-details.png)
+Navigate to `Administration > Settings > AWS S3` and make a note of the Roadie backend role ARN and account ID. This is mentioned on the title text of the AWS S3 integration settings page.
 
 ##  Step 2: Create a federated role in your account for Roadie
 
@@ -28,7 +28,12 @@ The role needs to follow this naming convention `arn:aws:iam::*:role/<your-tenan
 
 You'll need to attach a policy which allows access to the required S3 buckets such as `AmazonS3ReadOnlyAccess`. This policy grants roadie read access to all buckets. 
 If you do not want to grant this access you can [create your own policy](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html) 
-which restricts access to only certain buckets. e.g. 
+which restricts access to only certain buckets. An example minimal policy needed to retrieve files from S3 buckets is below 
+
+
+<details>
+
+<summary>An example minimal S3 Read policy</summary>
 
 ```json
 {
@@ -51,10 +56,17 @@ which restricts access to only certain buckets. e.g.
   ]
 }
 ```
+</details>
+
 
 ##  Step 3: Configure your Roadie instance to use the new role
 
 On the AWS S3 settings page `Administration > Settings > Aws S3` in Roadie click `Add Item` and enter the newly created 
 role ARN and external ID. The S3 host is only required if you're using different roles for different buckets. 
 
-![AWS S3 Settings](./aws-s3-config.png)
+After the role configuration is done, you can click the 'Test Role' button to check if integration configuration has succeeded.
+
+![Role Details](./role-details.png)
+
+
+