diff --git a/README.md b/README.md
index 5bbc00ca..6fa883e6 100644
--- a/README.md
+++ b/README.md
@@ -88,6 +88,6 @@ Almost all bug fixes or new language additions should come with some additional
 
 ### Testing
 
-Sometimes getting the tests running can be too much work, especially if you don't have much Ruby experience. Its okay, be lazy and let our build bot [Travis](http://travis-ci.org/#!/github/linguist) run the tests for you. Just open a pull request and the bot will start cranking away.
+Sometimes getting the tests running can be too much work, especially if you don't have much Ruby experience. It's okay, be lazy and let our build bot [Travis](http://travis-ci.org/#!/github/linguist) run the tests for you. Just open a pull request and the bot will start cranking away.
 
-Heres our current build status, which is hopefully green: [![Build Status](https://secure.travis-ci.org/github/linguist.png?branch=master)](http://travis-ci.org/github/linguist)
+Here's our current build status, which is hopefully green: [![Build Status](https://secure.travis-ci.org/github/linguist.png?branch=master)](http://travis-ci.org/github/linguist)
diff --git a/lib/linguist/languages.yml b/lib/linguist/languages.yml
index 26cce756..a71e48ee 100644
--- a/lib/linguist/languages.yml
+++ b/lib/linguist/languages.yml
@@ -6,7 +6,7 @@
 # version of pygments.
 #
 # type              - Either data, programming, markup, or nil
-# lexer             - An explicit lexer String (defaults to name.downcase)
+# lexer             - An explicit lexer String (defaults to name)
 # aliases           - An Array of additional aliases (implicitly
 #                     includes name.downcase)
 # ace_mode          - A String name of Ace Mode (if available)