update specifictions markdown