polishing include:
refactoring/fixing database.rb
docs updates