improved documentation
fixed Spec for BasicAdapter
defined dev-master as 0.1-dev
refactored BasicAdapter behavior
added some edge cases