Add confirm box documentation to the API / script pages

The confirm prompt functionality in the script API is largely undocumented. We should add a section to the relevant page(s) covering this.

Something like the following demonstrates this reasonably well.

import ait.core.api as api
import ait.core.log as log

log.info("Pre Confirm box")
if api.ui.confirm("Should we continue? Press Confirm"):
    log.info("CONFIRM PRESSED")
else:
    log.info("DENY PRESSED")
log.info("After Confirm box")

log.info("Pre failed confirm box")
if api.ui.confirm("Should we continue? DONT press Confirm"):
    log.info("CONFIRM PRESSED")
else:
    log.info("DENY PRESSED")
log.info("After failed Confirm box")

Example of the popup displayed:

Start by locating the API or script documentation page that covers api.ui.confirm and read the existing surrounding examples. Add a section explaining the confirm prompt, using the supplied Python example and popup image; done means the functionality is documented on the relevant page or pages.