updated db doc methods