i'll get started on the spec thing, because i don't think it should touch the other usages