better images and more documentation

Author: Loïc Say

docs/hub/collections.md

@@ -94,6 +94,7 @@ To start adding images to your collection, you can click on the image icon in th
 
 Then, add images by dragging and dropping images from your computer. You can also click on the gray zone to select image files from your computer's file system.
 
+
 ![Collection image drop zone with images](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/collections-image-gallery.webp)
 
 You can re-order images by drag-and-dropping them. Clicking on an image will open it in full-screen mode.

docs/hub/enterprise-hub-gating-group-collections.md

@@ -55,17 +55,81 @@ By default, access to the repos in the collection is automatically granted to th
 
 If you want to manually approve which users can access repos in your collection, you must set it to **manual approval**. When this is the case, you will notice a new option:
 
+**Notification frequency** lets you configure when to get notified about new users requesting access. It can be set to once a day or real-time. By default, emails are sent to the first 5 admins of the organization. You can also set a different email address in the **Notifications email** field.
+
 <div class="flex justify-center" style="max-width: 750px">
     <img
         class="block dark:hidden !m-0"
-        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-modal-changes.webp"
+        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-modal-manual.webp"
         alt="Hugging Face gating group collection settings with manual review mode selected"
     />
     <img
         class="hidden dark:block !m-0"
-        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-modal-changes.webp"
+        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-modal-manual.webp"
         alt="Hugging Face gating group collection settings with manual review mode selected"
     />
 </div>
 
-**Notification frequency** lets you configure when to get notified about new users requesting access. It can be set to once a day or real-time. By default, emails are sent to the first 5 admins of the organization. You can also set a different email address in the **Notifications email** field.
+### Review access requests
+
+Once access requests are enabled, you have full control of who can access repos in your gating group collection or not, whether the approval mode is manual or automatic. You can review and manage requests either from the UI or via the API.
+
+#### From the UI
+
+You can review who has access to the repos in your gating group collection from the settings page of one of the repos of the collection by clicking on the **Review access requests** button:
+
+<div class="flex justify-center" style="max-width: 750px">
+    <img
+        class="block dark:hidden !m-0"
+        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-repo-settings.webp"
+        alt="Hugging Face repo access settings when repo is in a gating group collection"
+    />
+    <img
+        class="hidden dark:block !m-0"
+        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-repo-settings.webp"
+        alt="Hugging Face repo access settings when repo is in a gating group collection"
+    />
+</div>
+
+This will open a modal with 3 lists of users:
+
+- **pending**: the list of users waiting for approval to access your dataset. This list is empty unless you’ve selected **manual approval**. You can either **Accept** or **Reject** the demand. If the demand is rejected, the user cannot access your dataset and cannot request access again.
+- **accepted**: the complete list of users with access to your dataset. You can choose to **Reject** access at any time for any user, whether the approval mode is manual or automatic. You can also **Cancel** the approval, which will move the user to the **pending** list.
+- **rejected**: the list of users you’ve manually rejected. Those users cannot access your datasets. If they go to your dataset repository, they will see a message _Your request to access this repo has been rejected by the repo’s authors_.
+
+<div class="flex justify-center" style="max-width: 750px">
+    <img 
+        class="block dark:hidden"
+        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/models-gated-enabled-pending-users.png"
+        alt="Manage access requests modal for a repo in a gating group collection"
+    />
+    <img
+        class="hidden dark:block"
+        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/models-gated-enabled-pending-users-dark.png"
+        alt="Manage access requests modal for a repo in a gating group collection"
+    />
+
+</div>
+
+#### Via the API
+
+## Access gated repos in a gating group as a user
+
+As a user, if you want to use a gated repo in a gating group collection, you will need to request access to it. This means that you must be logged in to a Hugging Face user account.
+
+To know if a collection has gating group enabled, an icon will be shown next to its name:
+
+<div class="flex justify-center" style="max-width: 750px">
+    <img
+        class="block dark:hidden !m-0"
+        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-collection-enabled.webp"
+        alt="Hugging Face collection page with gating group collection feature enabled"
+    />
+    <img
+        class="hidden dark:block !m-0"
+        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-collection-enabled.webp"
+        alt="Hugging Face collection page with gating group collection feature enabled"
+    />
+</div>
+
+Visit our [gated models](https://huggingface.co/docs/hub/models-gated#access-gated-models-as-a-user) or [gated datasets](https://huggingface.co/docs/hub/datasets-gated#access-gated-datasets-as-a-user) documentation to know more about it.