| 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: | Whole Thread | Raw Message | 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 |