Verified Commit 36d21a1f authored by anarcat's avatar anarcat
Browse files

document clipart resouces

parent 46324531
Loading
Loading
Loading
Loading
+23 −1
Original line number Diff line number Diff line
@@ -777,7 +777,7 @@ it's able to make changes inline.
[nodejs markdownlint]: https://github.com/DavidAnson/markdownlint
[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
[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

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).

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).