TST/ENH: more helpful exceptions on trying to store invalid data

TST: added better exception for incopatible types when appending tables
DOC: more examples in cookbook.rst
Merge pull request #3088 from jreback/hdf_error

ENH: better errors message on storage failure in HDFStore