improve on basic usage, make README indexable

Signed-off-by: Fotis Georgatos <fotis@cern.ch>