feat(GlModal): added description on how input modals should be closed by the user

What does this MR do?

While working on gitlab-org/gitlab!90177, we found that the behavior of modals that let the user input any data getting closed is not well described.

In accordance with the reviewers we came up with a solution that this MR tries to document so we can standardize it.

Attention: this MR has been marked as blocked because we still need to actually decide what the right/best way of handling the modal closing is. Some discussion is undergoing nothing yet decided. When a decision will be made this MR could be edited to apply the right changes 🙂

Does this MR meet the acceptance criteria?

• The MR title and commit messages meet the Pajamas commit conventions.
• The “What does this MR do?” section in the MR description is filled out, explaining the reasons for and scope of the proposed changes, per “Say why not just what”.
  • For example, if the MR is focused on usage guidelines, addressing accessibility challenges could be added in a separate MR.
• Relevant label(s) are applied to the MR.
• The MR is added to a milestone.
• If creating a new component page from scratch, it follows the page template structure.
• Content follows the Pajamas voice and tone guidelines, falling back on the GitLab Documentation Style Guide when needed.
• Related pages are cross-linked, where helpful. Component pages have related components and patterns defined in their Markdown front matter.
• If embedding a Figma file, it follows the Figma embed guide.
• Review requested from any GitLab designer or directly from a maintainer or trainee maintainer.

Links