CLN deprecate save&load in favour of to_pickle&read_pickle

ENH add set_doc util decorator

Add read_pickle and to_pickle to top-level and classes, with deprecation warning til 0.12.

... leaves WIP to move these to `io/pickle.py` (but we could pull this part in to 0.11.1 and leave moving it til later?)

cc #3782.