Re: Consensus about visual diagrams in the docs.

2018-11-30 Thread Jani Tiainen
Personally I use plantuml to generate various diagrams. It is open source there even exists plugin for sphinx. It uses relatively understandable diagram language. Exports svg along the many other formats. And there are realtime preview plugins to most editors and ides. Only big downside is that re

Re: Consensus about visual diagrams in the docs.

2018-11-30 Thread Curtis Maloney
On 11/30/18 7:38 PM, guettli wrote: I do not care for the strategy, I care for the goal. How to find clear consensus now? There is a time honored practice in open source of spurring more spirited discussion by presenting a solution, however sub-optimal it may be. It may not be the accepted

Re: Consensus about visual diagrams in the docs.

2018-11-30 Thread Aymeric Augustin
Hello, A few years ago, I redid most illustrations and included them in the docs as SVG files. The primary driver was switching from PNG to SVG to better accommodate hi-dpi displays. I also committed the source files. Unfortunately, they're in a proprietary format and cannot be reused without a

Consensus about visual diagrams in the docs.

2018-11-30 Thread guettli
I once created a simple ascii diagram to explain details of the Django ORM: https://code.djangoproject.com/ticket/27936 Years ago it took some time for me to understand it. And since then it came up by new comers in our team several times. There is agreement on the goal: yes, a visual diagra