generalized test specs, and added some notes