From 0214d7bfd65d9859648973e7da3533bd9d87b36e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Thuret?= <contact@sebastien-thuret.fr>
Date: Fri, 8 Oct 2021 18:36:24 +0200
Subject: [PATCH 1/9] add buttons

---
 app/static/css/main.css  | 16 +++++++++-------
 app/templates/index.html | 29 +++++++++++++++++++++++++----
 2 files changed, 34 insertions(+), 11 deletions(-)

diff --git a/app/static/css/main.css b/app/static/css/main.css
index 71dd74e..5ebfe14 100644
--- a/app/static/css/main.css
+++ b/app/static/css/main.css
@@ -96,7 +96,7 @@ h3.header {
 }
 
 .btn-delete-text:focus,
-.btn-copy-translated:focus {
+.btn-action:focus {
   background: none !important;
 }
 
@@ -107,26 +107,28 @@ h3.header {
   color: #777;
   pointer-events: none;
 }
-
-.btn-copy-translated {
+.actions {
   position: absolute;
-  right: 2.75rem;
+  right: 1.25rem;
   bottom: 1rem;
   display: flex;
+}
+
+.btn-action {
+  display: flex;
   align-items: center;
   color: #777;
   font-size: 0.85rem;
   background: none;
   border: none;
   cursor: pointer;
-  margin-right: -1.5rem;
 }
 
-.btn-copy-translated span {
+.btn-action span {
   padding-right: 0.5rem;
 }
 
-.btn-copy-translated .material-icons {
+.btn-action .material-icons {
   font-size: 1.35rem;
 }
 
diff --git a/app/templates/index.html b/app/templates/index.html
index 327c592..1f6154f 100644
--- a/app/templates/index.html
+++ b/app/templates/index.html
@@ -149,9 +149,18 @@
 									Translated text
 								</label>									
 								<textarea id="textarea2" v-model="translatedText" ref="translatedTextarea" dir="auto" readonly></textarea>
-								<button class="btn-copy-translated" @click="copyText">
-									<span>[[ copyTextLabel ]]</span> <i class="material-icons">content_copy</i>
-								</button>	
+                                <div class="actions">
+                                    <button v-if="inputText.length && !isSuggesting" class="btn-action" @click="suggestTranslation">
+                                        <i class="material-icons">edit</i>
+                                    </button>
+                                    <button v-if="inputText.length && isSuggesting" class="btn-action" @click="closeSuggestTranslation">
+                                        <i class="material-icons">close</i>
+                                    </button>
+
+                                    <button class="btn-action btn-copy-translated" @click="copyText">
+                                        <span>[[ copyTextLabel ]]</span> <i class="material-icons">content_copy</i>
+                                    </button>
+                                </div>
 								<div class="position-relative">									
 									<div class="progress translate" v-if="loadingTranslation">
 										<div class="indeterminate"></div>
@@ -265,7 +274,9 @@
 			output: "",
 			charactersLimit: -1,
 
-			copyTextLabel: "Copy text"
+			copyTextLabel: "Copy text",
+
+            isSuggesting: false,
 		},
 		mounted: function(){
 			var self = this;
@@ -474,6 +485,16 @@
 					}, 1500);
 				}
 			},
