update spec for more efficiency and clarity