doc/radosgw: Improve layout.rst

Signed-off-by: Anthony D'Atri <anthonyeleven@users.noreply.github.com>
(cherry picked from commit a7e2fab008519416d5bd91f2163ea51e82c440af)

diff --git a/doc/radosgw/layout.rst b/doc/radosgw/layout.rst
index 723adf827124f6f870611d7cce56df5af15e1a61..d13b67e6fcdf1cfdb98d6633f2ad99e8b1f4a29d 100644 (file)
--- 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
 ^^^^^^^^