Improved explanation in README and CHANGELOG

Author: Roald87

CHANGELOG.md

@@ -1,9 +1,9 @@
 # Changes in version 3
 ## Changes which affect regular users
-- Added a new `documentclass` option `colorharmony`, which defines a new color using color harmony models. The new color is called `second` and can use this color in the document with `\color{second}`. This color is also used for the new `link{}` command, see below.
-- Added a new `documentclass` option `titlecolor`, which allows you to set a separate color (compared to the header) of the titles.
+- Added a new `documentclass` option `colorharmony`, which defines a new color using color harmony models. The new color is called `second` and can be used in the document with `\color{second}`. This color is also used for the new `link{}` command, see below.
+- Added a new `documentclass` option `titlecolor`, which allows you to set a different color for the titles.
 - Defined a new command `\FAspace` which replaces the old length `\FAspace` (and therefore breaks compatibility with the v2 class file). Now you can use `\FAspace` directly in the document, instead of using `\hspace{\FAspace}`.
-- Defined a new command `\link{someurl.com}`, which places a fontawesome logo in the document with the link. The color is detemined using the color harmony models.
+- Defined a new command `\link{someurl.com}`, which places a fontawesome logo in the document with the link. The color of the logo is detemined using the color harmony models.
 
 # Changes in version 2
 ## Changes which affect regular users

README.md

@@ -1,20 +1,17 @@
-# CV Template for XeLaTeX
-I created a custom curriculum vitae class file (`.cls`), see the comments in `cv-roald-example.tex` to understand how it works. 
-
-This template lets you choose one base color via the `documentclass` option `changecolor`. By using a color harmony model, a color named `second` is chosen, which by default is only used for the links. However, by using the documentclass option `titlecolor=second`, it is also used for the titles. See the gif below for a little demo.
+# CV template for XeLaTeX
+![Example](cv-roald-example.png)
 
-By choosing colors using the color harmony models, you make sure the different colors in the document match nicely. See more information see the [wiki](https://en.wikipedia.org/wiki/Harmony_\(color\)) or [here](http://paletton.com/).
+This template lets you choose one base color via the `documentclass` option `changecolor`. You can for example use the color of the company you are applying for. By using a color harmony model, a color named `second` is picked. This color is only used for the links. However, if you choose the option `titlecolor=second`, the second color is also used for the titles. See the gif below for a little demo.
 
 ![demo](document_class_options_demo.gif)
 
-# Screenshot of cv-roald-example.pdf
-![Example](cv-roald-example.png)
+By choosing colors according to a color [harmony model](https://en.wikipedia.org/wiki/Harmony_\(color\)), you make sure the different colors match nicely. You can play around with different models [here](http://paletton.com/). For more information on how this template works, see the comments in `cv-roald-example.tex`.
 
 # Changes in version 3
 ## Changes which affect regular users
-- Added a new `documentclass` option `colorharmony`, which defines a new color using color harmony models. The new color is called `second` and can use this color in the document with `\color{second}`. This color is also used for the new `link{}` command, see below.
-- Added a new `documentclass` option `titlecolor`, which allows you to set a separate color (compared to the header) of the titles.
+- Added a new `documentclass` option `colorharmony`, which defines a new color using color harmony models. The new color is called `second` and can be used in the document with `\color{second}`. This color is also used for the new `link{}` command, see below.
+- Added a new `documentclass` option `titlecolor`, which allows you to set a different color for the titles.
 - Defined a new command `\FAspace` which replaces the old length `\FAspace` (and therefore breaks compatibility with the v2 class file). Now you can use `\FAspace` directly in the document, instead of using `\hspace{\FAspace}`.
-- Defined a new command `\link{someurl.com}`, which places a fontawesome logo in the document with the link. The color is detemined using the color harmony models.
+- Defined a new command `\link{someurl.com}`, which places a fontawesome logo in the document with the link. The color of the logo is detemined using the color harmony models.