fix

app/routers/convert.py

@@ -22,9 +22,32 @@ logger = logging.getLogger(__name__)
 router = APIRouter(tags=["konverze"])
 
 
+CONVERT_DESCRIPTION = """
+Prevede dokument a rovnou vrati `application/pdf`.
+
+Urceno pro mensi dokumenty. Konverze, ktera presahne `SYNC_TIMEOUT_SECONDS`
+(vychozi 60 s), se zrusi a sluzba vrati 413 s odkazem na POST /jobs.
+
+**Uchovavani souboru.** Vysledek se nikam neuklada. Vznikne v docasnem adresari,
+odesle se v teto odpovedi a hned po jejim odeslani se i s pracovnim adresarem
+smaze. Neexistuje zadna adresa, ze ktere by sel stahnout znovu, opakovane
+stazeni znamena novou konverzi. Pokud vysledek potrebujete pozdeji, pouzijte
+POST /jobs.
+
+Hlavicky odpovedi:
+
+- `X-Page-Count` pocet stranek vysledku
+- `X-Engine-Used` engine, ktery dokument vyrenderoval
+- `X-Missing-Assets` pocet assetu, ktere se nepodarilo nacist, hlavicka je jen
+  pri nenulove hodnote. Cely seznam vraci jen asynchronni cesta.
+- `X-Warnings` pocet varovani, hlavicka je jen pri nenulove hodnote
+"""
+
+
 @router.post(
     "/convert",
     summary="Synchronni prevod HTML na PDF",
+    description=CONVERT_DESCRIPTION,
     response_class=Response,
     responses={
         200: {"content": {"application/pdf": {}}, "description": "Hotove PDF."},