db documentation additions