Add resources for Gen AI for Software Architecture Diagrams course

Author: tekiegirl

events/gen-ai-for-software-diagrams.md

@@ -0,0 +1,72 @@
+# Generative AI for Software Architecture Diagrams
+
+## Exercises
+
+### PlantUML
+- [PlantText.com](https://planttext.com/)
+- [PlantUML Webserver](https://www.plantuml.com/plantuml/)
+- [Sequence diagram exercise image](../exercises/sequence-exercise.png)
+- [PlantUML Sequence diagrams](https://plantuml.com/sequence-diagram)
+
+### Mermaid
+- [Mermaid Live](https://mermaid.live)
+- [Mermaid Chart](https://www.mermaidchart.com/play)
+- [Sequence diagram exercise image](../exercises/sequence-exercise.png)
+- [Mermaid Sequence diagrams](https://mermaid.js.org/syntax/sequenceDiagram.html)
+- [Customise Mermaid theme](https://mermaid.js.org/config/theming.html#customizing-themes-with-themevariables)
+  - For this exercise you can optionally look at changing *actorBkg*, *actorBorder*, *actorLineColor*, *activationBkgColor*, and *activationBorderColor*
+
+### Structurizr
+- [Structurizr DSL Demo](https://structurizr.com/dsl)
+- [Structurizr alternatives](https://structurizr.com/products)
+- [Context diagram exercise image](../exercises/context-exercise.png)
+- [Container diagram exercise image](../exercises/container-exercise.png)
+
+
+## Further Links
+- [JacquiRead.com](https://jacquiread.com)
+- [The KataLog](https://github.com/TheKataLog)
+- [C4 Model](https://c4model.com)
+- [List of text-to-diagram tools](https://xosh.org/text-to-diagram/)
+- [Kroki (API endpoint for diagrams-as-code)](https://kroki.io/)
+
+### PlantUML
+- [PlantUML website](https://plantuml.com/)
+- [Render PlantUML on GitHub](https://stackoverflow.com/questions/32203610/how-to-integrate-uml-diagrams-into-gitlab-or-github/32771815#32771815)
+- [C4-PlantUML](https://github.com/plantuml-stdlib/C4-PlantUML)
+- [PlantUML Standard Libraries](https://github.com/plantuml/plantuml-stdlib)
+- [PlantUML stying (replacing skin params)](https://plantuml.com/style-evolution)
+- [PlantUML Skin Params](https://plantuml-documentation.readthedocs.io/en/latest/formatting/all-skin-params.html#)
+- [PlantUML Icons](https://plantuml.com/creole#041a1eb0031c373d)
+- [PlantUML Activity diagram colours](https://plantuml.com/activity-diagram-beta#5d50889672f6f860)
+- [HMTL colour names](https://www.w3schools.com/colors/colors_names.asp)
+- [CSS colour names](https://www.w3schools.com/colors/colors_names.asp)
+
+### Mermaid
+- [Mermaid website](https://mermaid.js.org/)
+- [Mermaid diagram breaking](https://mermaid.js.org/intro/syntax-reference.html#diagram-breaking)
+- [Mermaid Flowchart styling](https://mermaid.js.org/syntax/flowchart.html#styling-and-classes)
+- [Mermsid styling issue on GitHub](https://github.com/mermaid-js/mermaid/issues/523)
+- [Mermaid (horrible) hack for styling sequence diagrams](https://stackoverflow.com/questions/63587556/color-change-of-one-element-in-a-mermaid-sequence-diagram)
+- [Mermaid Theming](https://mermaid.js.org/config/theming.html)
+
+### Structurizr
+- [Structurizr website](https://structurizr.com/)
+- [Structurizr DSL basics](https://docs.structurizr.com/dsl/basics)
+- [Structurizr DSL language reference](https://docs.structurizr.com/dsl/language)
+- Styling:
+  - Elements: [DSL Cookbook](https://docs.structurizr.com/dsl/cookbook/element-styles/) | [DSL language reference](https://docs.structurizr.com/dsl/language#element-style)
+  - Relationships: [DSL Cookbook](https://docs.structurizr.com/dsl/cookbook/relationship-styles/) | [DSL language reference](https://docs.structurizr.com/dsl/language#relationship-style)
+- [Structurizr workspace scope](https://docs.structurizr.com/workspaces/scope)
+- [Structurizr exporter comparison](https://docs.structurizr.com/export/comparison)
+- [Strucutrizr Docs](https://docs.structurizr.com/ui/documentation/)
+- [Strucutrizr ADRs](https://docs.structurizr.com/ui/decisions/)
+
+### Draw.io & Diagrams-as-code
+- [Draw.io](https://app.diagrams.net/)
+- [Draw.io keyboard shortcuts](https://viewer.diagrams.net/#Uhttps%3A%2F%2Fviewer.diagrams.net%2Fshortcuts.svg%23%7B%22pageId%22%3A%22150dc974-5404-6732-309c-fd6db42db779%22%7D)
+- [PlantUML in Draw.io](https://www.drawio.com/blog/plantuml)
+- [Mermaid in Draw.io](https://www.drawio.com/blog/mermaid-diagrams)
+
+---
+[> Home](../README.md)