Improved documentation

following markdown syntax.
rephrased some paragraphs.
quality catch-up

1. change "p" to logger, using Ruby standard logger lib
2. some markdown document fix
gem spec & doc.. (not completed )