From: Zac Dover <zac.dover@proton.me>
Date: Fri, 24 Feb 2023 01:07:12 +0000 (+1000)
Subject: doc/glossary: add AWS/OpenStack bucket info
X-Git-Tag: v18.1.0~300^2
X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=d16ed970e9ac76d6320f0ae26fa3ddd745dbd429;p=ceph.git

doc/glossary: add AWS/OpenStack bucket info

Add links to AWS's documentation of buckets, in accordance with Casey
Bodley's suggestions here:
https://github.com/ceph/ceph/pull/50221#discussion_r1115900879

Co-authored-by: Anthony D'Atri <anthony.datri@gmail.com>
Signed-off-by: Zac Dover <zac.dover@proton.me>
---

diff --git a/doc/glossary.rst b/doc/glossary.rst
index c20a306c4e333..3c60bce25a09e 100644
--- a/doc/glossary.rst
+++ b/doc/glossary.rst
@@ -16,13 +16,19 @@
 
         Bucket
                 In the context of :term:`RGW`, a bucket is a group of objects.
-                Buckets are grouped into zones, and zones are grouped into
-                zonegroups. In an filesystem-based analogy in which objects are
-                the counterpart of files, buckets are the counterpart of
+                In a filesystem-based analogy in which objects are the
+                counterpart of files, buckets are the counterpart of
                 directories. :ref:`Multisite sync
                 policies<radosgw-multisite-sync-policy>` can be set on buckets,
                 to provide fine-grained control of data movement from one zone
-                to another zone.
+                to another zone. 
+                
+                The concept of the bucket has been taken from AWS S3. See also
+                `the AWS S3 page on creating buckets <https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html>`_
+                and `the AWS S3 'Buckets Overview' page <https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingBucket.html>`_.
+
+                OpenStack Swift uses the term "containers" for what RGW and AWS call "buckets". 
+                See `the OpenStack Storage API overview page <https://docs.openstack.org/swift/latest/api/object_api_v1_overview.html>`_.
                 
 	Ceph
                 Ceph is a distributed network storage and file system with