docs: fix typos / words

docs/details/jwk-creation.md

@@ -3,24 +3,24 @@ FIT-Connect verwendet zur Übertragung von Antragsdaten und Metadaten mit direkt
 Im Folgenden soll die Erstellung von JWKs mithilfe eines einfachen in Python geschriebenen Skriptes unter Windows und Linux erläutert werden.
 
 ## Voraussetzungen
-Die Ausführung des Skriptes setzt eine installierte Version von [Python]( https://www.python.org/) voraus. Zum Nachinstallieren von benötigten Paketen wird Paketverwaltungsprogramm **pip** benötigt. Bei Versionen vor 3.4 ist ggf. noch eine manuelle Installation erforderlich.
+Die Ausführung des Skriptes setzt eine installierte Version von [Python](https://www.python.org/) voraus. Zum Nachinstallieren von benötigten Paketen wird Paketverwaltungsprogramm **pip** benötigt. Bei Versionen vor 3.4 ist ggf. noch eine manuelle Installation erforderlich.
 
 ### Windows
-Eine Anleitung zur Installation und Einrichtung unter Windows finden Sie unter [Installationsanleitung Python Windows]( https://docs.microsoft.com/de-de/windows/python/beginners). 
+Eine Anleitung zur Installation und Einrichtung unter Windows finden Sie unter [Installationsanleitung Python Windows](https://docs.microsoft.com/de-de/windows/python/beginners).
 
 ### Linux
-Der Ablauf und die Befehle zur Installation und Einrichtung von Python unter Linux unterscheiden sich je nach verwendeter Distribution. 
+Der Ablauf und die Befehle zur Installation und Einrichtung von Python unter Linux unterscheiden sich je nach verwendeter Distribution.
 
-#### Für Ubuntu 
-[Installationsanleitung Python Ubuntu]( https://docs.python-guide.org/starting/install3/linux/) 
+#### Für Ubuntu
+[Installationsanleitung Python Ubuntu](https://docs.python-guide.org/starting/install3/linux/)
 
 Installation von **pip**
 ```console
 foo@bar:~$ sudo apt install python3-pip
 ```
 
-#### Für Debian 
-[Installationsanleitung Python Debian]( https://linuxize.com/post/how-to-install-python-3-9-on-debian-10/) 
+#### Für Debian
+[Installationsanleitung Python Debian](https://linuxize.com/post/how-to-install-python-3-9-on-debian-10/)
 
 Installation von **pip**
 ```console
@@ -28,7 +28,7 @@ foo@bar:~$ sudo apt install python3-pip
 ```
 
 #### Für Fedora
-[Installationsanleitung Python Fedora]( https://developer.fedoraproject.org/tech/languages/python/multiple-pythons.html) 
+[Installationsanleitung Python Fedora](https://developer.fedoraproject.org/tech/languages/python/multiple-pythons.html)
 
 ```console
 foo@bar:~$ yum -y install python-pip

docs/details/schema-reference.md

@@ -3,7 +3,7 @@
 Im Folgenden wird aufgezeigt, wie Fachschemarerenzen für Fachdatensätze auf bestehende Fachstandards und Rahmenwerke abgebildet werden. Aktuell
 werden folgende Fachstandards und Rahmenwerke beschrieben:
 - FIM Übertragungsschemata für Anträge auf Basis von FIM Datenfelder
-- XÖV Nachrichten auf Basis von XÖV-konformen Fachstandards 
+- XÖV Nachrichten auf Basis von XÖV-konformen Fachstandards
 
 Soll ein anderer Fachstandard mit der FIT-Conect Submission API übermittelt werden, können wir gerne die Beschreibung dieser Schemareferenz hier aufnehmen,
 um diese Informationen einem breiteren Nutzerkreis zugänglich zu machen. Hierzu bitte einfach Issue [hier](https://git.fitko.de/fit-connect/docs) aufmachen

docs/getting-started/overview.md

@@ -4,9 +4,11 @@ Im folgenden "Getting Started"-Guide wird beschrieben, wie die ersten Interaktio
 In den nächsten Abschnitten wird beschrieben, wie man sich [gegenüber FIT-Connect authentifiziert](./authentication.mdx), Daten für die Übertragung [ver- und entschlüsselt](./encryption.mdx) werden, sowie welche Schritte für das [Einreichen](./sending/overview.mdx) bzw. [Empfangen](./receiving/overview.mdx) von Einreichungen notwendig sind.
 
 :::note Zielgruppe
-Die folgenden Seiten beinhalten teils sehr technische Detailinformationen zur Umsetzung einer Anbindung an die FIT-Connect-Schnittstellen. Zielgruppe der folgenden Seiten sind vorangig Entwickler:innen.
+Die folgenden Seiten beinhalten technische Details zur Umsetzung einer Anbindung an die FIT-Connect-Schnittstellen.
+Zielgruppe sind vorrangig Entwickler:innen.
 :::
 
 Kern von FIT-Connect ist der Zustelldienst, der sendende und empfangende Systeme einer Einreichung verbindet.
 
-Jedes empfangende System (Fachverfahren / virtuelle Poststelle) verfügt über einen oder mehrere Zustellpunkte (Destinations), an die Einreichungen (Anträge oder Berichte) gesendet werden. Zustellpunkte können von empfangenden Systemen konfiguriert und von sendenden Systemen adressiert werden.
+Jedes empfangende System (Fachverfahren / virtuelle Poststelle) verfügt über einen oder mehrere Zustellpunkte (Destinations), an die Einreichungen (Anträge oder Berichte) gesendet werden.
+Zustellpunkte können von empfangenden Systemen konfiguriert und von sendenden Systemen adressiert werden.

docs/getting-started/receiving/query.mdx

@@ -6,7 +6,7 @@ title: Vorhandensein neuer Einreichungen prüfen
 import ApiLink from '@site/src/components/ApiLink'
 
 Empfangende Systeme können sich über den Eingang neuer Einreichungen entweder durch periodische Anfragen informieren (Polling) oder vom Zustelldienst über Callbacks aktiv benachrichtigen lassen.
-Letzteres stellt die empfohle Umsetzungsvariante dar, da hierdurch unnötige Anfragen vermieden werden können, was zu einer insgesamt besseren Performance und zu einer schnelleren Benachrichtung empfangnder Systeme führt.
+Letzteres stellt die empfohlene Umsetzungsvariante dar, da hierdurch unnötige Anfragen vermieden werden können, was zu einer insgesamt besseren Performance und zu einer schnelleren Benachrichtigung empfangender Systeme führt.
 
 ## Callback
 Wenn eine Callback-URL im Zustellpunkt hinterlegt ist, kann der Zustelldienst den Zustellpunkt aktiv via Callback über neue Einriechungen informieren.

docs/getting-started/receiving/validate.mdx

@@ -20,8 +20,7 @@ Danach erfolgt eine Prüfung des Fachdatensatzes:
 - Entspricht der Fachdatensatz dem vereinbarten Medientyp (JSON oder XML)?
 - Entspricht der Fachdatensatz dem vereinbarten Schema?
 
-Hierbei kann die im Metadatensatz enthaltene Schemareferenz genutzt werden, um das zu validierende Schema zu identifizieren, wenn im Zustellpunkt mehrere 
-Schemata für Fachdatensätze unterschützt werden.
+Hierbei kann die im Metadatensatz enthaltene Schemareferenz genutzt werden, um das zu validierende Schema zu identifizieren, wenn im Zustellpunkt mehrere Schemata für Fachdatensätze unterstützt werden.
 
 Das Validierungsvorgehen wird im folgenden Anhand von Bespielen für FIM- und XÖV-Fachdatensätzen gezeigt.
 

docs/getting-started/sending/get-destination.mdx

@@ -5,11 +5,10 @@ title: Zustellpunkt ermitteln
 
 import Tabs from '@theme/Tabs'
 import TabItem from '@theme/TabItem'
-import ApiLink from '@site/src/components/ApiLink'
 
 ## Zustellpunkt und `destinationId` ermitteln
 
-Um eine Einreichung an die fachlich korrekte Stelle sicherzustellen und die technischen Parameter des richtigen Zustellpunkt zu ermitteln, muss die `destinationId` der zuständigen Stelle ermittelt werden. Zukünftig wird die Ermittlung der `destinationId` und die Ermittlung der technischen Parameter über die FIT-Connect Routing API möglich sein. Sobald die Routing API umgesetzt ist (voraussichtlich Ende Q3 2021), wird diese Möglichkeit hier beschrieben.
+Um eine Einreichung an die fachlich korrekte Stelle sicherzustellen und die technischen Parameter des richtigen Zustellpunkts zu ermitteln, muss die `destinationId` der zuständigen Stelle ermittelt werden. Zukünftig wird die Ermittlung der `destinationId` und die Ermittlung der technischen Parameter über die FIT-Connect Routing API möglich sein. Sobald die Routing API umgesetzt ist (voraussichtlich Ende Q3 2021), wird diese Möglichkeit hier beschrieben.
 
 ## Informationen des Zustellpunktes erhalten
 
@@ -17,7 +16,7 @@ Um an einen Zustellpunkt eine Einreichung korrekt zu übermitteln, ist es notwen
 Diese Informationen sind:
 - Die Verwaltungsleistungen (`services`), die über diesen Zustellpunkt abgebildet werden, bestehend aus:
   - einem Identifikator der Verwaltungsleitung (`identifier`): Typischerweise entspricht dieser einem LeiKa-Schlüssel (siehe [Leistungskatalog im FIM-Portal](https://fimportal.de/kataloge#download-leistungen)).
-  - einer Liste an zulässigen Fachdatenschemata (`submissionSchemas`): Hiermit legt das empfangende System fest, welchem Schema die übergebenen Fachdatensätze entsprechen müssen. Welches der angebenen Schemata verwendet werden muss, bestimmt das sendende System aus dem eigenen fachlichen Kontext heraus. Wenn bspw. ein Antrag für einen Schwerbehindertenausweis gestellt wird, muss der Fachdatensatz aus den dort hinterlegten Schemata gemäß dem dortigen Schema für den Schwerbehindertausweis (bspw. ein FIM/XFall Schema) entsprechen.
+  - einer Liste an zulässigen Fachdatenschemata (`submissionSchemas`): Hiermit legt das empfangende System fest, welchem Schema die übergebenen Fachdatensätze entsprechen müssen. Welches der angegebenen Schemata verwendet werden muss, bestimmt das sendende System aus dem eigenen fachlichen Kontext heraus. Wenn bspw. ein Antrag für einen Schwerbehindertenausweis gestellt wird, muss der Fachdatensatz aus den dort hinterlegten Schemata gemäß dem dortigen Schema für den Schwerbehindertenausweis (bspw. ein FIM/XFall Schema) entsprechen.
   - einer Liste an Regionen (`regions`), für die die Verwaltungsleistung angeboten wird.
 - Schlüssel-ID des öffentlichen Verschlüsselungsschlüssels (`encryptionKid`): Empfangende Systeme veröffentlichen die Schlüssel-ID ihres Verschlüsselungsschlüssels für die Verschlüsselung von Einreichungen. Der dazugehörige JSON Web Key (JWK) kann anschließend über den Endpunkt <ApiLink to="/destinations/{destinationId}/keys/{keyId}" /> abgefragt werden.
 

docs/getting-started/sending/query-status.mdx

@@ -68,4 +68,4 @@ Die Überprüfung ist im Artikel zum [Event Log](../event-log.mdx#set-validation
 
 :::caution Hinweis
 Der Mechanismus zum Abrufen von kryptografischen Schlüsseln des empfangenden Systems zur Signaturprüfung wird sich bis zur Veröffentlichung der finalen API-Spezifikation noch einmal ändern.
-:::
+:::
\ No newline at end of file

docs/getting-started/sending/start-submission.mdx

@@ -12,7 +12,7 @@ Die Inhalte umfassen hierbei die Identifikatoren der Anlagen als UUIDs und die I
 Die UUIDs der Anlagen müssen eindeutig sein und werden vom sendenden System festgelegt.
 
 :::note Hinweis
-Die Struktur von Einreichungen und die Referenzierung von Fachdatenschemata ist im Artikel [Aufbau einer Einreichung](../submission-structure.md) näher beschrieben.
+Die Struktur von Einreichungen und die Referenzierung von Fachdatenschemata ist im Artikel [Aufbau einer Einreichung](../submission-structure.mdx) näher beschrieben.
 :::
 
 <Tabs

docs/getting-started/submission-structure.mdx

+import ApiLink from '@site/src/components/ApiLink'
+
 # Aufbau einer Einreichung
 
 Der zentrale Anwendungsfall der Submission API besteht darin, Daten im Rahmen von Verwaltungsverfahren an hoheitliche Stellen (Behörden, Handelskammern, etc.) zu übermitteln.
 Diese Daten werden durch Kunden und Verfahrenspartner übermittelt, um Verfahren (bspw. über einen Antrag) zu starten oder um Berichtspflichten zu erfüllen.
 
-Diese Datenübermittlung wird in der Submission API als Einreichung (`submission`) bezeichnet und besitzt eine festgelegte Struktur aus Datenobjekten, die über die Ressourcen
-der Submission API abgebildet werden. Mit dieser Struktur soll eine standardisierte Verarbeitung und Interpretation der einzelnen Bestandteile einer Einreichung ermöglicht werden.
+Diese Datenübermittlung wird in der Submission API als Einreichung (`submission`) bezeichnet und besitzt eine festgelegte Struktur aus Datenobjekten, die über die Ressourcen der Submission API abgebildet werden.
+Mit dieser Struktur soll eine standardisierte Verarbeitung und Interpretation der einzelnen Bestandteile einer Einreichung ermöglicht werden.
 
-Einreichung können aus fachlicher Sicht Anträge (bspw. ein strukturierter Datensatz mit den Daten eines Wohngeldantrags und Anlagen in beliebigen Datenformaten wie einer Urkunde als PDF), Berichte (bspw. ein Datensatz wie eine elektronische Bilanz in einem festlegten Berichtsformat für Statistik- oder Sozialmeldenungen) oder sonstige prozessauslösende Datensätze sein, die an Systeme von hoheitlichen Stellen übermittelt werden.
+Einreichung können aus fachlicher Sicht Anträge (bspw. ein strukturierter Datensatz mit den Daten eines Wohngeldantrags und Anlagen in beliebigen Datenformaten wie einer Urkunde als PDF), Berichte (bspw. ein Datensatz wie eine elektronische Bilanz in einem festlegten Berichtsformat für Statistik- oder Sozialmeldungen) oder sonstige prozessauslösende Datensätze sein, die an Systeme von hoheitlichen Stellen übermittelt werden.
 
 ## Wie ist eine Einreichung aufgebaut?
 
 ![Struktur einer Einreichung](/images/schema_reference/submission_structure.svg)
 
 Eine Einreichung, die über die Submission API übermittelt wird, besteht aus drei Bestandteilen:
+
 - Ein optionaler Fachdatensatz (`data`), der die Daten eines Antrags oder Berichts enthält und einem im Zustellpunkt vorgegebenen Datenschema (`submissionSchema`) entspricht.
-- Eine oder mehrere optionale Anlagen (`attachments`) ergänzend zum Fachdatensatz. Die können Nachweise in Form von PDF-Urkunden, Bauanlagen wie XPlanGML-basierte Baupläne oder auch technische Laufzettel vom sendenden System sein.
+- Eine oder mehrere optionale Anlagen (`attachments`) ergänzend zum Fachdatensatz.
+Die können Nachweise in Form von PDF-Urkunden, Bauanlagen wie XPlanGML-basierte Baupläne oder auch technische Laufzettel vom sendenden System sein.
 - Ein obligatorischer Metadatensatz `metadata`), der die Einreichung beschreibt und zusammen mit der Submission API im Rahmen von FIT-Connect standardisiert wird.
-Dieser enthält Strukturinformationen zum Fachdatensatz und Anlagen sowie prozessrelevante Informationen wie die Authentizierung des Absenders, Zahlungsinformationen (z.B. von Verfahrensgebühren) oder Rückkanalwünschen.
+Dieser enthält Strukturinformationen zum Fachdatensatz und Anlagen sowie prozessrelevante Informationen wie die Authentisierung des Absenders, Zahlungsinformationen (z.B. von Verfahrensgebühren) oder Rückkanalwünschen.
 
 ## Wie stimmen sich sendende und empfangende Systeme beim Inhalt einer Einreichung ab?
 
-In der Submission API wird durch das empfangende System über eine Schemaferenz im Zustellpunkt ein konkretes Schema für den Fachdatensatz festgelegt, den das sendende System übersenden darf. Eine Fachschemareferenz besteht aus zwei Angaben:
+In der Submission API wird durch das empfangende System über eine Schemareferenz im Zustellpunkt ein konkretes Schema für den Fachdatensatz festgelegt, den das sendende System übersenden darf. Eine Fachschemareferenz besteht aus zwei Angaben:
+
 - Die `schemaURI` referenziert das zu verwendende Fachschema.
 - Der `mimeType` gibt den Datentyp (JSON oder XML) des Fachdatensatzes vor.
 
 In den Angaben eines Zustellpunkts befindet sich die Fachschemareferenz immer innerhalb eines Service-Objekts innerhalb des `services` Arrays.
-Die Fachschemarefenz ist im Zustellpunkt daher immer einer dazugehörigen Leistung zugeordnet.
+Die Fachschemareferenz ist im Zustellpunkt daher immer einer dazugehörigen Leistung zugeordnet.
 
 ```json
 "services":[
@@ -78,16 +83,18 @@ Zusätzlich muss das sendende System eine identische Fachschemareferenz in den M
 }
 ```
 
-Insbesondere wenn ein empfangendes System viele unterschiedliche Schemata über den Zustellpunkt unterstützt, hilft diese Angabe bei der effizienten Validierung des Fachdatensatzes. Dies ist insbesondere dann relevant, wenn keine eindeutige Schemareferenz im Fachdatensatz enthalten ist.
+Insbesondere wenn ein empfangendes System viele unterschiedliche Schemata über den Zustellpunkt unterstützt, hilft diese Angabe bei der effizienten Validierung des Fachdatensatzes.
+Dies ist insbesondere dann relevant, wenn keine eindeutige Schemareferenz im Fachdatensatz enthalten ist.
 
 ## Sind Vorgaben für die Anzahl der Anlagen und deren Format möglich?
 
-Aktuell sind keine konkreten Vorgaben für die Anzahl und das Format der Anlagen durch ein empfangendes Sytem über die Angaben im Zustellpunkt möglich.
+Aktuell sind keine konkreten Vorgaben für die Anzahl und das Format der Anlagen durch ein empfangendes System über die Angaben im Zustellpunkt möglich.
 Aktuell existieren lediglich Vorgaben für die Gesamtgröße einer Einreichung (Fachdatensatz+Anlagen), die den Umfang der Anlagen hinsichtlich der Datengrößen begrenzen.
-Für sonstige technische Vorgaben für Anlagen wird aktuell davon ausgegangen, dass die Fachstandards, zu denen ein genutzter Fachdatensatz gehört, technische Vorgaben für Anlagen machen. Ansonsten sollte ein empfangendes System im Mimimum PDF als Format für Anlagen akzeptieren.
+Für sonstige technische Vorgaben für Anlagen wird aktuell davon ausgegangen, dass die Fachstandards, zu denen ein genutzter Fachdatensatz gehört, technische Vorgaben für Anlagen machen.
+Ein empfangendes System sollte mindestens Anlagen im PDF-Format akzeptieren.
 
 Es wird für sendende Systeme empfohlen, auf den Versand eigener proprietärer Anlagen zu verzichten, wenn deren Nutzung nicht explizit mit den empfangenden Stellen abgestimmt wurde.
 
 ## Meine Software übermittelt oder empfängt nach Standard XYZ Fachdatensätze, wie kann ich das jeweils genutzte Fachschema korrekt referenzieren?
 
-Eine Erläuerung der Schemareferenzen für die gängigsten Fachstandards der Verwaltung findet sich [hier](/details/schema-reference.md).
+Eine Erläuterung der Fachschemareferenzen für die gängigsten Fachstandards der Verwaltung findet sich [hier](/details/schema-reference.md).