### Problem to solve Diagrams are used in GitLab documentation for various reasons, including architectural diagrams, flow diagrams, and relationship diagrams. However, we don't recommend any specific formats to be used for diagrams. Support for Mermaid diagrams format has been available for some time and is commonly used. It doesn't meet all requirements, so other formats are sometimes used by authors. We have some [guidance](https://docs.gitlab.com/ee/development/documentation/styleguide/#images) in the docs style guide on the use of images, but it's mostly applicable to screenshots. ### Proposal - Expand the docs style guide [images](https://docs.gitlab.com/ee/development/documentation/styleguide/#images) section to include diagrams. - Recommend diagrams be maintained in Mermaid format where possible. ### Who can address the issue Anyone. ### Other links/references N/A