Merge pull request #21 from ramiro/doc-fixes

A couple of doc fixes.
make container preserve order of insertion; closes #16
python 3 fix
2.5.1
docs
More docs (and docstrings) fixes: Typos, punctuation and better cross-linking.