Document DS.Adapter instance methods
Document DS.Adapter class methods
Merge pull request #1099 from wagenet/docs

Adding some docs
Doc corrections
Rewrite the state machine to improve performance