From: Anthony D'Atri Date: Tue, 18 Mar 2025 18:54:10 +0000 (-0400) Subject: doc/radosgw: Improve layout.rst X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=0e792608d0dfd0dabb4c326341311cd41896586a;p=ceph.git doc/radosgw: Improve layout.rst Signed-off-by: Anthony D'Atri (cherry picked from commit a7e2fab008519416d5bd91f2163ea51e82c440af) --- diff --git a/doc/radosgw/layout.rst b/doc/radosgw/layout.rst index 723adf827124f..d13b67e6fcdf1 100644 --- a/doc/radosgw/layout.rst +++ b/doc/radosgw/layout.rst @@ -9,17 +9,17 @@ Introduction ------------ Swift offers something called a *container*, which we use interchangeably with -the term *bucket*, so we say that RGW's buckets implement Swift containers. +the S3 term *bucket*, so we say that RGW's buckets implement Swift containers. -This document does not consider how RGW operates on these structures, -e.g. the use of encode() and decode() methods for serialization and so on. +This document does not consider how RGW _operates_ on these structures, +e.g. the use of ``encode()`` and ``decode()`` methods for serialization. Conceptual View --------------- Although RADOS only knows about pools and objects with their xattrs and -omap[1], conceptually RGW organizes its data into three different kinds: -metadata, bucket index, and data. +omap[1], conceptually RGW maintains three types of information: +metadata, bucket indexes, and (payload) data. Metadata ^^^^^^^^