diff --git a/src/line-filters/line-filters.go b/src/line-filters/line-filters.go
index 3f66a61..9f43803 100644
--- a/src/line-filters/line-filters.go
+++ b/src/line-filters/line-filters.go
@@ -35,7 +35,7 @@ func main() {
 
         // The `EOF` error is expected when we reach the
         // end of input, so exit gracefully in that case.
-        // Otherwise there is a problem.
+        // Otherwise there's a problem.
         if err == io.EOF {
             return
         }
diff --git a/src/line-filters/line-filters.sh b/src/line-filters/line-filters.sh
index dfd718e..5cb5450 100644
--- a/src/line-filters/line-filters.sh
+++ b/src/line-filters/line-filters.sh
@@ -1,8 +1,9 @@
-# Make a file with a few lowercase lines.
+# To try out our line filter, first make a file with a few
+# lowercase lines.
 $ echo 'hello'   > /tmp/lines
 $ echo 'filter' >> /tmp/lines
 
-# Use the line filter to get uppercase lines.
+# Then use the line filter to get uppercase lines.
 $ cat /tmp/lines | go run line-filters.go
 HELLO
 FILTER