Add release notes

Author: Borys Belinsky

source/conf.py

@@ -52,9 +52,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = '0'
+version = '11'
 # The full version, including alpha/beta/rc tags.
-release = ".".join([version, '0.1'])
+release = version
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -122,7 +122,7 @@
 
 # The name of an image file (relative to this directory) to place at the top
 # of the sidebar.
-html_logo = 'percona-server-logo.jpg'
+#html_logo = 'percona-server-logo.jpg'
 
 # The name of an image file (within the static path) to use as favicon of the
 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32

source/index.rst

@@ -1,38 +1,43 @@
-.. _psp.index:
+.. _pdp.index:
 
 
 |pdp| Documentation
 ********************************************************************************
 
-|pdp| is an enhanced drop-in replacement for |postgresql|. This
-release is based on |postgresql| 11. It also includes a selection of
-extensions that help manage |postgresql| more efficiently:
+|pdp| is a collection of tools to assist you in managing your |postgresql|
+database system: it installs |postgres| and complements it by a selectipon of
+extensions that enable solving essential practical tasks efficiently:
 
-- `Pg_repack <is a PostgreSQL extension which lets you remove bloat
-  from tables and indexes, and optionally restore the physical order
-  of clustered indexes>`_ extension to remove bloat from tables and
-  indexes and optionally restore the physical order of clustered
-  indexes.
+- `pg_repack <https://github.com/reorg/pg_repack>`_ rebuilds
+  |postgresql| database objects
+- `pgaudit <https://www.pgaudit.org/>`_ provides detailed session or object
+  audit logging via the standard |postgresql| logging facility
+- `pgBackRest <https://pgbackrest.org/>`_ is a backup and restore solution for
+  |postgresql|
+- `Patroni <https://patroni.readthedocs.io/en/latest/>`_ is an :abbr:`HA (High
+  Availability)` solution for |postgresql|.
 - A collection of `additional PostgreSQL contrib extensions
   <https://www.postgresql.org/docs/11/contrib.html>`_
-- `Pgaudit <https://www.pgaudit.org/>`_ to provide detailed session or
-  object audit logging via the standard logging facility provided by
-  |postgresql|
-- `pgBackRest <https://pgbackrest.org/>`_ - a backup and restore
-  solution for |postgresql|
-- `Patroni <https://patroni.readthedocs.io/en/latest/>`_ - an HA
-  solution for |postgresql|
 
-|pdp| is also shipped with the `libpq
-<https://www.postgresql.org/docs/11/libpq.html>`_ library. It contains
-"a set of library functions that allow client programs to pass queries to the PostgreSQL backend server and to receive the results of these queries."[#]
+.. seealso::
 
+   |percona| Blog Posts
+      - `pgBackRest – A Great Backup Solution and a Wonderful Year of Growth
+        <https://www.percona.com/blog/2019/05/10/pgbackrest-a-great-backup-solution-and-a-wonderful-year-of-growth/>`_
+      - `Securing PostgreSQL as an Enterprise-Grade Environment
+        <https://www.percona.com/blog/2018/09/21/securing-postgresql-as-an-enterprise-grade-environment/>`_
+	
+|pdp| is also shipped with the `libpq
+<https://www.postgresql.org/docs/11/libpq.html>`_ library. It contains "a set of
+library functions that allow client programs to pass queries to the PostgreSQL
+backend server and to receive the results of these queries." [#]_
 
 .. toctree::
-   
-   installing
+   :maxdepth: 1
 
+   installing
+   release-notes
 
-- [#] https://www.postgresql.org/docs/11/libpq.html
+.. [#] https://www.postgresql.org/docs/11/libpq.html
   
 .. include:: .res/replace.txt

source/installing.rst

@@ -1,4 +1,4 @@
-.. _psp.installing:
+.. _pdp.installing:
 
 Installing |pdp|
 ********************************************************************************

source/release-notes-v11.rst

@@ -0,0 +1,31 @@
+.. _pdp.release-notes.v11:
+
+|pdp| |version|
+********************************************************************************
+
+|percona| is excited to announce a beta release of |pdp| |version| on |date|.
+|pdp| is a collection of tools to assist you in managing |postgresql|. |pdp|
+installs |postgresql| and complements it by a selection of extensions that
+enable solving essential practical tasks efficiently:
+
+- `Pg_repack <https://github.com/reorg/pg_repack>`_ rebuilds PostgreSQL database objects.
+- `Pgaudit <https://www.pgaudit.org/>`_ provides detailed session or object audit logging via the standard logging facility provided by |postgresql|
+- `pgBackRest <https://pgbackrest.org/>`_ - a backup and restore
+  solution for |postgresql|
+- `Patroni <https://patroni.readthedocs.io/en/latest/>`_ - an HA
+  solution for |postgresql|
+- A collection of `additional PostgreSQL contrib extensions
+  <https://www.postgresql.org/docs/11/contrib.html>`_
+
+|pdp| is also shipped with the `libpq
+<https://www.postgresql.org/docs/11/libpq.html>`_ library. It contains
+"a set of library functions that allow client programs to pass queries to the PostgreSQL backend server and to receive the results of these queries." [#]_
+
+This release of |pdp| is based on |postgresql| 11.
+
+.. |version| replace:: 11
+.. |date| replace:: August 15, 2019
+
+.. [#] https://www.postgresql.org/docs/11/libpq.html
+
+.. include:: .res/replace.txt

source/release-notes.rst

@@ -0,0 +1,8 @@
+.. _pdp.release-notes.index:
+
+Release Notes
+********************************************************************************
+
+.. toctree::
+
+   release-notes-v11