code's documentation improved