From 08a4d6258982ed67c5fd553ad8dee2b71537177b Mon Sep 17 00:00:00 2001
From: Pedro Valente <pedro.amaral.valente@gmail.com>
Date: Wed, 21 Feb 2024 19:34:59 +0000
Subject: [PATCH] updated transcription and configuration docs

---
 docs/src/app/api-reference/audio/page.mdx         | 14 ++++++++++++++
 docs/src/app/documentation/configuration/page.mdx | 10 ++++++++++
 2 files changed, 24 insertions(+)

diff --git a/docs/src/app/api-reference/audio/page.mdx b/docs/src/app/api-reference/audio/page.mdx
index 3c9554e..c6e4ddd 100644
--- a/docs/src/app/api-reference/audio/page.mdx
+++ b/docs/src/app/api-reference/audio/page.mdx
@@ -30,6 +30,20 @@ Discover how to convert audio to text or text to audio. OpenAI compliant. {{ cla
       </Property>
     </Properties>
 
+    ### Optional attributes
+
+    <Properties>
+      <Property name="create_session" type="bool">
+        If present and true, a new audio session will be created and used for the transcription and the session's UUID is returned in the response object. A session will keep track of past inferences, this may be useful for things like live transcriptions where continuous audio is submitted across several requests.
+      </Property>
+    </Properties>
+
+    <Properties>
+      <Property name="session" type="UUID">
+        The UUID of an existing session, which will be used for the transcription.
+      </Property>
+    </Properties>
+
 
   </Col>
   <Col sticky>
diff --git a/docs/src/app/documentation/configuration/page.mdx b/docs/src/app/documentation/configuration/page.mdx
index 81f6f5d..00acfdd 100644
--- a/docs/src/app/documentation/configuration/page.mdx
+++ b/docs/src/app/documentation/configuration/page.mdx
@@ -16,6 +16,7 @@ The Edgen configuration. It is read from a file where you can define your models
 | `audio_transcriptions_models_dir` | Directory for audio transcriptions models  | `<DATA_DIR>/edgen/models/audio/transcriptions`   |
 | `audio_transcriptions_model_name` | Name of audio transcriptions model         | ggml-distil-small.en.bin                         |
 | `audio_transcriptions_model_repo` | HuggingFace repo for audio transcriptions  | distil-whisper/distil-small.en                   |
+| `gpu_policy`                      | Policy to choose how a model gets loaded   | !always_device                                   |
 
 ### Configuration Paths for DATA_DIR
 
@@ -24,3 +25,12 @@ The Edgen configuration. It is read from a file where you can define your models
 | Linux    | `$XDG_DATA_HOME/_project_path_` or `$HOME/.local/share/_project_path_` | `/home/Alex/.local/share/edgen`                 |
 | macOS    | `$HOME/Library/Application Support/_project_path_`               | `/Users/Alex/Library/Application Support/com.EdgenAI.Edgen`    |
 | Windows  | `{FOLDERID_RoamingAppData}\_project_path_\data`                   | `C:\Users\Alex\AppData\Roaming\EdgenAI\Edgen\data` |
+
+### GPU policies
+
+Edgen supports the following policies, each with their own sub-settings:
+
+    - `!always_device` - Models will always get loaded to a GPU.
+        - `overflow_to_cpu` - If true, when a model can't be loaded to a GPU, it gets loaded to system memory. Else, Edgen will free GPU memory until the model can be loaded. **WARNING**: neither of these systems are currently implemented.
+    - `!always_cpu` - Models will always get loaded to system memory.
+        - `overflow_to_device` - If true, when a model can't be loaded to system memory, it gets loaded to a GPU. Else, Edgen will free system memory until the model can be loaded. **WARNING**: neither of these systems are currently implemented.