Add release notes

index.rst

@@ -58,6 +58,8 @@ Getting Support
 
 The project has a friendly and growing community. Join our `chat room <https://gitter.im/begriffs/postgrest>`_ for discussion and help. You can also report or search for bugs/features on the Github `issues <https://github.com/begriffs/postgrest/issues>`_ page.
 
+.. _supporting-dev:
+
 Supporting development
 ----------------------
 
@@ -70,10 +72,16 @@ You can help PostgREST ongoing maintenance and development by:
 Every donation will be spent on making PostgREST better for the whole community.
 
 Translations
-------------
+~~~~~~~~~~~~
 
 * `Chinese <http://postgrest.org/zh/latest/>`_ (latest version ``v0.4.2.0``)
 
+.. toctree::
+   :caption: Release Notes
+   :titlesonly:
+
+   release_notes.rst
+
 .. toctree::
    :caption: Tutorials
    :titlesonly:

install.rst

@@ -124,6 +124,8 @@ db-pool
 
   Number of connections to keep open in PostgREST's database pool. Having enough here for the maximum expected simultaneous client connections can improve performance. Note it's pointless to set this higher than the :code:`max_connections` GUC in your database.
 
+.. _db-extra-search-path:
+
 db-extra-search-path
 --------------------
 

release_notes.rst

@@ -0,0 +1,32 @@
+Release Notes
+=============
+
+Here we'll include the most relevant changes so you can migrate to newer versions easily.
+You can see the full changelog of each release in the `PostgREST repository <https://github.com/PostgREST/postgrest/releases>`_.
+
+v5.2.0
+======
+
+* `Explicit qualification <http://postgrest.org/en/v5.0/api.html#explicit-qualification>`_ introduced in ``v5.0`` is no longer necessary, this section will not be included from this version onwards.  A :ref:`db-extra-search-path` configuration parameter was introduced to avoid the need to explictly qualify database objects. If you install PostgreSQL extensions on the ``public`` schema, they'll work normally from now on.
+
+* Now you can filter :ref:`tabs-cols-w-spaces`.
+
+* Included the ability to quote columns that have :ref:`reserved-chars`.
+
+* Thanks to `Zhou Feng <https://github.com/zhoufeng1989>`_, now is possible to reference an external file in :ref:`db-uri`.
+
+* Thanks to `Russell Davies <https://github.com/russelldavies>`_, Json Web Key Sets are now accepted by :ref:`jwt-secret`.
+
+Thanks
+------
+
+This release was made possible thanks to:
+
+* `Daniel Babiak <https://github.com/d-babiak>`_
+* `Michel Pelletier <https://github.com/michelp>`_
+* Tsingson Qin
+* Jay Hannah
+* Victor Adossi
+* Petr Beles
+
+If you like to join them please consider :ref:`supporting PostgREST development <supporting-dev>`.