refs #9: updated readme file to be valid rest