improve attributes doc
readme update