✨ Document new gated repository features (#705)

* ✨ Document new gated repository features

* 👌 Suggestions from Julien

Co-Authored-By: Julien <julien-c@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Michelle Habonneau <83347449+Michellehbn@users.noreply.github.com>

---------

Co-authored-by: Julien <julien-c@users.noreply.github.com>
Co-authored-by: Michelle Habonneau <83347449+Michellehbn@users.noreply.github.com>

Author: 3 people

docs/hub/datasets-gated.md

@@ -1,6 +1,10 @@
 # Gated datasets
 
-To give dataset creators more control over how their datasets are used, the Hub allows users to enable **User Access requests** through a dataset's **Settings** tab. Enabling this setting requires users to agree to share their contact information in order to access the dataset. The contact information is stored in a database, and dataset owners are able to download a copy of the user access report.
+To give dataset creators more control over how their datasets are used, the Hub allows users to enable **User Access requests** through a dataset's **Settings** tab.
+Enabling this setting requires users to agree to share their contact information and accept the dataset authors' terms and conditions in order to access the dataset.
+The contact information is stored in a database, and dataset owners are able to download a copy of the user access report.
+
+## Modifying the prompt 
 
 The User Access request dialog can be modified to include additional text and checkbox fields in the prompt. To do this, add a YAML section to the dataset's `README.md` file (create one if it does not already exist) and add an `extra_gated_fields` property. Within this property, you'll be able to add as many custom fields as you like and whether they are a `text` or `checkbox` field. An `extra_gated_prompt` property can also be included to add a customized text message.
 
@@ -21,6 +25,19 @@ extra_gated_fields:
 
 The `README.md` file for a dataset is called a [Dataset Card](./datasets-cards). Visit the documentation to learn more about how to use it and to see the properties that you can configure.
 
+## Manual approval
+
+By default, requests to access the dataset are automatically accepted.
+Dataset authors can set the approval mode to "Manual reviews" from the dataset's **Settings** tab.
+Doing so enforces that each access request will be manually reviewed and approved by the dataset authors.
+Only users whose access requests have been approved will be able to access the dataset's content.
+
+
+<div class="flex justify-center">
+<img class="block dark:hidden" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/datasets-gated-manual-approval.png"/>
+<img class="hidden dark:block" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/datasets-gated-manual-approval-dark.png"/>
+</div>
+
 ## Additional Customization
 
 In some cases, you might also want to modify the text in the heading of the gate as well as the text in the button. For those use cases you can modify `extra_gated_heading` and `extra_gated_button_content`.

docs/hub/models-gated.md

@@ -1,6 +1,8 @@
 # Gated models
 
-To give model creators more control over how their models are used, the Hub allows users to enable **User Access requests** through a model's **Settings** tab. Enabling this setting requires users to agree to share their contact information in order to access the model. The contact information is stored in a database, and model owners are able to download a copy of the user access report.
+To give model creators more control over how their models are used, the Hub allows users to enable **User Access requests** through a model's **Settings** tab.
+Enabling this setting requires users to agree to share their contact information and accept the model owners' terms and conditions in order to access the model.
+The contact information is stored in a database, and model owners are able to download a copy of the user access report.
 
 Note that to download a gated model you'll need to be authenticated. You can log in by installing the [`huggingface_hub` client library](https://huggingface.co/docs/huggingface_hub/index) and running the following in your terminal:
 
@@ -40,6 +42,20 @@ extra_gated_fields:
 
 The `README.md` file for a model is called a [model Card](./model-cards). Visit the documentation to learn more about how to use it and to see the properties that you can configure.
 
+## Manual approval
+
+By default, requests to access the model are automatically accepted.
+Model authors can set the approval mode to "Manual reviews" from the model's **Settings** tab.
+Doing so enforces that each access request will be manually reviewed and approved by the model authors.
+Only users whose access requests have been approved will be able to access the model's content.
+
+<div class="flex justify-center">
+<img class="block dark:hidden" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/models-gated-manual-approval.png"/>
+<img class="hidden dark:block" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/models-gated-manual-approval-dark.png"/>
+</div>
+
+
+
 ## Additional Customization
 
 In some cases, you might also want to modify the text in the heading of the gate as well as the text in the button. For those use cases you can modify `extra_gated_heading` and `extra_gated_button_content`.