From 288e76e8aee06f7c76b4cba25a47373f4dc75ff9 Mon Sep 17 00:00:00 2001 From: James Sheppard <57200592+james-sheppard-gov-uk@users.noreply.github.com> Date: Thu, 9 Jan 2025 14:12:05 +0000 Subject: [PATCH] Moved quote attributions to outside of quotes --- source/standards/diagrams-as-code.html.md.erb | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/standards/diagrams-as-code.html.md.erb b/source/standards/diagrams-as-code.html.md.erb index c0a4ab89..3d9a44c0 100644 --- a/source/standards/diagrams-as-code.html.md.erb +++ b/source/standards/diagrams-as-code.html.md.erb @@ -11,6 +11,7 @@ Code can be used to define the content, structure and appearance of a diagram wh ## What are diagrams for? > A good diagram enables you to more easily convey your design to others, and it provides a focus for your creative, as well as your technical thinking. + — [Drawing good architecture diagrams](https://www.ncsc.gov.uk/blog-post/drawing-good-architecture-diagrams) tips from NCSC There are many ways to create a diagram, from pen and paper or whiteboard through to specialist diagramming software. The right tool will depend on the circumstances, including what the diagram is for and who needs to be able to contribute to it, but it's always worth considering a diagram generated from code. @@ -38,6 +39,7 @@ Assuming you already [use GitHub](https://gds-way.digital.cabinet-office.gov.uk/ The [Mermaid Live Editor](https://mermaid.live/) is a good way of trying out Mermaid, and seeing diagrams rendered from code in real time. > Mermaid will automatically insert the aria-roledescription and, if provided in the diagram text by the diagram author, the accessible title and description. + — [Mermaid Accessibility Options](https://mermaid.js.org/config/accessibility.html) This works in a similar way to the `alt` attribute of an `` element.