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

Re: Current docs are too comlicated for new Postgre users; thoughts on improvement

From: Peter Eisentraut <peter_e(at)gmx(dot)net>
To: Nikolay Samokhvalov <samokhvalov(at)gmail(dot)com>
Cc: PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Current docs are too comlicated for new Postgre users; thoughts on improvement
Date: 2009-01-09 13:37:17
Message-ID: 4967530D.8090709@gmx.net (view raw or flat)
Thread:
Lists: pgsql-docs
Nikolay Samokhvalov wrote:
> Currently, Part III (Server Administration) starts with three chapters:
>   15. Installation Instructions
>   16. Installation on Windows
>   17. Operating System Environment

> I think that docs really need to be clarified, at least titles should
> be corrected. I'd rename chapter 15 to smth like 'Building from source
> code on *nix platforms", and 16th one to 'Building from source code on
> Windows' and chapter 17 (most important) to 'Creation and Initial
> configuration of database cluster' (maybe with some corrections of
> contents).

Changed to:

III. Server Administration
15. Installation from Source Code
16. Installation from Source Code on Windows
17. Server Setup and Operation

> Going further, I'd remove detailed building instructions from the
> beginning of Server Administration part (either to separate but single
> chapter or even to appendix) and describe in details how to install
> Postgres in different ways on different platforms, including:
>  - installation from RPM/deb/other packages;

Well, we can only describe what we ship.  It is up to those packages to 
adequately describe what they are doing.


In response to

pgsql-docs by date

Next:From: Emanuel Calvo FrancoDate: 2009-01-09 14:13:02
Subject: Re: Current docs are too comlicated for new Postgre users; thoughts on improvement
Previous:From: Bruce MomjianDate: 2009-01-09 01:48:17
Subject: Re: Please add REINDEX note to 8.3.5 release notes.

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