docs: mermaid error "Syntax error in text"

Problem

The doc page https://docs.gitlab.com/ee/development/gitlab_flavored_markdown/specification_guide/ multiple errors coming from mermaid:

Proposed solution

Ensure that mermaid code is working on docs page and fix all occurrences.