upgrading documentation to new usage