changed entry texts to make more obvious that they are from the db
made the documentation even more verbose