PostgreSQL documentation
Overview
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 selected part of the navigation is not marked.
- On the left hand there are now links
- Documentation // Same as the one one the top. Clicking it just reloads the page.
- Manuals // leads to http://www.postgresql.org/docs/manuals/ and shows a table of five releases.
- Archive
- French // 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"?
- 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 // leads to http://wiki.postgresql.org/wiki/Category:FAQ - and the menu has gone.
- Books // leads to http://www.postgresql.org/docs/books/ - the menu stays!
- 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
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
- 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
There are at least two parts labeled with a Roman number I:
- http://www.postgresql.org/docs/9.3/static/sql-commands.html I. SQL Commands
- http://www.postgresql.org/docs/9.3/static/tutorial.html I. Tutorial
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".