completed documentation on attribute handling