add documentation for traits macros
doc format update