adding a bit of spec for our use cases