Quick documentation-related question and long-term feature branches with bzr-svn...

[Ian Clatworthy]

John Szakmeister wrote:

> So I'm going to update the data-migration-docs to reflect this as
> well, but I'd really like to include similar pictures to what I have
> in the article.  What's the preferred format for them?  PNG?  SVG?
> Both?  Other docs seem to have both, but then how do you customize it
> for a particular backend?  Or do you?

I usually include the png in the doc and both in the branch. Having the
SVG there as the "master diagram source" is valuable.

Sphinx does allow tuning of formats per back-end but we're not using
that capability yet. See http://sphinx.pocoo.org/rest.html#images

Ian C.