Agreed the documentation could be a lot better. I wonder about a visual approach to using DataFrames and Series with all the different methods to demonstrated more clearly what's being done.

And some annoying interface decisions, like d['x'] is a column but d[1:3] is a row slice.