[docs] clarify when to use `message` and when to use `progress(..., permanent=True)`

### What needs to get done

Clarify when a developer should use `message` or when they should use `progress`.

Example: Which is the correct way to show a warning?

### Why it needs to get done

User confusion: https://github.com/canonical/craft-application/pull/302#discussion_r1562935131