readme - specs added - markup fix