doc tweaks

Author: pdurbin

doc/sphinx-guides/source/installation/big-data-support.rst

@@ -1,7 +1,7 @@
 Big Data Support
 ================
 
-Big data support includes some experimental options. Eventually more of this content will move to the Installation Guide.
+Big data support includes some experimental options.
 
 .. contents:: |toctitle|
         :local:
@@ -55,11 +55,12 @@ The following features are disabled when S3 direct upload is enabled.
 Allow CORS for S3 Buckets
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-**IMPORTANT:** This additional step of allowing cross-site request to your S3 buckets is required to enable direct uploads via a Dataverse installation, direct download to work with previewers, or direct upload to work with *dvwebloader* (:ref:`folder-upload`).
+**IMPORTANT:** This additional step of allowing cross-site request to your S3 buckets is required to enable direct uploads via a Dataverse installation, direct download to work with :ref:`file previewers <file-previews>`, or direct upload to work with :ref:`DVWebloader <folder-upload>`.
 
 To successfully enable direct uploads (e.g. :ref:`folder-upload`) or direct downloads (e. g. consumed by previewers), you must both:
-* Enable CORS in Dataverse (see :ref:`dataverse.cors`).
-* Configure a matching/compatible CORS policy on each S3 bucket (and any CDN/proxy in front of it) that will be used.
+
+- Enable CORS in Dataverse (see :ref:`dataverse.cors`).
+- Configure a matching/compatible CORS policy on each S3 bucket (and any CDN/proxy in front of it) that will be used.
 
 **NOTE:** Make sure the bucket's CORS configuration ``AllowedOrigins`` is at least as permissive as the origins you configure in :ref:`dataverse.cors.origin`.
 If the bucket allows the wildcard ``*`` but the Dataverse application only allows a subset, the browser will still enforce the more restrictive application response!

doc/sphinx-guides/source/installation/config.rst

@@ -223,7 +223,7 @@ To inspect cookie attributes like SameSite, you can use ``curl -s -I http://loca
 Cross-Origin Resource Sharing (CORS)
 ++++++++++++++++++++++++++++++++++++
 
-For any Dataverse installation using or planning to use advanced features like big data support or previewers, dealing with CORS is imminent.
+For any Dataverse installation using or planning to use advanced features like :doc:`big data support </installation/big-data-support>` or :ref:`file previewers <file-previews>`, CORS must be configured.
 
 To understand what CORS is all about and how it works, the following are recommended reads:
 
@@ -3821,7 +3821,7 @@ Experimental. See :doc:`/developers/search-services`.
 dataverse.cors.origin
 +++++++++++++++++++++
 
-Allowed origins for CORS requests.
+Allowed origins for CORS requests. See also :ref:`dataverse.cors`.
 
 Default: ``*`` (allow all)