Add documentation on how class-def and such are propogated.

[dalejung]

Examples like:

df.tail()
df + 1
pd.rolling_sum

keep their metadata via different paths. Need to document not just that they work, but how they work.