Re: Documentation and diagrams

[Alyssa Ross <hi@alyssa.is>]

[-- Attachment #1: Type: text/plain, Size: 1023 bytes --]

Hi Ville, thanks for looking into this!

On Tue, May 17, 2022 at 05:52:35AM -0000, ville.ilvonen@unikie.com wrote:
> What I'd like to propose that in addition to aiming at
> text-to-diagrams we support diagram drawing tool(s) and agree on
> either png or svg with diagrams.  With diagram drawing tools, we
> should store the diagrams in editable format in version control (not
> only png and svg).  My 2 cents would go to
> https://github.com/jgraph/drawio but I'm fine with others as well -
> as long as they do not require commercial license.

I've heard very good things about draw.io.  I agree with your
assessment that having a graphical diagramming tool would be useful.
draw.io being FOSS is a big plus for it as well — I think it's
desirable that contributing to Spectrum does not depend on proprietary
software.

One question about draw.io: is there a tool we could use in the build
process of our documentation to render the .drawio files to SVG, so we
don't have to check in the SVG files?

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]