diff --git a/README.md b/README.md
index 0a509bb..31808c5 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,10 @@
 # CV/Résumé Boilerplate
 
-This repository contains a modified version of Dario Taborelli's [cvtex](https://github.com/dartar/cvtex) template. The original is targeted to academics and scientist, while this one should be well suited for everyone else.
+This little project should ease the pain of building and maintaining a CV or résumé using LaTeX.
+
+Since I find writing LaTeX code tedious and error-prone, I've ported the whole thing to [pandoc](http://pandoc.org/). By doing this, I can keep the actual content of the CV in a yaml file for easier editing and updating, while the layout lives in a separate TeX file.
 
-Since I find writing LaTeX tedious, I've ported the whole thing to [pandoc](http://pandoc.org/), abstracted the layout into a TeX file, and moved the content to a yaml file.
+This repository contains a modified version of Dario Taborelli's [cvtex](https://github.com/dartar/cvtex) template. The original is targeted to academics and scientist, while this one should be well suited for everyone else.
 
 Take a look at [output.pdf](output.pdf) to see the final result.
 
@@ -27,7 +29,7 @@ Note: this template needs to be compiled with XeTeX.
 
 - **`mainfont`**: Hoefler Text is the default, but every font installed in your system should work.
 - **`fontsize`**: Possible values are 10pt, 11pt and 12pt.
-- **`geometry`**: A string that sets the margins. Check out [this page](https://www.sharelatex.com/learn/Page_size_and_margins) to learn how the package `geometry` works.
+- **`geometry`**: This string sets margins and other parameters. Check out [this page](https://www.sharelatex.com/learn/Page_size_and_margins) to learn how the `geometry` package works.
 
 ## Recommended reading