Task/review documentation

Review and update the documentation.
It use to be hard to keep version number updated in documentaiton pieces. In other cases we have opted for abstracting them using X.Y.Z. I mean:

```
yum --nogpgcheck localinstall pep-proxy-X.Y.Z.noarch.rpm
```

Actually, it is a matter of taste. Up to you (mark this as NTC if you find ok the current way :)