diff --git a/README.md b/README.md
index cbc7e63..e65e6fc 100644
--- a/README.md
+++ b/README.md
@@ -2,22 +2,22 @@
 
 Support for discovering tests and test suites using reflection.
 
-It follows the xUnit style where each class is a test suite, and each method
-with the name prefix "test_" is a single text.
+This package follows the xUnit style where each class is a test suite, and each
+method with the name prefix `test_` is a single test.
 
-Methods with names starting with "test_" are are run using test() function with
-the corresponding name. If the class defines methods setUp() or tearDown(),
-they are executed before / after each test correspondingly, even the test fails.
+Methods with names starting with `test_` are run using the `test()` function with
+the corresponding name. If the class defines methods `setUp()` or `tearDown()`,
+they are executed before / after each test correspondingly, even if the test fails.
 
-Methods with names starting with "solo_test_" are run using solo_test() function.
+Methods with names starting with `solo_test_` are run using the `solo_test()` function.
 
-Methods with names starting with "fail_" are expected to fail.
+Methods with names starting with `fail_` are expected to fail.
 
-Methods with names starting with "solo_fail_" are run using solo_test() function
+Methods with names starting with `solo_fail_` are run using the `solo_test()` function
 and expected to fail.
 
-Method returning Future class instances are asynchronous, so tearDown() is
-executed after the returned Future completes.
+Method returning `Future` class instances are asynchronous, so `tearDown()` is
+executed after the returned `Future` completes.
 
 ## Features and bugs