docs: update documentation

Signed-off-by: Mats Johansson <extern.mats.johansson@digg.se>

Author: mmjohansson

GUIDELINES.md

@@ -169,7 +169,13 @@ Regeln förutsätter att det finns en förekomst av objektet `info` med underlig
 
 **Exempel:**
 
-![Exempelbild som visar var description ska finnas i en OpenAPI Description](images/dok6.png)
+![Exempelbild som visar att pipesymbolen kan användas för att skriva beskrivningen över flera rader i en OpenAPI Description](images/dok6-1.png)
+
+_Pipesymbolen kan med fördel användas när beskrivningen sträcker sig över flera rader eller stycken._
+
+![Exempelbild som visar att större än-tecknet kan använndas för att skriva beskrivningen över flera rader i en OpenAPI Description](images/dok6-2.png)
+
+_Större än-tecknet kan också användas när beskrivningen sträcker sig över flera rader eller stycken._
 
 ---
 

REUSE.toml

@@ -31,7 +31,8 @@ path = [
     "images/dok19.png",
     "images/dok20.png",
     "images/dok3.png",
-    "images/dok6.png",
+    "images/dok6-1.png",
+    "images/dok6-2.png",
     "images/dok7.png",
     "images/dot1-2.png",
     "images/dot1.png",

apis/dok-api.yaml

@@ -6,7 +6,14 @@ openapi: '3.0.0'
 info:
   version: 1.0.0
   title: AME
-  description: API message
+  description: >
+    När dokumentationen består av flera stycken kan också större än-tecknet användas.
+    Då ersätts radbrytningar med mellanslag.
+    Tomma rader bevaras däremot som styckeavgränsare.
+
+    When the documentation consists of multiple paragraphs, the greater-than operator can be used.
+    This converts line breaks into spaces.
+    However, empty lines are preserved as paragraph separators.
   termsOfService: http://swagger.io/terms/
   contact:
     name: Swagger API Team