Merge pull request ceph#61984 from cbodley/wip-doc-rgw-path-style

doc/rgw: clarify path-style vs virtual-hosted-style access

Reviewed-by: Zac Dover <[email protected]>

Author: zdover23

doc/radosgw/s3/commons.rst

@@ -7,19 +7,19 @@
 
 Bucket and Host Name
 --------------------
-There are two different modes of accessing buckets. The first method identifies
-the bucket as the top-level directory in the URI::
+There are two different modes of accessing buckets: path-style and virtual-hosted-style.
+Path-style requests identify the bucket as the top-level directory of the request's path::
 
 	GET /mybucket HTTP/1.1
 	Host: cname.domain.com
 
-Most S3 clients nowadays rely on vhost-style access. The desired bucket is
-indicated by a DNS FQDN. For example::
+Most S3 clients default to virtual-hosted-style access, where the bucket name is instead
+indicated as part of the fully-qualified domain name::
 
 	GET / HTTP/1.1
 	Host: mybucket.cname.domain.com
 
-The second method is deprecated by AWS. See the `Amazon S3 Path Deprecation
+Path-style access is deprecated by AWS. See the `Amazon S3 Path Deprecation
 Plan`_ for more information.
 
 To configure virtual hosted buckets, you can either set ``rgw_dns_name =