forked from TrueCloudLab/restic
16 lines
514 B
Markdown
16 lines
514 B
Markdown
# 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.
|