updates to the docs

especially database_performance