updated specs

Added 'what has been done' and 'what should not have been done'
sections.