... | @@ -777,7 +777,7 @@ it's able to make changes inline. |
... | @@ -777,7 +777,7 @@ it's able to make changes inline. |
|
[nodejs markdownlint]: https://github.com/DavidAnson/markdownlint
|
|
[nodejs markdownlint]: https://github.com/DavidAnson/markdownlint
|
|
[codespell]: https://github.com/codespell-project/codespell/
|
|
[codespell]: https://github.com/codespell-project/codespell/
|
|
|
|
|
|
### Charts
|
|
### Charts and diagrams
|
|
|
|
|
|
We currently use [Graphviz](https://graphviz.org/) to draw charts, but have also used
|
|
We currently use [Graphviz](https://graphviz.org/) to draw charts, but have also used
|
|
[Diagrams.net](https://www.diagrams.net/) (formerly `draw.io`). Other alternatives:
|
|
[Diagrams.net](https://www.diagrams.net/) (formerly `draw.io`). Other alternatives:
|
... | @@ -793,3 +793,25 @@ We currently use [Graphviz](https://graphviz.org/) to draw charts, but have also |
... | @@ -793,3 +793,25 @@ We currently use [Graphviz](https://graphviz.org/) to draw charts, but have also |
|
|
|
|
|
TODO: make a section about diagrams, how to make them, why they are
|
|
TODO: make a section about diagrams, how to make them, why they are
|
|
useful, etc. See [this for inspiration](https://sportebois.medium.com/better-architecture-diagrams-for-agile-teams-actionable-tips-and-lessons-e76627dc4315).
|
|
useful, etc. See [this for inspiration](https://sportebois.medium.com/better-architecture-diagrams-for-agile-teams-actionable-tips-and-lessons-e76627dc4315).
|
|
|
|
|
|
|
|
Normal graphic design tools like Inkscape, Dia, Krita and Gimp can of
|
|
|
|
course be used for this purpose. Ideally, an editable and standard
|
|
|
|
vector format (e.g. SVG) should be used for future proofing.
|
|
|
|
|
|
|
|
For this, clipart and "symbols" can be useful to have reusable
|
|
|
|
components in graphs. A few sources:
|
|
|
|
|
|
|
|
* [inkscape-open-symbols](https://github.com/PanderMusubi/inkscape-open-symbols) ([Debian package](https://tracker.debian.org/inkscape-open-symbols)): ships a bunch of
|
|
|
|
icons from multiple sources (e.g. Font Awesome) directly usable in
|
|
|
|
Inkscape, lacking a few which are suggested [IMKL](https://github.com/PanderMusubi/inkscape-open-symbols/issues/91), [OSA](https://github.com/PanderMusubi/inkscape-open-symbols/issues/38),
|
|
|
|
[Visio-like](https://github.com/PanderMusubi/inkscape-open-symbols/issues/25)
|
|
|
|
* [Free SVG](https://freesvg.org/): SVG vector files CC0
|
|
|
|
* [Feather icons](https://feathericons.com/): more icons than symbols or clipart, MIT
|
|
|
|
* [SVG repo](https://www.svgrepo.com/)
|
|
|
|
* [Lucide](https://lucide.dev/): Icons, ISC license
|
|
|
|
* [Icon Buddy](https://iconbuddy.app/): icons, various licenses
|
|
|
|
* [Hero icons](https://heroicons.com/): icons
|
|
|
|
* [AWS icons](https://awsicons.dev/)
|
|
|
|
* [Google icons](https://cloud.google.com/icons)
|
|
|
|
|
|
|
|
Note that Inkscape has rudimentary routing with the [connector tool](https://wiki.inkscape.org/wiki/Connector_tool_tutorial). |