Differences

This shows you the differences between two versions of the page.

--- librematch:design:backend:openapi:start [2022-10-27 22:52] – ↷ Page moved from librematch:backend:openapi:start to librematch:design:backend:openapi:start simonsan
+++ librematch:design:backend:openapi:start [2022-11-28 21:51] (current) – [Deviations from Guidelines] simonsan
@@ Line 8: / Line 8: @@
   - ** [[https://github.com/swagger-api/swagger-ui|SwaggerUI]] **
-**ReDoc** has premium services and we need to check if although it looks more beautiful it's worth to opt-in to their free stage or if **SwaggerUI** is enough.
+**ReDoc** has premium services and we need to check if although it looks more beautiful it's worth to opt in to their free stage or if **SwaggerUI** is enough.
 ===== API first principle =====
@@ Line 23: / Line 23: @@
 ===== Deviations from Guidelines =====
-  - We don't use **kebap case** and **snake case** instead as the dash can easily introduce bugs as it can be interpreted as a minus sign.
+  - We don't use **kebab case** and **snake case** instead as the dash can easily introduce bugs as it can be interpreted as a minus sign.
+  - We might want to use [[https://calver.org/|CalVer]] ([[https://docs.github.com/en/rest/overview/api-versions?apiVersion=2022-11-28|Read github notes]])
 ===== Assigning Scopes =====