README and mark-up updates