diff --git a/db/doc.go b/db/doc.go
index <HASH>..<HASH> 100644
--- a/db/doc.go
+++ b/db/doc.go
@@ -12,7 +12,7 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
-// Package db defines common Data Broker types, and it the parent package
-// containing Data Broker client implementations for various key-value and
-// SQL data stores.
+// Package db defines the common Data Broker types, and it is the parent
+// package for Data Broker client implementations for various key-value
+// and SQL data stores.
 package db
diff --git a/httpmux/doc.go b/httpmux/doc.go
index <HASH>..<HASH> 100644
--- a/httpmux/doc.go
+++ b/httpmux/doc.go
@@ -12,6 +12,7 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
-// Package httpmux provides a plugin that allows app plugins to
-// register and afterwords handle http requests (usually REST based).
+// Package httpmux provides an HTTP server to app plugins, where a plugin
+// can register at specified URLs one or more HTTP request handlers that
+// will handle HTTP requests at run time.
 package httpmux
Editorial changes to docs.go