add documentation for the new attributes