From 8b365f0adc9f60612c11d1aae7f73a2d6a88d678 Mon Sep 17 00:00:00 2001
From: Daniel Bachhuber <daniel@handbuilt.co>
Date: Thu, 28 Sep 2017 17:28:21 -0700
Subject: [PATCH 1/2] Improve the top-level command descriptions even further

---
 README.md                 | 15 ++++++++++++---
 src/Cache_Command.php     |  9 ++++++---
 src/Transient_Command.php |  6 +++++-
 3 files changed, 23 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index c00cc9d05..e25f02b9b 100644
--- a/README.md
+++ b/README.md
@@ -13,13 +13,18 @@ This package implements the following commands:
 
 ### wp cache
 
-Manage the object cache.
+Manipulate the WP Object Cache object.
 
 ~~~
 wp cache
 ~~~
 
-Use a persistent object cache drop-in to persist cache values between requests.
+By default, the WP Object Cache exists in PHP memory for the length of the
+request (and is emptied at the end). Use a persistent object cache drop-in
+to persist the object cache between request.
+
+[Read the codex article](https://codex.wordpress.org/Class_Reference/WP_Object_Cache)
+for more detail.
 
 **EXAMPLES**
 
@@ -35,12 +40,16 @@ Use a persistent object cache drop-in to persist cache values between requests.
 
 ### wp transient
 
-Manage transients.
+Manipulate the WordPress Transient Cache.
 
 ~~~
 wp transient
 ~~~
 
+By default, the transient cache uses the WordPress database to persist values
+between requests. When a persistent object cache drop-in is installed, the
+transient cache also uses the WordPress Object Cache.
+
 **EXAMPLES**
 
     # Set transient.
diff --git a/src/Cache_Command.php b/src/Cache_Command.php
index 7fbc26f90..4d8706114 100644
--- a/src/Cache_Command.php
+++ b/src/Cache_Command.php
@@ -1,11 +1,14 @@
 <?php
 
 /**
- * Manipulates the WP Object Cache.
+ * Manipulate the WP Object Cache object.
  *
+ * By default, the WP Object Cache exists in PHP memory for the length of the
+ * request (and is emptied at the end). Use a persistent object cache drop-in
+ * to persist the object cache between request.
  *
- * Use a persistent object cache drop-in to persist cache values between requests.
- * [WP Object Cache](https://codex.wordpress.org/Class_Reference/WP_Object_Cache)
+ * [Read the codex article](https://codex.wordpress.org/Class_Reference/WP_Object_Cache)
+ * for more detail.
  *
  * ## EXAMPLES
  *
diff --git a/src/Transient_Command.php b/src/Transient_Command.php
index 3c5120da3..63f10f922 100644
--- a/src/Transient_Command.php
+++ b/src/Transient_Command.php
@@ -1,7 +1,11 @@
 <?php
 
 /**
- * Manage WordPress transient and standardized way of storing cached data in the database temporarily base.
+ * Manipulate the WordPress Transient Cache.
+ *
+ * By default, the transient cache uses the WordPress database to persist values
+ * between requests. When a persistent object cache drop-in is installed, the
+ * transient cache also uses the WordPress Object Cache.
  *
  * ## EXAMPLES
  *

From 9308abe7b909541981d4fd9633b2088f3115a243 Mon Sep 17 00:00:00 2001
From: Daniel Bachhuber <daniel@handbuilt.co>
Date: Fri, 29 Sep 2017 08:45:14 -0700
Subject: [PATCH 2/2] Fix language

---
 README.md             | 2 +-
 src/Cache_Command.php | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index e25f02b9b..5ff990ac7 100644
--- a/README.md
+++ b/README.md
@@ -21,7 +21,7 @@ wp cache
 
 By default, the WP Object Cache exists in PHP memory for the length of the
 request (and is emptied at the end). Use a persistent object cache drop-in
-to persist the object cache between request.
+to persist the object cache between requests.
 
 [Read the codex article](https://codex.wordpress.org/Class_Reference/WP_Object_Cache)
 for more detail.
diff --git a/src/Cache_Command.php b/src/Cache_Command.php
index 4d8706114..7beff58f9 100644
--- a/src/Cache_Command.php
+++ b/src/Cache_Command.php
@@ -5,7 +5,7 @@
  *
  * By default, the WP Object Cache exists in PHP memory for the length of the
  * request (and is emptied at the end). Use a persistent object cache drop-in
- * to persist the object cache between request.
+ * to persist the object cache between requests.
  *
  * [Read the codex article](https://codex.wordpress.org/Class_Reference/WP_Object_Cache)
  * for more detail.