From 69a999054f8c58ad443af6ba3e17803e5fa0b5cc Mon Sep 17 00:00:00 2001
From: Marco Holz <marco.holz@fitko.de>
Date: Tue, 23 Feb 2021 19:57:48 +0000
Subject: [PATCH] Add README.md

---
 README.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 00000000..90e18f04
--- /dev/null
+++ b/README.md
@@ -0,0 +1,28 @@
+# FIT-Connect API-Spezifikation
+
+Für die Spezifikation der FIT-Connect-Schnittstellen gelten die folgenden Architekturregeln.
+
+## OpenAPI
+- Wir verwenden OpenAPI 3.0
+- Die Spezifikation wird bis zur `beta7` als JSON und ab `beta8` als YAML geschreiben
+- Wir verwenden keine Versionsnummern in Dateinamen, da das Repo als Ganzes versioniert wird
+
+## Verzeichnisse
+Das Projektverzeichnis ist wie folgt aufgebaut:
+
+- 📁`assets`
+  - 📁`images` - Bilder
+  - 📁`postman` - Postman-Collection und -Enviroment dazu
+- 📁`docs` - Öffentliche Dokumentation zu den APIs
+- 📁`models` - Modelle, die von mehreren (beiden) APIs verwendet werden
+- 📁`reference` - Die APIs
+- 📄`LICENSE`
+
+## Bezeichner
+- Die Bezeichner werden camelCase geschreiben und beginnen mit einem Kleinbuchstaben
+- Eine ID (Identifikator) wird als `Id` (nicht `ID`) geschrieben
+
+## Pfade
+Multiple Resoucen werden im Pfad durch eine Collection-Resource und einer nachfolgenden ID aufgenommen
+
+Beispiel: `/destinations/{destinationId}/applications/{applicationId}`
-- 
GitLab