restic/vendor/bazil.org/fuse/doc/writing-docs.md
2017-07-23 14:25:38 +02:00

514 B

Writing documentation

Sequence diagrams

The sequence diagrams are generated with seqdiag: http://blockdiag.com/en/seqdiag/index.html

An easy way to work on them is to automatically update the generated files with https://github.com/cespare/reflex :

reflex -g 'doc/[^.]*.seq' -- seqdiag -T svg -o '{}.svg' '{}' &

reflex -g 'doc/[^.]*.seq' -- seqdiag -T png -o '{}.png' '{}' &

The markdown files refer to PNG images because of Github limitations, but the SVG is generally more pleasant to view.