Re: Cleanup of intro.sgml
Rev 2 attached. Added: SQL/JSON SQL/XML Fixed spelling mistakes Fixed a missing closing tag. -- Command Prompt, Inc. || http://the.postgres.company/ || @cmdpromptinc Postgres centered full stack support, consulting and development. Advocate: @amplifypostgres || Get help: https://commandprompt.com/ * Unless otherwise stated, opinions are my own. * diff --git a/doc/src/sgml/intro.sgml b/doc/src/sgml/intro.sgml index 3038826311..2a05985bb3 100644 --- a/doc/src/sgml/intro.sgml +++ b/doc/src/sgml/intro.sgml @@ -4,78 +4,77 @@ Preface - This book is the official documentation of + This is the official documentation of PostgreSQL. It has been written by the - PostgreSQL developers and other - volunteers in parallel to the development of the - PostgreSQL software. It describes all - the functionality that the current version of - PostgreSQL officially supports. + PostgreSQL community in parallel with the + development of the PostgreSQL database. + It describes the functionality of current version of + PostgreSQL. - + - To make the large amount of information about - PostgreSQL manageable, this book has been - organized in several parts. Each part is targeted at a different - class of users, or at users in different stages of their + This book has been broken up into categories to better manage + the large amount of information about + PostgreSQL. Each part is targeted at + a different category of user, or at users in different stages of their PostgreSQL experience: is an informal introduction for new users. + It includes information on topics such as installation, architecture + and how to create your first database. documents the SQL query - language environment, including data types and functions, as well - as user-level performance tuning. Every - PostgreSQL user should read this. + language, including data types and functions. It also includes + user-level performance tuning hints. All + PostgreSQL users should read this. describes the installation and - administration of the server. Everyone who runs a - PostgreSQL server, be it for private - use or for others, should read this part. + administration of the PostgreSQL server. + Everyone who administrates a + PostgreSQL server, should read this part. - describes the programming - interfaces for PostgreSQL client - programs. + describes the C based programming + interfaces for PostgreSQL. Topics such as + Python or Go are not discussed in this section. - contains information for - advanced users about the extensibility capabilities of the - server. Topics include user-defined data types and - functions. + contains information on + the extensibility of PostgreSQL. + server. Topics include user-defined data types, procedural languages, + and triggers. - contains reference information about - SQL commands, client and server programs. This part supports - the other parts with structured information sorted by command or - program. + contains reference information including + SQL commands, client applications and server applications. contains assorted information that might be of - use to PostgreSQL developers. + use to PostgreSQL internals developers. @@ -120,6 +119,33 @@ + PostgreSQL also supports a comprehensive array of Enterprise level + features: + + + + Unstructured data via JSON and SQL/JSON + + + SQL/XML + + + Binary and Logical Replication + + + Hot Backups + + + Partitioning + + + Materialized Views + + + Procedures + + + Also, PostgreSQL can be extended by the user in many ways, for example by adding new @@ -146,8 +172,8 @@ - And because of the liberal license, - PostgreSQL can be used, modified, and + The liberal license allows + PostgreSQL to be used, modified, and distributed by anyone free of charge for any purpose, be it private, commercial, or academic.
Re: Cleanup of intro.sgml
On 8/5/19 1:13 PM, Chapman Flack wrote: On 8/5/19 3:20 PM, Joshua D. Drake wrote: intro.sgml today. Patch attached. Things I noticed quickly: broken up in to categoriess/in to/into/ Got it, I can make that change. Unstructured data via JSON(or XML ?) On this one, there is a lot of argument about whether XML is structured or not. I do agree that adding XML support would be good though as many people think that JSON rules the world but the old money companies are still using XML. s/Partioniing/Partitioning/ Thanks for the catch. I will make the change. JD Regards, -Chap -- Command Prompt, Inc. || http://the.postgres.company/ || @cmdpromptinc Postgres centered full stack support, consulting and development. Advocate: @amplifypostgres || Get help: https://commandprompt.com/ * Unless otherwise stated, opinions are my own. *
Re: Cleanup of intro.sgml
On 8/5/19 3:20 PM, Joshua D. Drake wrote: > intro.sgml today. Patch attached. Things I noticed quickly: broken up in to categoriess/in to/into/ Unstructured data via JSON(or XML ?) s/Partioniing/Partitioning/ Regards, -Chap
Cleanup of intro.sgml
-hackers, I went through and made some readability and modernization of the intro.sgml today. Patch attached. JD -- Command Prompt, Inc. || http://the.postgres.company/ || @cmdpromptinc Postgres centered full stack support, consulting and development. Advocate: @amplifypostgres || Get help: https://commandprompt.com/ * Unless otherwise stated, opinions are my own. * diff --git a/doc/src/sgml/intro.sgml b/doc/src/sgml/intro.sgml index 3038826311..7b23a8a918 100644 --- a/doc/src/sgml/intro.sgml +++ b/doc/src/sgml/intro.sgml @@ -4,78 +4,77 @@ Preface - This book is the official documentation of + This is the official documentation of PostgreSQL. It has been written by the - PostgreSQL developers and other - volunteers in parallel to the development of the - PostgreSQL software. It describes all - the functionality that the current version of - PostgreSQL officially supports. + PostgreSQL community in parallel with the + development of the PostgreSQL database. + It describes the functionality of current version of + PostgreSQL. - + - To make the large amount of information about - PostgreSQL manageable, this book has been - organized in several parts. Each part is targeted at a different - class of users, or at users in different stages of their + This book has been broken up in to categories to better manage + the large amount of information about + PostgreSQL. Each part is targeted at + a different category of user, or at users in different stages of their PostgreSQL experience: is an informal introduction for new users. + It includes information on topics such as installation, architecture + and how to create your first database. documents the SQL query - language environment, including data types and functions, as well - as user-level performance tuning. Every - PostgreSQL user should read this. + language, including data types and functions. It also includes + user-level performance tuning hints. All + PostgreSQL users should read this. describes the installation and - administration of the server. Everyone who runs a - PostgreSQL server, be it for private - use or for others, should read this part. + administration of the PostgreSQL server. + Everyone who administrates a + PostgreSQL server, should read this part. - describes the programming - interfaces for PostgreSQL client - programs. + describes the C based programming + interfaces for PostgreSQL. Topics such as + Python or Go are not discussed in this section. - contains information for - advanced users about the extensibility capabilities of the - server. Topics include user-defined data types and - functions. + contains information on + the extensibility of PostgreSQL. + server. Topics include user-defined data types, procedural languages, + and triggers. - contains reference information about - SQL commands, client and server programs. This part supports - the other parts with structured information sorted by command or - program. + contains reference information including + SQL commands, client applications and server applications. contains assorted information that might be of - use to PostgreSQL developers. + use to PostgreSQL internals developers. @@ -120,6 +119,29 @@ + PostgreSQL also supports a comprehensive array of Enterprise level + features: + + + + Unstructured data via JSON + + Binary and Logical Replication + + + Hot Backups + + + Partioniing + + + Materialized Views + + + Procedures + + + Also, PostgreSQL can be extended by the user in many ways, for example by adding new @@ -146,8 +168,8 @@ - And because of the liberal license, - PostgreSQL can be used, modified, and + The liberal license allows + PostgreSQL to be used, modified, and distributed by anyone free of charge for any purpose, be it private, commercial, or academic.