introduce high level get and create
add some documentation