extended some documentation