Improve the docs

Change-Id: I2bf934ad58cd9e52abb38472444d0d23773de723
Signed-off-by: Fabian Deutsch <fabiand@fedoraproject.org>