[modal] improves documentation