public inbox for [email protected]help / color / mirror / Atom feed
Current docs are too comlicated for new Postgre users; thoughts on improvement 6+ messages / 5 participants [nested] [flat]
* Current docs are too comlicated for new Postgre users; thoughts on improvement @ 2008-12-25 08:57 Nikolay Samokhvalov <[email protected]> 2008-12-25 09:32 ` Re: Current docs are too comlicated for new Postgre users; thoughts on improvement =?KOI8-R?B?98nL1M/SIPfJ08zPws/Lz9c=?= <[email protected]> 2009-01-09 13:37 ` Re: Current docs are too comlicated for new Postgre users; thoughts on improvement Peter Eisentraut <[email protected]> 2009-01-09 14:13 ` Re: Current docs are too comlicated for new Postgre users; thoughts on improvement Emanuel Calvo Franco <[email protected]> 2009-01-09 14:45 ` Re: Current docs are too comlicated for new Postgre users; thoughts on improvement Bruce Momjian <[email protected]> 0 siblings, 4 replies; 6+ messages in thread From: Nikolay Samokhvalov @ 2008-12-25 08:57 UTC (permalink / raw) To: pgsql-docs Currently, Part III (Server Administration) starts with three chapters: 15. Installation Instructions 16. Installation on Windows 17. Operating System Environment Here in Russia we have a situation, when the number of Win32 users of Postgres is constantly increasing, so more and more questions like "I've tried to install Postgres, clicked next/next/ok/ok/finish in installation wizard, but it doesn't work / service cannot start / I cannot connect" appear. The problem is that we cannot just say "RTFM" them, because it's really hard to find (and in some cases even impossible) to find the proper part of docs. Why? The chapters 15 and 16 of the main docs are not about installation -- they are about building Postgres from sources. Currently, even for *nix DBA installation most frequently means really installation from RPM/.deb/bsd ports/etc, including creation of system user and running initdb. As for Windows users, I haven't meet at least one who needs to know how to build Postgres from sources under Windows! And really often I see that Windows users cannot continue after some silly errors with initdb process. Docs cannot help them -- they open Chapter 16, got stuck and go away. And only really experienced DBAs know, that initdb (one of the most important processes for newbies) is described in "17.2. Creating a Database Cluster", which is located under "17. Operating System Environment" in the main contents listing. 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). 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; - special attention to Windows users (how to install? what are common problems?) /* btw, I won't wonder if win32 version of Postgres is being downloaded more often than others */ - short version of installation from sources; - initdb process; - initial configuration on different platforms. I believe that this question is one of the most important when we are thinking how to grow user base. Thoughts? -- Sincerely yours, Nikolay Samokhvalov Postgresmen LLC, http://postgresmen.ru ^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Current docs are too comlicated for new Postgre users; thoughts on improvement 2008-12-25 08:57 Current docs are too comlicated for new Postgre users; thoughts on improvement Nikolay Samokhvalov <[email protected]> @ 2008-12-25 09:32 ` =?KOI8-R?B?98nL1M/SIPfJ08zPws/Lz9c=?= <[email protected]> 3 siblings, 0 replies; 6+ messages in thread From: =?KOI8-R?B?98nL1M/SIPfJ08zPws/Lz9c=?= @ 2008-12-25 09:32 UTC (permalink / raw) To: Nikolay Samokhvalov <[email protected]>; +Cc: pgsql-docs Hello All. I agree with Nikolay. Windows users run into the problems during installation very often. They ask questions about these problems again and again at the forums. In some cases, I don't know that I can answer, because some problems is hard to my mind. With best wishes, Victor Vislobokov St.Peterburg, Russia ^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Current docs are too comlicated for new Postgre users; thoughts on improvement 2008-12-25 08:57 Current docs are too comlicated for new Postgre users; thoughts on improvement Nikolay Samokhvalov <[email protected]> @ 2009-01-09 13:37 ` Peter Eisentraut <[email protected]> 3 siblings, 0 replies; 6+ messages in thread From: Peter Eisentraut @ 2009-01-09 13:37 UTC (permalink / raw) To: Nikolay Samokhvalov <[email protected]>; +Cc: 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. ^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Current docs are too comlicated for new Postgre users; thoughts on improvement 2008-12-25 08:57 Current docs are too comlicated for new Postgre users; thoughts on improvement Nikolay Samokhvalov <[email protected]> @ 2009-01-09 14:13 ` Emanuel Calvo Franco <[email protected]> 3 siblings, 0 replies; 6+ messages in thread From: Emanuel Calvo Franco @ 2009-01-09 14:13 UTC (permalink / raw) To: pgsql-docs 2008/12/25 Nikolay Samokhvalov <[email protected]>: > Currently, Part III (Server Administration) starts with three chapters: > 15. Installation Instructions > 16. Installation on Windows > 17. Operating System Environment > > Here in Russia we have a situation, when the number of Win32 users of > Postgres is constantly increasing, so more and more questions like > "I've tried to install Postgres, clicked next/next/ok/ok/finish in > installation wizard, but it doesn't work / service cannot start / I > cannot connect" appear. > > The problem is that we cannot just say "RTFM" them, because it's > really hard to find (and in some cases even impossible) to find the > proper part of docs. Why? The chapters 15 and 16 of the main docs are > not about installation -- they are about building Postgres from > sources. Currently, even for *nix DBA installation most frequently > means really installation from RPM/.deb/bsd ports/etc, including > creation of system user and running initdb. > > As for Windows users, I haven't meet at least one who needs to know > how to build Postgres from sources under Windows! And really often I > see that Windows users cannot continue after some silly errors with > initdb process. Docs cannot help them -- they open Chapter 16, got > stuck and go away. And only really experienced DBAs know, that initdb > (one of the most important processes for newbies) is described in > "17.2. Creating a Database Cluster", which is located under "17. > Operating System Environment" in the main contents listing. > Here in Argentina is happenning the same thing. In that way we create content in our site (arpug.com.ar) . Wherever, there is a wiki, and there is a lot of that information on the web. But, you are correct when you talk about troubleshooting problems on windows and in the mailing list some people answer when a guy have windows problems 'migrate to *nix'... > 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). > in the same site we expose tis howto because the only place that exist is in the wiki > 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; > - special attention to Windows users (how to install? what are common > problems?) /* btw, I won't wonder if win32 version of Postgres is > being downloaded more often than others */ > - short version of installation from sources; > - initdb process; > - initial configuration on different platforms. > > I believe that this question is one of the most important when we are > thinking how to grow user base. > I'm watching that the manual in pdf is growing and my poor computer cries when i open 8.4devel manual.. i don't think when we arrive to 8.5... > Thoughts? > > -- > Sincerely yours, > Nikolay Samokhvalov > Postgresmen LLC, http://postgresmen.ru > > -- > Sent via pgsql-docs mailing list ([email protected]) > To make changes to your subscription: > http://www.postgresql.org/mailpref/pgsql-docs > -- Emanuel Calvo Franco ArPUG / AOSUG Member Postgresql Support & Admin ^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Current docs are too comlicated for new Postgre users; thoughts on improvement 2008-12-25 08:57 Current docs are too comlicated for new Postgre users; thoughts on improvement Nikolay Samokhvalov <[email protected]> @ 2009-01-09 14:45 ` Bruce Momjian <[email protected]> 2009-01-12 15:09 ` Re: Current docs are too comlicated for new Postgre users; thoughts on improvement Peter Eisentraut <[email protected]> 3 siblings, 1 reply; 6+ messages in thread From: Bruce Momjian @ 2009-01-09 14:45 UTC (permalink / raw) To: Nikolay Samokhvalov <[email protected]>; +Cc: pgsql-docs Peter has made a change to improve this: III. Server Administration 15. Installation from Source Code 16. Installation from Source Code on Windows 17. Server Setup and Operation --------------------------------------------------------------------------- Nikolay Samokhvalov wrote: > Currently, Part III (Server Administration) starts with three chapters: > 15. Installation Instructions > 16. Installation on Windows > 17. Operating System Environment > > Here in Russia we have a situation, when the number of Win32 users of > Postgres is constantly increasing, so more and more questions like > "I've tried to install Postgres, clicked next/next/ok/ok/finish in > installation wizard, but it doesn't work / service cannot start / I > cannot connect" appear. > > The problem is that we cannot just say "RTFM" them, because it's > really hard to find (and in some cases even impossible) to find the > proper part of docs. Why? The chapters 15 and 16 of the main docs are > not about installation -- they are about building Postgres from > sources. Currently, even for *nix DBA installation most frequently > means really installation from RPM/.deb/bsd ports/etc, including > creation of system user and running initdb. > > As for Windows users, I haven't meet at least one who needs to know > how to build Postgres from sources under Windows! And really often I > see that Windows users cannot continue after some silly errors with > initdb process. Docs cannot help them -- they open Chapter 16, got > stuck and go away. And only really experienced DBAs know, that initdb > (one of the most important processes for newbies) is described in > "17.2. Creating a Database Cluster", which is located under "17. > Operating System Environment" in the main contents listing. > > 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). > > 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; > - special attention to Windows users (how to install? what are common > problems?) /* btw, I won't wonder if win32 version of Postgres is > being downloaded more often than others */ > - short version of installation from sources; > - initdb process; > - initial configuration on different platforms. > > I believe that this question is one of the most important when we are > thinking how to grow user base. > > Thoughts? > > -- > Sincerely yours, > Nikolay Samokhvalov > Postgresmen LLC, http://postgresmen.ru > > -- > Sent via pgsql-docs mailing list ([email protected]) > To make changes to your subscription: > http://www.postgresql.org/mailpref/pgsql-docs -- Bruce Momjian <[email protected]> http://momjian.us EnterpriseDB http://enterprisedb.com + If your life is a hard drive, Christ can be your backup. + ^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Current docs are too comlicated for new Postgre users; thoughts on improvement 2008-12-25 08:57 Current docs are too comlicated for new Postgre users; thoughts on improvement Nikolay Samokhvalov <[email protected]> 2009-01-09 14:45 ` Re: Current docs are too comlicated for new Postgre users; thoughts on improvement Bruce Momjian <[email protected]> @ 2009-01-12 15:09 ` Peter Eisentraut <[email protected]> 0 siblings, 0 replies; 6+ messages in thread From: Peter Eisentraut @ 2009-01-12 15:09 UTC (permalink / raw) To: Bruce Momjian <[email protected]>; +Cc: Nikolay Samokhvalov <[email protected]>; pgsql-docs Bruce Momjian wrote: > Peter has made a change to improve this: > > III. Server Administration > 15. Installation from Source Code > 16. Installation from Source Code on Windows > 17. Server Setup and Operation That is what I said ... > > --------------------------------------------------------------------------- > > Nikolay Samokhvalov wrote: >> Currently, Part III (Server Administration) starts with three chapters: >> 15. Installation Instructions >> 16. Installation on Windows >> 17. Operating System Environment >> >> Here in Russia we have a situation, when the number of Win32 users of >> Postgres is constantly increasing, so more and more questions like >> "I've tried to install Postgres, clicked next/next/ok/ok/finish in >> installation wizard, but it doesn't work / service cannot start / I >> cannot connect" appear. >> >> The problem is that we cannot just say "RTFM" them, because it's >> really hard to find (and in some cases even impossible) to find the >> proper part of docs. Why? The chapters 15 and 16 of the main docs are >> not about installation -- they are about building Postgres from >> sources. Currently, even for *nix DBA installation most frequently >> means really installation from RPM/.deb/bsd ports/etc, including >> creation of system user and running initdb. >> >> As for Windows users, I haven't meet at least one who needs to know >> how to build Postgres from sources under Windows! And really often I >> see that Windows users cannot continue after some silly errors with >> initdb process. Docs cannot help them -- they open Chapter 16, got >> stuck and go away. And only really experienced DBAs know, that initdb >> (one of the most important processes for newbies) is described in >> "17.2. Creating a Database Cluster", which is located under "17. >> Operating System Environment" in the main contents listing. >> >> 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). >> >> 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; >> - special attention to Windows users (how to install? what are common >> problems?) /* btw, I won't wonder if win32 version of Postgres is >> being downloaded more often than others */ >> - short version of installation from sources; >> - initdb process; >> - initial configuration on different platforms. >> >> I believe that this question is one of the most important when we are >> thinking how to grow user base. >> >> Thoughts? >> >> -- >> Sincerely yours, >> Nikolay Samokhvalov >> Postgresmen LLC, http://postgresmen.ru >> >> -- >> Sent via pgsql-docs mailing list ([email protected]) >> To make changes to your subscription: >> http://www.postgresql.org/mailpref/pgsql-docs > ^ permalink raw reply [nested|flat] 6+ messages in thread
end of thread, other threads:[~2009-01-12 15:09 UTC | newest] Thread overview: 6+ messages (download: mbox mbox.gz follow: Atom feed) -- links below jump to the message on this page -- 2008-12-25 08:57 Current docs are too comlicated for new Postgre users; thoughts on improvement Nikolay Samokhvalov <[email protected]> 2008-12-25 09:32 ` =?KOI8-R?B?98nL1M/SIPfJ08zPws/Lz9c=?= <[email protected]> 2009-01-09 13:37 ` Peter Eisentraut <[email protected]> 2009-01-09 14:13 ` Emanuel Calvo Franco <[email protected]> 2009-01-09 14:45 ` Bruce Momjian <[email protected]> 2009-01-12 15:09 ` Peter Eisentraut <[email protected]>
This inbox is served by agora; see mirroring instructions for how to clone and mirror all data and code used for this inbox