Skip site navigation (1) Skip section navigation (2)

Re: Documentation and explanatory diagrams

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 (view raw or flat)
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

In response to

pgsql-docs by date

Next:From: Tom LaneDate: 2010-04-05 14:02:12
Subject: Re: Documentation and explanatory diagrams
Previous:From: Rafael MartinezDate: 2010-04-05 13:33:19
Subject: Documentation and explanatory diagrams

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group