documentation updates for database connections

This aims to resolve #6 

Test steps and let me know if I need to update anything.