finish off documentation on shared behaviors