From 1e7b5863d9474d7715435d932b69dcd0880757df Mon Sep 17 00:00:00 2001 From: Anthony D'Atri Date: Tue, 18 Mar 2025 14:54:10 -0400 Subject: [PATCH] doc/radosgw: Improve layout.rst Signed-off-by: Anthony D'Atri (cherry picked from commit a7e2fab008519416d5bd91f2163ea51e82c440af) --- doc/radosgw/layout.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/doc/radosgw/layout.rst b/doc/radosgw/layout.rst index 1f51b2acb8926..27beafad0a29d 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 ^^^^^^^^ -- 2.39.5