adding some documentation writers hints