Re: Figures in docs - Mailing list pgsql-hackers

From Tatsuo Ishii
Subject Re: Figures in docs
Date
Msg-id 20160218.112955.2188834010458018982.t-ishii@sraoss.co.jp
Whole thread Raw
In response to Re: Figures in docs  (Peter Eisentraut <peter_e@gmx.net>)
List pgsql-hackers
> What we need is tooling around a new file format that is similar or
> analogous to our existing tooling, so that it is easy to edit, easy to
> review, easy to build, easy to test, and so on.  Otherwise, the image
> files will not get maintained properly.
> 
> As an example, if an image contains text (e.g., a flow chart or
> architecture diagram), then I expect that git grep will find it there,
> so that I know to update it when I rename or augment something.
> 
> The above is all solvable.  There are certainly image formats that fit
> those descriptions.
> 
> Personally, I'd want to know specifically what images people would want,
> so we could discuss or prototype something around that.

One of the diagrams I want to have is a query processing flowchart.

Best regards,
--
Tatsuo Ishii
SRA OSS, Inc. Japan
English: http://www.sraoss.co.jp/index_en.php
Japanese:http://www.sraoss.co.jp



pgsql-hackers by date:

Previous
From: Peter Eisentraut
Date:
Subject: Re: exposing pg_controldata and pg_config as functions
Next
From: Peter Eisentraut
Date:
Subject: pg_ctl promote wait