handler: documenting handlers