@dpordomingo how did you convert svg to png originally? I used ImageMagick and it looks different.

I did it the hacky way: screenshot → save as .png.
Your way to proceed is way maintainable, so I'd say yours is better.

ImageMagick

convert \
    docs/assets/lookout-sdk-seq-diagram.svg
    lookout-sdk-seq-diagram.png

But these other alternatives render better PNGs (specially CairoSVG), but we should find the better options to do it.

svgexport

$ svgexport docs/assets/lookout-sdk-seq-diagram.svg \
    docs/assets/lookout-sdk-seq-diagram.png \
    "svg{background:white;}"

Inkscape

$ inkscape -z -e docs/assets/lookout-sdk-seq-diagram.png \
    --export-background white \
    docs/assets/lookout-sdk-seq-diagram.svg

CairoSVG

$ cairosvg -f png --output-width 900 \
    --output docs/assets/lookout-sdk-seq-diagram.png \
    docs/assets/lookout-sdk-seq-diagram.svg

I think we could move this to a new issue, and apply its decision in all our projects.

@carlosms @dpordomingo according to David's comment we can keep png as it is right now.
Is everything else good? Are we good to merge?

We could improve the images in a different PR. But to be honest they look worse, the text typography or kerning makes it harder to read. Why don't we use the same hacky screenshot for this PR, this way we are not in a hurry to find a good way to render them automatically?

@carlosms updated using screenshot

thanks @dpordomingo ! fixed

rebased on master + squshed docs commits. Merging after CI is green.