can prob just use these: http://pandas.pydata.org/pandas-docs/stable/categorical.html#unioning also adding a link in the doc-string to these docs would be nice