PostgreSQL documentation: Difference between revisions

From annawiki
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Overview==
http://www.postgresql.org/ - Click Documentation in the horizontal navigation - leads to http://www.postgresql.org/docs/  
http://www.postgresql.org/ - Click Documentation in the horizontal navigation - leads to http://www.postgresql.org/docs/  
* The URL does not contain the title.
* The URL does not contain the title.
Line 4: Line 5:
* On the left hand there are now links
* On the left hand there are now links
**Documentation // Same as the one one the top. Clicking it just reloads the page.
**Documentation // Same as the one one the top. Clicking it just reloads the page.
**Manuals // shows a table of five releases.
**Manuals // leads to http://www.postgresql.org/docs/manuals/ and shows a table of five releases.
***Archive  
***Archive  
***French // where is English?
***French // where is English?
***Japanese // where is English?
***Japanese // where is English?
**Security // leads to http://www.postgresql.org/support/security/ And the menu has gone. Is this still part of "Documentation"?  
**Security // leads to http://www.postgresql.org/support/security/ - and the menu has gone. Is this still part of "Documentation"?  
**What's New // leads to http://www.postgresql.org/docs/9.2/static/release-9-2-2.html - The page on top has "Home → Documentation → Manuals → PostgreSQL 9.2". Further down "PostgreSQL 9.2.5 Documentation [...] Appendix E. Release Notes [...] Release Date: 2012-12-06" -- Note that current date is 2013-11-21
**What's New // leads to http://www.postgresql.org/docs/9.2/static/release-9-2-2.html - The page on top has "Home → Documentation → Manuals → PostgreSQL 9.2". Further down "PostgreSQL 9.2.5 Documentation [...] Appendix E. Release Notes [...] Release Date: 2012-12-06" -- Note that current date is 2013-11-21
**FAQ
**FAQ // leads to http://wiki.postgresql.org/wiki/Category:FAQ - and the menu has gone.
**Books
**Books // leads to http://www.postgresql.org/docs/books/ - the menu stays!
**Wiki
**Wiki // leads to https://wiki.postgresql.org/wiki/Main_Page - and the menu has gone. "FAQ" also lead to a page in the same Wiki.


-----
==Online Manuals without comments==
** Support
http://www.postgresql.org/docs/ - right hand it says
** Versioning policy
Online Manuals
** Security
9.3 (with/without comments)
** Professional Services
Click on "without comments". Leads to http://www.postgresql.org/docs/9.3/static/index.html
** Hosting Solutions
 
** Report a Bug
On the top it says "Home → Documentation → Manuals → PostgreSQL 9.3"
 
And it says
* This page in other versions: 8.4 / 9.0 / 9.1 / 9.2 / 9.3
** 9.3 is not clickable.
* Development versions: devel
* Unsupported versions: 7.2 / 7.3 / 7.4 / 8.0 / 8.1 / 8.2 / 8.3
So, the first five are "supported versions" maybe? Why not label as such?
 
Different from URL, previous label and the above the page furthermore says
PostgreSQL 9.3.1 Documentation
 
Where is the documentation for 9.3.0?
 
9.3.0 is mentioned at
* http://www.postgresql.org/docs/9.3/static/release-9-3-1.html and that page says:
This page in other versions: 9.3  |  Development versions: devel
9.3 is not clickable.


==PostgreSQL 9.3.1 Documentation==
==PostgreSQL 9.3.1 Documentation==

Latest revision as of 2013-11-21T13:55:55

Overview

http://www.postgresql.org/ - Click Documentation in the horizontal navigation - leads to http://www.postgresql.org/docs/

Online Manuals without comments

http://www.postgresql.org/docs/ - right hand it says

Online Manuals
9.3 (with/without comments)

Click on "without comments". Leads to http://www.postgresql.org/docs/9.3/static/index.html

On the top it says "Home → Documentation → Manuals → PostgreSQL 9.3"

And it says

  • This page in other versions: 8.4 / 9.0 / 9.1 / 9.2 / 9.3
    • 9.3 is not clickable.
  • Development versions: devel
  • Unsupported versions: 7.2 / 7.3 / 7.4 / 8.0 / 8.1 / 8.2 / 8.3

So, the first five are "supported versions" maybe? Why not label as such?

Different from URL, previous label and the above the page furthermore says

PostgreSQL 9.3.1 Documentation

Where is the documentation for 9.3.0?

9.3.0 is mentioned at

This page in other versions: 9.3  |  Development versions: devel

9.3 is not clickable.

PostgreSQL 9.3.1 Documentation

There are at least two parts labeled with a Roman number I:

I. Tutorial

Those who set up and manage their own server should also read Part III.

Does one need to read "I" to find out that one needs to read "III" to manage an own server? If not, then isn't it superfluous is? And yes, it is in the http://www.postgresql.org/docs/9.3/static/preface.html - redundancy bloats the documentation.

1.4. Accessing a Database

You already discovered this scheme in the previous section using createdb.

No. I did not.


II. PostgreSQL Client Applications

http://www.postgresql.org/docs/9.3/static/reference-client.html

This part contains reference information for PostgreSQL client applications 
and utilities. Not all of these commands are of general utility;

These commands? The first sentence did not contain the word "command".