move to preferred boilerplate
document the attributes