+            suggestTranslation: function(e) {
+                e.preventDefault();
+
+                this.isSuggesting = true;
+            },
+            closeSuggestTranslation: function(e) {
+                e.preventDefault();
+
+                this.isSuggesting = false;
+            },
 			deleteText: function(e){
 				e.preventDefault();
 				this.inputText = this.translatedText = this.output = "";

From f5bc2bc3f52aeb295f5571468f9d02557bc0220b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Thuret?= <contact@sebastien-thuret.fr>
Date: Fri, 8 Oct 2021 19:02:30 +0200
Subject: [PATCH 2/9] fix

---
 app/static/css/main.css  |  7 +++++
 app/templates/index.html | 63 +++++++++++++++++++++++++++-------------
 2 files changed, 50 insertions(+), 20 deletions(-)

diff --git a/app/static/css/main.css b/app/static/css/main.css
index 5ebfe14..728093b 100644
--- a/app/static/css/main.css
+++ b/app/static/css/main.css
@@ -124,6 +124,13 @@ h3.header {
   cursor: pointer;
 }
 
+.btn-blue {
+  color: #42A5F5;
+}
+.btn-action:disabled {
+    color: #777;
+}
+
 .btn-action span {
   padding-right: 0.5rem;
 }
diff --git a/app/templates/index.html b/app/templates/index.html
index 1f6154f..758a2b9 100644
--- a/app/templates/index.html
+++ b/app/templates/index.html
@@ -126,7 +126,7 @@
 									<template v-for="option in langs">
 										<option v-if="option.code !== 'auto'" :value="option.code">[[ option.name ]]</option>
 									</template>
-								</select>								
+								</select>
 							</div>
 						</div>
 
@@ -134,11 +134,11 @@
 							<div class="input-field textarea-container col s6">
 								<label for="textarea1" class="sr-only">
 									Text to translate
-								</label>								
+								</label>
 								<textarea id="textarea1" v-model="inputText" @input="handleInput" ref="inputTextarea" dir="auto"></textarea>
 								<button class="btn-delete-text" title="Delete text" @click="deleteText">
 									<i class="material-icons">close</i>
-								</button>							
+								</button>
 								<div class="characters-limit-container" v-if="charactersLimit !== -1">
 									<label>[[ inputText.length ]] / [[ charactersLimit ]]</label>
 								</div>
@@ -147,24 +147,26 @@
 							<div class="input-field textarea-container col s6">
 								<label for="textarea2" class="sr-only">
 									Translated text
-								</label>									
-								<textarea id="textarea2" v-model="translatedText" ref="translatedTextarea" dir="auto" readonly></textarea>
+								</label>
+								<textarea id="textarea2" v-model="translatedText" ref="translatedTextarea" dir="auto" v-bind:readonly="!isSuggesting"></textarea>
                                 <div class="actions">
                                     <button v-if="inputText.length && !isSuggesting" class="btn-action" @click="suggestTranslation">
                                         <i class="material-icons">edit</i>
                                     </button>
-                                    <button v-if="inputText.length && isSuggesting" class="btn-action" @click="closeSuggestTranslation">
-                                        <i class="material-icons">close</i>
+                                    <button v-if="inputText.length && isSuggesting" class="btn-action btn-blue" @click="closeSuggestTranslation">
+                                        <span>Cancel</span>
                                     </button>
-
-                                    <button class="btn-action btn-copy-translated" @click="copyText">
+                                    <button v-if="inputText.length && isSuggesting" :disabled="!canSendSuggestion" class="btn-action btn-blue" @click="sendSuggestion">
+                                        <span>Send</span>
+                                    </button>
+                                    <button v-if="!isSuggesting" class="btn-action btn-copy-translated" @click="copyText">
                                         <span>[[ copyTextLabel ]]</span> <i class="material-icons">content_copy</i>
                                     </button>
                                 </div>
-								<div class="position-relative">									
+								<div class="position-relative">
 									<div class="progress translate" v-if="loadingTranslation">
 										<div class="indeterminate"></div>
-									</div>																		
+									</div>
 								</div>
 							</div>
 						</div>
@@ -346,7 +348,7 @@
 				if (this.charactersLimit !== -1 && this.inputText.length >= this.charactersLimit){
 					this.inputText = this.inputText.substring(0, this.charactersLimit);
 				}
-				
+
 				// Update "selected" attribute (to overcome a vue.js limitation)
 				// but properly display checkmarks on supported browsers.
 				// Also change the <select> width value depending on the <option> length
@@ -355,7 +357,7 @@
 					if (el.value === this.sourceLang){
 						el.setAttribute('selected', '');
 						this.$refs.sourceLangDropdown.style.width = getTextWidth(el.text) + 24 + 'px';
-					}else{ 
+					}else{
 						el.removeAttribute('selected');
 					}
 				}
@@ -366,9 +368,9 @@
 						this.$refs.targetLangDropdown.style.width = getTextWidth(el.text) + 24 + 'px';
 					}else{
 						el.removeAttribute('selected');
-					} 
+					}
 				}
-				
+
 		},
 		computed: {
 			requestCode: function(){
@@ -388,8 +390,11 @@
 
 			isHtml: function(){
 				return htmlRegex.test(this.inputText);
-			}
-		},
+			},
+            canSendSuggestion() {
+                return this.translatedText.trim() !== "" && this.translatedText !== this.inputText;
+            }
+        },
 		filters: {
 			escape: function(v){
 				return v.replace('"', '\\\"');
@@ -405,7 +410,9 @@
 					this.transRequest = null;
 				}
 			},
-			swapLangs: function(){
+			swapLangs: function(e){
+                this.closeSuggestTranslation(e)
+
 				var t = this.sourceLang;
 				this.sourceLang = this.targetLang;
 				this.targetLang = t;
@@ -417,6 +424,8 @@
 				this.error = '';
 			},
 			handleInput: function(e){
+                this.closeSuggestTranslation(e)
+
 				if (this.timeout) clearTimeout(this.timeout);
 				this.timeout = null;
 
@@ -494,6 +503,20 @@
                 e.preventDefault();
 
                 this.isSuggesting = false;
+            },
+            sendSuggestion: function(e) {
+                e.preventDefault();
+
+                var request = new XMLHttpRequest();
+                self.transRequest = request;
+
+                var data = new FormData();
+                data.append("q", self.inputText);
+                data.append("s", self.inputText);
+                data.append("source", self.sourceLang);
+                data.append("target", self.targetLang);
+
+                request.open('POST', BaseUrl + '/translate', true);
             },
 			deleteText: function(e){
 				e.preventDefault();
@@ -510,7 +533,7 @@
 		ctx.font = 'bold 16px sans-serif';
 		var textWidth = Math.ceil(ctx.measureText(text).width);
 		return textWidth;
-	}	
+	}
 
 	function setApiKey(){
 		var prevKey = localStorage.getItem("api_key") || "";
@@ -520,7 +543,7 @@
 
 		localStorage.setItem("api_key", newKey);
 	}
-	
+
 	// @license-end
 	</script>
 </body>

From 5dcb55cad919312c31f5b9563faabb10e3c78685 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Thuret?= <contact@sebastien-thuret.fr>
Date: Fri, 8 Oct 2021 19:12:56 +0200
Subject: [PATCH 3/9] fix button state

---
 app/templates/index.html | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/app/templates/index.html b/app/templates/index.html
index 758a2b9..4b1e00a 100644
--- a/app/templates/index.html
+++ b/app/templates/index.html
@@ -272,7 +272,8 @@
 			loadingTranslation: false,
 			inputText: "",
 			inputTextareaHeight: 250,
-			translatedText: "",
+            savedTanslatedText: "",
+            translatedText: "",
 			output: "",
 			charactersLimit: -1,
 
@@ -392,7 +393,7 @@
 				return htmlRegex.test(this.inputText);
 			},
             canSendSuggestion() {
-                return this.translatedText.trim() !== "" && this.translatedText !== this.inputText;
+                return this.translatedText.trim() !== "" && this.translatedText !== this.savedTanslatedText;
             }
         },
 		filters: {
@@ -496,10 +497,13 @@
 			},
             suggestTranslation: function(e) {
                 e.preventDefault();
+                this.savedTanslatedText = this.translatedText
 
                 this.isSuggesting = true;
             },
             closeSuggestTranslation: function(e) {
+                this.translatedText = this.savedTanslatedText
+
                 e.preventDefault();
 
                 this.isSuggesting = false;

From deaa95e3c6e2f1958adde095191a1788fc99df02 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Thuret?= <contact@sebastien-thuret.fr>
Date: Sat, 9 Oct 2021 11:04:10 +0200
Subject: [PATCH 4/9] Dont show edit button when loading translations

---
 app/templates/index.html | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/app/templates/index.html b/app/templates/index.html
index 4b1e00a..ca143ce 100644
--- a/app/templates/index.html
+++ b/app/templates/index.html
@@ -150,13 +150,13 @@
 								</label>
 								<textarea id="textarea2" v-model="translatedText" ref="translatedTextarea" dir="auto" v-bind:readonly="!isSuggesting"></textarea>
                                 <div class="actions">
-                                    <button v-if="inputText.length && !isSuggesting" class="btn-action" @click="suggestTranslation">
+                                    <button v-if="!loadingTranslation && inputText.length && !isSuggesting" class="btn-action" @click="suggestTranslation">
                                         <i class="material-icons">edit</i>
                                     </button>
-                                    <button v-if="inputText.length && isSuggesting" class="btn-action btn-blue" @click="closeSuggestTranslation">
+                                    <button v-if="!loadingTranslation && inputText.length && isSuggesting" class="btn-action btn-blue" @click="closeSuggestTranslation">
                                         <span>Cancel</span>
                                     </button>
-                                    <button v-if="inputText.length && isSuggesting" :disabled="!canSendSuggestion" class="btn-action btn-blue" @click="sendSuggestion">
+                                    <button v-if="!loadingTranslation && inputText.length && isSuggesting" :disabled="!canSendSuggestion" class="btn-action btn-blue" @click="sendSuggestion">
                                         <span>Send</span>
                                     </button>
                                     <button v-if="!isSuggesting" class="btn-action btn-copy-translated" @click="copyText">

From b8f41c8d9454a78acfcb06aef968a94f3d51f643 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Thuret?= <contact@sebastien-thuret.fr>
Date: Sat, 9 Oct 2021 11:25:56 +0200
Subject: [PATCH 5/9] Adding a notification after sending

---
 app/app.py               |  7 +++++++
 app/templates/index.html | 25 ++++++++++++++++++++++++-
 2 files changed, 31 insertions(+), 1 deletion(-)

diff --git a/app/app.py b/app/app.py
index ea54a2d..ea69d43 100644
--- a/app/app.py
+++ b/app/app.py
@@ -613,6 +613,13 @@ def create_app(args):
     def spec():
         return jsonify(swag)
 
+
+    @app.route("/suggest", methods=["POST"])
+    @limiter.exempt
+    def suggest():
+        # TODO:
+        return jsonify({"success": True})
+
     SWAGGER_URL = "/docs"  # URL for exposing Swagger UI (without trailing '/')
     API_URL = "/spec"
 
diff --git a/app/templates/index.html b/app/templates/index.html
index 2d15cc2..2438e79 100644
--- a/app/templates/index.html
+++ b/app/templates/index.html
@@ -511,6 +511,8 @@
             sendSuggestion: function(e) {
                 e.preventDefault();
 
+                var self = this;
+
                 var request = new XMLHttpRequest();
                 self.transRequest = request;
 
@@ -520,7 +522,28 @@
                 data.append("source", self.sourceLang);
                 data.append("target", self.targetLang);
 
-                request.open('POST', BaseUrl + '/translate', true);
+                request.open('POST', BaseUrl + '/suggest', true);
+                request.onload = function() {
+                    try{
+                        var res = JSON.parse(this.response);
+                        if (res.success){
+                            M.toast({html: 'Thanks for your correction.'})
+                            self.closeSuggestTranslation(e)
+                        }else{
+                            throw new Error(res.error || "Unknown error");
+                        }
+                    }catch(e){
+                        self.error = e.message;
+                        self.closeSuggestTranslation(e)
+                    }
+                };
+
+                request.onerror = function() {
+                    self.error = "Error while calling /suggest";
+                    self.loadingTranslation = false;
+                };
+
+                request.send(data);
             },
 			deleteText: function(e){
 				e.preventDefault();

From c02658984e00771f53da83c7ddb068f2f531269b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Thuret?= <contact@sebastien-thuret.fr>
Date: Sat, 9 Oct 2021 11:43:22 +0200
Subject: [PATCH 6/9] send good parameter

---
 app/templates/index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app/templates/index.html b/app/templates/index.html
index 2438e79..404c47e 100644
--- a/app/templates/index.html
+++ b/app/templates/index.html
@@ -518,7 +518,7 @@
 
                 var data = new FormData();
                 data.append("q", self.inputText);
-                data.append("s", self.inputText);
+                data.append("s", self.translatedText);
                 data.append("source", self.sourceLang);
                 data.append("target", self.targetLang);
 

From 0561deb1b4bdbf905ae56650e541a73965d439ed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Thuret?= <contact@sebastien-thuret.fr>
Date: Sat, 9 Oct 2021 11:44:00 +0200
Subject: [PATCH 7/9] Save suggestions in a database

---
 .gitignore         |  1 +
 app/app.py         |  8 +++++++-
 app/suggestions.py | 31 +++++++++++++++++++++++++++++++
 3 files changed, 39 insertions(+), 1 deletion(-)
 create mode 100644 app/suggestions.py

diff --git a/.gitignore b/.gitignore
index 256d239..4c46265 100644
--- a/.gitignore
+++ b/.gitignore
@@ -131,3 +131,4 @@ installed_models/
 
 # Misc
 api_keys.db
+suggestions.db
\ No newline at end of file
diff --git a/app/app.py b/app/app.py
index ea69d43..f63348a 100644
--- a/app/app.py
+++ b/app/app.py
@@ -9,6 +9,7 @@ from app import flood
 from app.language import detect_languages, transliterate
 
 from .api_keys import Database
+from .suggestions import Database as SuggestionsDatabase
 
 from translatehtml import translate_html
 
@@ -617,7 +618,12 @@ def create_app(args):
     @app.route("/suggest", methods=["POST"])
     @limiter.exempt
     def suggest():
-        # TODO:
+        q = request.values.get("q")
+        s = request.values.get("s")
+        source_lang = request.values.get("source")
+        target_lang = request.values.get("target")
+
+        SuggestionsDatabase().add(q, s, source_lang, target_lang)
         return jsonify({"success": True})
 
     SWAGGER_URL = "/docs"  # URL for exposing Swagger UI (without trailing '/')
diff --git a/app/suggestions.py b/app/suggestions.py
new file mode 100644
index 0000000..28b943a
--- /dev/null
+++ b/app/suggestions.py
@@ -0,0 +1,31 @@
+import sqlite3
+import uuid
+
+from expiringdict import ExpiringDict
+
+DEFAULT_DB_PATH = "suggestions.db"
+
+
+class Database:
+    def __init__(self, db_path=DEFAULT_DB_PATH, max_cache_len=1000, max_cache_age=30):
+        self.db_path = db_path
+        self.cache = ExpiringDict(max_len=max_cache_len, max_age_seconds=max_cache_age)
+
+        # Make sure to do data synchronization on writes!
+        self.c = sqlite3.connect(db_path, check_same_thread=False)
+        self.c.execute(
+            """CREATE TABLE IF NOT EXISTS suggestions (
+            "q"	TEXT NOT NULL,
+            "s"	TEXT NOT NULL,
+            "source"	TEXT NOT NULL,
+            "target"	TEXT NOT NULL
+        );"""
+        )
+
+    def add(self, q, s, source, target):
+        self.c.execute(
+            "INSERT INTO suggestions (q, s, source, target) VALUES (?, ?, ?, ?)",
+            (q, s, source, target),
+        )
+        self.c.commit()
+        return True

From 0ff3ca65fb333bbcee9dcdadda016a40039f5692 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Thuret?= <contact@sebastien-thuret.fr>
Date: Sat, 9 Oct 2021 15:45:58 +0200
Subject: [PATCH 8/9] Disable suggestions by default

---
 app/app.py               |  4 ++++
 app/default_values.py    |  5 +++++
 app/main.py              |  3 +++
 app/templates/index.html | 12 +++++++-----
 4 files changed, 19 insertions(+), 5 deletions(-)

diff --git a/app/app.py b/app/app.py
index f63348a..44e21c1 100644
--- a/app/app.py
+++ b/app/app.py
@@ -592,6 +592,7 @@ def create_app(args):
             {
                 "charLimit": args.char_limit,
                 "frontendTimeout": args.frontend_timeout,
+                "suggestions": args.suggestions,
                 "language": {
                     "source": {
                         "code": frontend_argos_language_source.code,
@@ -618,6 +619,9 @@ def create_app(args):
     @app.route("/suggest", methods=["POST"])
     @limiter.exempt
     def suggest():
+        if args.suggestions is False:
+            abort(404)
+
         q = request.values.get("q")
         s = request.values.get("s")
         source_lang = request.values.get("source")
diff --git a/app/default_values.py b/app/default_values.py
index 2538a0e..d41843a 100644
--- a/app/default_values.py
+++ b/app/default_values.py
@@ -110,6 +110,11 @@ _default_options_objects = [
         'name': 'LOAD_ONLY',
         'default_value': None,
         'value_type': 'str'
+    },
+    {
+        'name': 'SUGGESTIONS',
+        'default_value': False,
+        'value_type':  'bool'
     }
 ]
 
diff --git a/app/main.py b/app/main.py
index d9b5b44..ffaef87 100644
--- a/app/main.py
+++ b/app/main.py
@@ -102,6 +102,9 @@ def main():
         metavar="<comma-separated language codes>",
         help="Set available languages (ar,de,en,es,fr,ga,hi,it,ja,ko,pt,ru,zh)",
     )
+    parser.add_argument(
+        "--suggestions", default=DEFARGS['SUGGESTIONS'], action="store_true", help="Allow user suggestions"
+    )
 
     args = parser.parse_args()
     app = create_app(args)
diff --git a/app/templates/index.html b/app/templates/index.html
index 404c47e..4ca063f 100644
--- a/app/templates/index.html
+++ b/app/templates/index.html
@@ -148,15 +148,15 @@
 								<label for="textarea2" class="sr-only">
 									Translated text
 								</label>
-								<textarea id="textarea2" v-model="translatedText" ref="translatedTextarea" dir="auto" v-bind:readonly="!isSuggesting"></textarea>
+								<textarea id="textarea2" v-model="translatedText" ref="translatedTextarea" dir="auto" v-bind:readonly="suggestions && !isSuggesting"></textarea>
                                 <div class="actions">
-                                    <button v-if="!loadingTranslation && inputText.length && !isSuggesting" class="btn-action" @click="suggestTranslation">
+                                    <button v-if="suggestions && !loadingTranslation && inputText.length && !isSuggesting" class="btn-action" @click="suggestTranslation">
                                         <i class="material-icons">edit</i>
                                     </button>
-                                    <button v-if="!loadingTranslation && inputText.length && isSuggesting" class="btn-action btn-blue" @click="closeSuggestTranslation">
+                                    <button v-if="suggestions && !loadingTranslation && inputText.length && isSuggesting" class="btn-action btn-blue" @click="closeSuggestTranslation">
                                         <span>Cancel</span>
                                     </button>
-                                    <button v-if="!loadingTranslation && inputText.length && isSuggesting" :disabled="!canSendSuggestion" class="btn-action btn-blue" @click="sendSuggestion">
+                                    <button v-if="suggestions && !loadingTranslation && inputText.length && isSuggesting" :disabled="!canSendSuggestion" class="btn-action btn-blue" @click="sendSuggestion">
                                         <span>Send</span>
                                     </button>
                                     <button v-if="!isSuggesting" class="btn-action btn-copy-translated" @click="copyText">
@@ -279,6 +279,7 @@
 
 			copyTextLabel: "Copy text",
 
+            suggestions: false,
             isSuggesting: false,
 		},
 		mounted: function(){
@@ -293,7 +294,8 @@
 					self.sourceLang = self.settings.language.source.code;
 					self.targetLang = self.settings.language.target.code;
 					self.charactersLimit = self.settings.charLimit;
-				}else {
+                    self.suggestions = self.settings.suggestions;
+            }else {
 					self.error = "Cannot load /frontend/settings";
 					self.loading = false;
 			}

From 9960baa9c8d4243122722d2420043de378f4f3c9 Mon Sep 17 00:00:00 2001
From: Piero Toffanin <pt@masseranolabs.com>
Date: Sat, 9 Oct 2021 10:04:16 -0400
Subject: [PATCH 9/9] Swagger docs definition

---
 app/app.py | 80 ++++++++++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 68 insertions(+), 12 deletions(-)

diff --git a/app/app.py b/app/app.py
index 44e21c1..659409f 100644
--- a/app/app.py
+++ b/app/app.py
@@ -566,6 +566,9 @@ def create_app(args):
                 frontendTimeout:
                   type: integer
                   description: Frontend translation timeout
+                suggestions:
+                  type: boolean
+                  description: Whether submitting suggestions is enabled.
                 language:
                   type: object
                   properties:
@@ -606,21 +609,65 @@ def create_app(args):
             }
         )
 
-    swag = swagger(app)
-    swag["info"]["version"] = "1.2"
-    swag["info"]["title"] = "LibreTranslate"
-
-    @app.route("/spec")
-    @limiter.exempt
-    def spec():
-        return jsonify(swag)
-
-
     @app.route("/suggest", methods=["POST"])
     @limiter.exempt
     def suggest():
-        if args.suggestions is False:
-            abort(404)
+        """
+        Submit a suggestion to improve a translation
+        ---
+        tags:
+          - feedback
+        parameters:
+          - in: formData
+            name: q
+            schema:
+              type: string
+              example: Hello world!
+            required: true
+            description: Original text
+          - in: formData
+            name: s
+            schema:
+              type: string
+              example: ¡Hola mundo!
+            required: true
+            description: Suggested translation
+          - in: formData
+            name: source
+            schema:
+              type: string
+              example: en
+            required: true
+            description: Language of original text
+          - in: formData
+            name: target
+            schema:
+              type: string
+              example: es
+            required: true
+            description: Language of suggested translation
+        responses:
+          200:
+            description: Success
+            schema:
+              id: suggest-response
+              type: object
+              properties:
+                success:
+                  type: boolean
+                  description: Whether submission was successful
+          403:
+            description: Not authorized
+            schema:
+              id: error-response
+              type: object
+              properties:
+                error:
+                  type: string
+                  description: Error message
+        """
+        if not args.suggestions:
+            abort(403, description="Suggestions are disabled on this server.")
 
         q = request.values.get("q")
         s = request.values.get("s")
@@ -630,6 +677,15 @@ def create_app(args):
         SuggestionsDatabase().add(q, s, source_lang, target_lang)
         return jsonify({"success": True})
 
+    swag = swagger(app)
+    swag["info"]["version"] = "1.2.1"
+    swag["info"]["title"] = "LibreTranslate"
+
+    @app.route("/spec")
+    @limiter.exempt
+    def spec():
+        return jsonify(swag)
+
     SWAGGER_URL = "/docs"  # URL for exposing Swagger UI (without trailing '/')
     API_URL = "/spec"