Add no downtime schema cache reload

releases/upcoming.rst

@@ -19,6 +19,9 @@ Added
 * Allow :ref:`embedding_view_chains` recursively to any depth.
   |br| -- `@wolfgangwalther <https://github.com/wolfgangwalther>`_
 
+* No downtime when reloading the schema cache. See the note in :ref:`schema_reloading`.
+  |br| -- `@steve-chavez <https://github.com/steve-chavez>`_
+
 * Allow schema cache reloading using PostgreSQL :ref:`NOTIFY <schema_reloading_notify>` command.
   |br| -- `@steve-chavez <https://github.com/steve-chavez>`_
 

schema_cache.rst

@@ -95,9 +95,8 @@ To refresh the cache without restarting the PostgREST server, send a SIGUSR1 sig
 
   killall -SIGUSR1 postgrest
 
-.. note::
 
-   To refresh the cache in docker:
+For docker you can do:
 
 .. code:: bash
 
@@ -106,6 +105,10 @@ To refresh the cache without restarting the PostgREST server, send a SIGUSR1 sig
   # or in docker-compose
   docker-compose kill -s SIGUSR1 <service>
 
+.. note::
+
+   There's no downtime when reloading the schema cache. The reloading will happen on a background thread while requests keep being served.
+
 .. _schema_reloading_notify:
 
 Reloading with NOTIFY