Docs: initial

1 files changed, 17 insertions, 0 deletions

diff --git a/docs/backends/start_stop.rst b/docs/backends/start_stop.rst
new file mode 100644
index 0000000..6cd6f13
--- /dev/null
+++ b/docs/backends/start_stop.rst
@@ -0,0 +1,17 @@
+Starting & cleaning up
+======================
+
+In case of most backends, you should only instantiate a backend once per 
+application, as a backend typically allocates resources such as thread or
+connection pools.
+
+When ending the application, make sure to call ``backend.close()``, which will 
+free up resources used by the backend (if any). The close process might be 
+asynchronous, that is it can complete after the ``close()`` method returns.
+
+Note that only resources allocated by the backends are freed. For example,
+if you use the ``AkkaHttpBackend()`` the ``close()`` method will terminate the
+underlying actor system. However, if you have provided an existing actor system
+upon backend creation (``AkkaHttpBackend.usingActorSystem``), the ``close()`` 
+method will be a no-op. 
+