fix: Specify order of elements in list endpoints properly (planning#1653)

CHANGELOG.md

@@ -19,6 +19,10 @@ Don’t forget to tag @ https://git.fitko.de/fit-connect/submission-api/-/tags
 
 ## [Unreleased]
 
+### Changed
+
+* Die Reihenfolge von Elementen in Listen-Endpunkten wird nun verbal klarer spezifiziert ([planning#1653](https://git.fitko.de/fit-connect/planning/-/issues/1653)).
+
 ## [1.4.1]
 
 ### Changed

spec/endpoints/cases/events/index.yaml

@@ -7,6 +7,7 @@ get:
   description: >
     Über diesen Endpunkt kann der [Event Log](https://docs.fitko.de/fit-connect/docs/getting-started/event-log/overview) eines Vorgangs
     abgerufen werden, um z.B. den Status des Vorgangs zu überprüfen.
+    Die Einträge haben eine stabile, aber nicht näher spezifizierte Reihenfolge.
   tags:
     - Vorgangsverwaltung
   security:

spec/endpoints/destinations/index.yaml

 get:
   operationId: get-my-destinations
   summary: Eigene Zustellpunkte auflisten
-  description: Mit diesem Request können alle selbst angelegten Zustellpunkte sowie deren Konfigurationen abgerufen werden.
+  description: >
+   Mit diesem Request können alle selbst angelegten Zustellpunkte sowie deren Konfigurationen abgerufen werden.
+   Die Einträge haben eine stabile, aber nicht näher spezifizierte Reihenfolge.
   tags:
     - Internal
   security:

spec/endpoints/submissions/index.yaml

@@ -3,7 +3,7 @@ get:
   summary: Abholbereite (Status SUBMITTED) Einreichungen auflisten
   description: >
     Mit diesem Request werden alle abholbereiten Einreichungen sowie deren Zustellpunkte aufgelistet.
-    Bei den zurückgegeben Einreichungen wird keine Sortierung gewährleistet.
+    Die Einreichungen haben eine stabile Reihenfolge und sind in dieser nach ihrer Destination gruppiert.
   tags:
     - Einreichungsempfang
   security: