documentation brought up to date