DOC: add pickle compat warning to docs
Merge pull request #5667 from jreback/docs

DOC: add pickle compat warning to docs