docs: wordings

spec/endpoints/destinations/create-destination.yml

 operationId: create-destination
 summary: Zustellpunkt anlegen
-description: 'Erstellung eines neuen Zustellpunktes mit bestimmten, unterstüzten Antragsschemata.'
+description: Erstellung eines neuen Zustellpunktes mit unterstüzten Antragsschemata.
 tags:
   - Destination Management
 security:
@@ -15,7 +15,6 @@ requestBody:
       examples:
         example-1:
           $ref: '../../examples/destination-request.yml'
-  description: Struktur zur Erstellung eines neuen Zustellpunktes
 responses:
   '201':
     description: Created
@@ -56,4 +55,4 @@ callbacks:
                 $ref: '../../schemas/list-of-application-ids.yml'
         responses:
           '202':
-            description: Accepted
\ No newline at end of file
+            description: Accepted

spec/endpoints/destinations/update-destination.yml

 operationId: update-destination
 summary: Zustellpunkt aktualisieren
-description: Ermöglicht es bestimmte Attribute eines Zustellpunktes zu aktualisieren.
+description: Aktualisiert einen Zustellpunkt.
 tags:
   - Destination Management
 security:
@@ -49,4 +49,4 @@ responses:
     content:
       application/json:
         schema:
-          $ref: ../../responses/error-response.yml
\ No newline at end of file
+          $ref: ../../responses/error-response.yml

spec/endpoints/documents/get-document.yml

 operationId: get-application-document
 summary: Get Application Document
-description: Ruf ein Dokument (Formular oder Anlage) der Application ab.
+description: Ruf ein Dokument (z.B. Antragsformular / Anlage) der Application ab.
 tags:
   - Application Retrieval
 security:
@@ -40,4 +40,4 @@ responses:
     content:
       application/json:
         schema:
-          $ref: ../../responses/error-response.yml
\ No newline at end of file
+          $ref: ../../responses/error-response.yml

spec/endpoints/documents/upload-document.yml

 operationId: add-application-document
 summary: Add Application Document
-description: 'Lädt ein verschlüsseltes und über Base64 kodiertes Antragsformuar oder Anhang hoch, um ihn dem Antrag hinzuzufügen.'
+description: Fügt ein verschlüsseltes, base64 kodiertes Antragsformular / Anhang einem Antrag hinzu.
 tags:
   - Application Transfer
 security:
@@ -51,4 +51,4 @@ responses:
     content:
       application/json:
         schema:
-          $ref: ../../responses/error-response.yml
\ No newline at end of file
+          $ref: ../../responses/error-response.yml

spec/parameters/documentId.yml

@@ -6,4 +6,4 @@ schema:
   format: uuid
   minLength: 32
   maxLength: 36
-description: Die ID des Dokuments im Format einer UUID v4, die vom API-Nutzer selbst definiert werden kann, um Referenzen in den Fachdaten des Antrags zu ermöglichen
\ No newline at end of file
+description: Die ID des Dokuments im Format einer UUID v4, die vom API-Nutzer selbst definiert werden kann, um Referenzen in den Fachdaten des Antrags zu ermöglichen.

spec/security/oauth2.yml

-description: 'Dieses Authentifizierungsmethode wird genutzt, um den Zugriff auf die API zu autorisieren. (RFC8725)'
+description: Diese Authentifizierungsmethode wird genutzt, um den Zugriff auf die API nach RFC8725 zu autorisieren.
 type: oauth2
 flows:
   clientCredentials:
@@ -6,4 +6,4 @@ flows:
     scopes:
       'destination:send': Dieser Zufriffsbereich erlaubt es Anträge an Zustellpunkte über die Application Sender API zu senden.
       'destination:manage': Erlaubt die volle Verwaltung der Zustellpunkte.
-      'destination:susbcribe': Dieser Zufriffsbereich erlaubt über den Callback erhaltene Anträge abzufragen und abzuarbeiten.
\ No newline at end of file
+      'destination:susbcribe': Dieser Zufriffsbereich erlaubt über den Callback erhaltene Anträge abzufragen und abzuarbeiten.