make spec clearer

closes #2