DB: update documentation

first review by the documentation department
DB: rebuild documentation