[docs] change specs to README, change formatting