refined documentation on callbacks