model attribute and improved documentation