documentation nd additional db methods