0
@@ -1,14 +1,15 @@
0
 ## RSpec
0
 
0
-Rspec is a way of writing human readable tests, it's a DLS which changes the 
0
-language and syntax to its more readable.
0
+RSpec is a testing framework  which uses a Domain Specific Language or DSL to
0
+provide more human readable test code.
0
 
0
 When using stubs with RSpec you can roughly categorise the methods you are 
0
-going to use into two categories. On one side you have the sub! and 
0
-should_receive methods which refine what methods you expect to be called 
0
+going to use into two categories. On one side you have the `stub!` and 
0
+`should_receive` methods which refine what methods you expect to be called 
0
 with what parameters and potentially what they should return in the case of 
0
 the test being run. On the other side you have assertions which test the output 
0
-and value or variables. The should method is primarily used when asserting things.
0
+and value or variables. The `should` method is primarily used when asserting
0
+specific results.
0
 
0
 
0
 #### What to test?