improve db docs