Re-write of documentation page

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>