Merge pull request #861 from stdweird/transcribe

update transcribe docs to new version

mkdocs/docs/HPC/transcribe.md

@@ -12,25 +12,31 @@ The supported flow is:
 - Upload audio or video file using the `Files` interface of the web portal
 
 - Configure transcription via the `Interactive Apps` -> `Transcribe` application (currently under `Testing` section at the bottom);
-  you can select `Whisper inputfile`.
+  you can select `Whisper inputfile` and `Whisper language`.
 
 - Launch it and wait. Connecting to the running transcription is entirely optional; there is nothing interactive to do.
   You will also receive an email when the transcritpion started.
 
 - Upon completion, you will receive an email with link to the result directory. This info will also be shown in the application session under
   `My interactive sessions` (but the session data is only available for a week).
 
-  The result directory has a subdirectory per language with the text files and some metadata in JSON format of the transcritpion itself and input file.
+  The result directory has a subdirectory per language (transcription and optional translation)
+  with the text files and some metadata in JSON format of the transcritpion itself and input file.
 
 
 This is intentionally kept simple. There is also no risk of loosing previous results
 (although some previous result directories might get renamed when input file names are reused).
 
+
+If you have issues, please report them via the `Problems with this session? Submit support ticket` link.
+
+
 ## Performance and default settings
 
 The defaults should give the best balance between quality, performance and time to result.
-You can expect approx 10 minutes of transcription time per language and per hour of input using the default flavour.
-This combined with an almost immediate start time is the best combination for the intended use case.
+You can expect approximate 10 minutes of transcription time per hour of input and
+approximate 1 minute per translation language using the default flavour.
+This performance combined with an almost immediate start time is the best combination for the intended use case.
 There should be enough resources available to get this result most of the time.
 
 ## Advanced options
@@ -42,37 +48,46 @@ They are intended for corner cases, or to compare results between different `Whi
 
 ### Whisper language
 
-Using the `Automatic detection` (the default), whisper determines the spoken language based on the first 30 seconds of audio.
-If, for some reason, the autodection fails (e.g. the input file starts with silence or some music), you can force one of the languages.
-
-When selecting more than one, the transcription will be done separately for each language
-(this will also increase your total running time, so you might also want to increase the `Time`).
-
 The selected language will also determine the output language. However, this is ***not*** meant as a translation feature;
 although the quality is not that bad if your languages have enough similarity.
 
-### Cluster
+### Translation target languages
 
-Changing the cluster from the interactive cluster will give you access to much better GPU,
-but at a penalty of having to wait in the queue of the other cluster typically for a much longer time
-than it will take to complete the transcription on the default cluster.
+Select one or more languages to translate to. Hold the `Ctrl` button pressed while clicking to select (or unselect) languages.
 
-## Resources
+!!! warning
+    Right-to-left languages might generate incorrect subtitles. If you have any examples, you can use the
+    `Problems with this session? Submit support ticket` to report this so we can investigate properly.
 
-Default settings of 4 cores with at least 10GB of RAM and 1 hour (wall)time should be enough for most transcriptions.
+The translation is run after the transcription, and is separate from the Whisper based process.
+If you select a language to translate to that is also the `Whisper language`, there will be no translation generated for it.
 
-### Flavour
+The default languages are `Dutch` and `English`.  If e.g. you have a Dutch spoken video (and select Dutch as the `Whisper language`),
+the end result will be a Dutch transcription and an English translation of the Dutch transcription. (And thus no `Dutch-to-Dutch` translation.)
 
-We currently support 2 flavours: `whisper` (the OpenAI reference implementation), and `whisper-ctranslate2`
-(a faster version with some extras). Benchmarks indicate that `whisper-ctranslate2` is about 4 times faster than `whisper`,
-but might have some lower quality.
+There is thus no need to unselect the languages each time based on changing input languages.
 
 ### Model
 
 Default model is `large-v3`, others can be choosen but should be careful to compare resulting speed and/or quality differences.
 
+### Flavour
+
+We currently support 2 flavours: `whisper` (the OpenAI reference implementation), and `whisper-ctranslate2`
+(a faster version with some extras). Benchmarks indicate that `whisper-ctranslate2` is about 4 times faster than `whisper`,
+but might have some lower quality.
+
 ### Task
 
 From the selected (or auto-detected) source speech language, you can choose to transcribe to the same language or to `English`.
 You can use this last option to translate to English (as opposed to force the detection of the source language as if it was spoken in English).
 
+### Cluster
+
+Changing the cluster from the interactive cluster will give you access to much better GPU,
+but at a penalty of having to wait in the queue of the other cluster typically for a much longer time
+than it will take to complete the transcription on the default cluster.
+
+## Resources
+
+Default settings of 4 cores with at least 10GB of RAM and 1 hour (wall)time should be enough for most transcriptions.