update docs/key management

Author: Gerit Wagner

colrev/packages/genai/README.md

@@ -14,6 +14,10 @@ To set the open-AI key, run
 export OPENAI_API_KEY="your_api_key_here"
 ```
 
+To keep the key available in future shell sessions, append the ``export`` line
+to your shell profile (for example ``~/.bashrc``) and reload it with
+``source ~/.bashrc``.
+
 ## prescreen
 
 Note: This document is currently under development. It will contain the following elements.

colrev/packages/scopus/README.md

@@ -14,6 +14,8 @@ Get an API key and set it using
 export SCOPUS_API_KEY="your-api-key"
 ```
 
+> **Tip:** To keep the key for future sessions, append the export line to your shell profile (for example ``~/.bashrc``) and reload it with ``source ~/.bashrc``.
+
 ## Links
 
 - [Scopus](http://www.scopus.com)

colrev/packages/springer_link/README.md

@@ -63,6 +63,10 @@ Set the API-KEY using
 export SPRINGER_API_KEY="your-api-key"
 ```
 
+> **Tip:** Add the export line to your shell profile (for example ``~/.bashrc``)
+> and reload it with ``source ~/.bashrc`` to keep the key available in future
+> sessions.
+
 The user can choose between `complete_search_string` for searching with a complex query or `interactively` to enter search parameters interactively.
 
 #### API search: complex query

docs/source/manual/packages/colrev.genai.rst

@@ -80,6 +80,10 @@ To set the open-AI key, run
 
    export OPENAI_API_KEY="your_api_key_here"
 
+For a permanent configuration, append the ``export`` statement to your shell
+profile (for example ``~/.bashrc``) and reload it using
+``source ~/.bashrc`` so the key is available in future sessions.
+
 prescreen
 ---------
 

docs/source/manual/packages/colrev.scopus.rst

@@ -68,6 +68,12 @@ Get an API key and set it using
 
    export SCOPUS_API_KEY="your-api-key"
 
+.. note::
+
+   Add the ``export`` command to your shell profile (for example ``~/.bashrc``)
+   and reload it with ``source ~/.bashrc`` to keep the key available across
+   sessions.
+
 Links
 -----
 

docs/source/manual/packages/colrev.springer_link.rst

@@ -118,6 +118,12 @@ Set the API-KEY using
 
    export SPRINGER_API_KEY="your-api-key"
 
+.. note::
+
+   To keep the API key available across terminal sessions, append the
+   ``export`` command to your shell profile (for example ``~/.bashrc``) and
+   reload it with ``source ~/.bashrc``.
+
 The user can choose between ``complete_search_string`` for searching with a complex query or ``interactively`` to enter search parameters interactively.
 
 API search: complex query