From: | Oleg Bartunov <oleg(at)sai(dot)msu(dot)su> |
---|---|
To: | Rafael Martinez <r(dot)m(dot)guerrero(at)usit(dot)uio(dot)no> |
Cc: | pgsql-docs(at)postgresql(dot)org |
Subject: | Re: Documentation and explanatory diagrams |
Date: | 2010-04-05 13:53:55 |
Message-ID: | Pine.LNX.4.64.1004051753220.8023@sn.sai.msu.ru |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
That would be very nice to have !
Oleg
On Mon, 5 Apr 2010, Rafael Martinez wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> Hello
>
> I am wondering if we have ever evaluated the use of explanatory diagrams
> in the PostgreSQL documentation.
>
> I have always thought that a good diagram is worth a thousand words. I
> think the PostgreSQL manual would improve its quality if we get some
> good diagrams on the right places.
>
> They will help novice and advanced users who are not involved in the
> development of PostgreSQL, to get a quick overview of some central
> components in a PostgreSQL system when they read the documentation.
>
> Some of the possible diagrams that come to my mind in none particular
> order are:
>
> - PITR
> - Streaming Replication
> - Hot Standby
> - Write-Ahead Log
> - System Catalogs
> - Architectural Fundamentals overview
> - PostgreSQL server overview
> - Disk layout
> - Database Roles and Privileges
> - Database Physical Storage
> - Security and authentication
>
> What do you think about the idea? I could start working on an initial
> version of some of these diagrams if you are interested in the idea.
>
> regards,
> - --
> Rafael Martinez, <r(dot)m(dot)guerrero(at)usit(dot)uio(dot)no>
> Center for Information Technology Services
> University of Oslo, Norway
>
> PGP Public Key: http://folk.uio.no/rafael/
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.4.9 (GNU/Linux)
> Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
>
> iEYEARECAAYFAku55ocACgkQBhuKQurGihRbJQCfVA9SYVWkyfudFg7XPDlLXYeV
> tKAAmgMjg1tfU63sf0RTMRoFTtfsn/Pj
> =2+9o
> -----END PGP SIGNATURE-----
>
>
Regards,
Oleg
_____________________________________________________________
Oleg Bartunov, Research Scientist, Head of AstroNet (www.astronet.ru)
Sternberg Astronomical Institute, Moscow University, Russia
Internet: oleg(at)sai(dot)msu(dot)su, http://www.sai.msu.su/~megera/
phone: +007(495)939-16-83, +007(495)939-23-83
From | Date | Subject | |
---|---|---|---|
Next Message | Tom Lane | 2010-04-05 14:02:12 | Re: Documentation and explanatory diagrams |
Previous Message | Rafael Martinez | 2010-04-05 13:33:19 | Documentation and explanatory diagrams |