On Sat, Feb 24, 2018 at 4:04 AM, Peter Eisentraut
<peter.eisentraut@2ndquadrant.com> wrote:
> On 2/23/18 11:21, Tom Lane wrote:
>> In the distant
>> past, as I recall, we had a GIF or two; but we abandoned that on the
>> grounds that it was unmaintainable and also incompatible with some
>> documentation output formats. I'm not too sure what the state of
>> play is on the latter point, now that we've switched to XML.
>
> The complications with the image formats in the past were mainly around
> what ((pdf)jade)tex would accept. The tools have shifted a bit now, and
> the zoo formats is a different one. Nothing that a few make rules
> couldn't address, though, I think.
>
> The issue of how to manage the sources is still the same, though.
SVG format is ascii based vector format. We made experimental pdf with pictures
http://www.sai.msu.su/~megera/postgres/files/postgres-11-diagram.pdf
(GIN AM diagram, Appendix L).
Appendix L also demonstrates our sample database with step-by-step
introduction to Postgres for beginners. We have a separate book for beginners,
which we released under BSD license and it's available on
russian/english languages.
Our experience shows, that people really appreciate it. I hope we will
have time at PGCon
to discuss documentation somehow.
>
> --
> Peter Eisentraut http://www.2ndQuadrant.com/
> PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
>