doc/devel: repair sentences in "Essentials" page

This commit fixes a few sentences in the "Essentials" page
that aren't as well-formed as they might have been. This commit
fixes the issue detailed in the tracker link, as well as a couple
of other improvements that I couldn't resist in the heat of the
moment.

Fixes: https://tracker.ceph.com/issues/46362
Signed-off-by: Zac Dover <zac.dover@gmail.com>

diff --git a/doc/dev/developer_guide/essentials.rst b/doc/dev/developer_guide/essentials.rst
index 4f61a13e81417f6ba3deadb80d96b082292bdbc1..45e6aba8a29f23f001e7b423d235a5d92f663855 100644 (file)
--- a/doc/dev/developer_guide/essentials.rst
+++ b/doc/dev/developer_guide/essentials.rst
@@ -96,19 +96,18 @@ The ``dev@ceph.io`` list is for discussion about the development of Ceph,
 its interoperability with other technology, and the operations of the
 project itself.
 
-Ceph development email discussions the list is open to all. Subscribe by
-sending a message to ``dev-request@ceph.io`` with the line: ::
+The email discussion list for Ceph development is open to all. Subscribe by
+sending a message to ``dev-request@ceph.io`` with the following line in the
+body of the message: ::
 
     subscribe ceph-devel
 
-in the body of the message.
-
 The ``ceph-devel@vger.kernel.org`` list is for discussion and patch review
 for the Linux kernel Ceph client component. Note that this list used to
-be an all encompassing list for developers. So when searching archives here
-are the generic devel-ceph archives pre mid-2018.
+be an all-encompassing list for developers. So when searching the archives, 
+remember that this list contains the generic devel-ceph archives pre mid-2018.
 
-Subscription works in the same way, sending a message to
+Subscription works in the same way, by sending a message to
 ``majordomo@vger.kernel.org`` with the line: ::
 
     subscribe ceph-devel