doc
fixes, renaming
adding expected id on some db methods