introduce concept of to-one collection
tighten up semantics in resourceapi
clean up names a bit more
more semantic clean up