From 419df9b0b40756b7b60a9e75d9bffb62d5074097 Mon Sep 17 00:00:00 2001
From: Daira Hopwood <daira@jacaranda.org>
Date: Wed, 4 Dec 2013 01:23:11 +0000
Subject: [PATCH] docs/about.rst: Reword and remove redundancy. Also avoid
 "(S)FTP".

Signed-off-by: Daira Hopwood <daira@jacaranda.org>
---
 docs/about.rst | 17 +++++++----------
 1 file changed, 7 insertions(+), 10 deletions(-)

diff --git a/docs/about.rst b/docs/about.rst
index f11906eb..d44f033e 100644
--- a/docs/about.rst
+++ b/docs/about.rst
@@ -44,16 +44,13 @@ Here's how it works:
 
 A "storage grid" is made up of a number of storage servers.  A storage server
 has direct attached storage (typically one or more hard disks).  A "gateway"
-uses the storage servers and provides access to the filesystem over HTTP(S)
-or (S)FTP to tahoe clients.
-Note that you can find gateway nodes referred sometimes as client nodes. The
-Tahoe-LAFS architecture defines gateways as "nodes that provide access to
-files residing in storage nodes". You can see "clients" also referring to
-processes or programs connecting to a gateway node and performing operations
-on the grid (for exemple, the CLI binary).
-Gateways give access to files in the grid via protocols such as HTTP, FTP or
-SFTP. So, the gateways act as "clients" to other storage nodes at the same
-time that they are serving files to client programs (WebUI, (S)FTP clients).
+communicates with storage nodes, and uses them to provide access to the
+filesystem over protocols such as HTTP(S), SFTP or FTP.
+
+Note that you can find "client" used to refer to gateway nodes (which act as
+a client to storage servers), and also to processes or programs connecting to
+a gateway node and performing operations on the grid -- for example, a CLI
+command, Web browser, SFTP client, or FTP client.
 
 Users do not rely on storage servers to provide *confidentiality* nor
 *integrity* for their data -- instead all of the data is encrypted and
-- 
2.45.2