added spec notes