docs: small social media system example

examples/social-media/common/messages.yaml

@@ -1,12 +1,16 @@
-commentLiked: 
+commentLiked:
+  description: Message that is being sent when a comment has been liked by someone.
   payload: 
     $ref: './schemas.yaml#/commentLikedPayload'
 likeComment: 
+  description: Message that is being sent when someone wants to like a comment.
   payload: 
     $ref: './schemas.yaml#/likeCommentPayload'
-commentChanged: 
+commentChanged:
+  description: Message that is being sent when a comment have been updated.
   payload: 
-    $ref: './schemas.yaml#/commentChangedPayload'
+    $ref: './schemas.yaml#/commentChanged'
 updateCommentLikes: 
+  description: Message that is being sent when a comment have been updated.
   payload: 
     $ref: './schemas.yaml#/updateCommentLikesPayload'

examples/social-media/common/schemas.yaml

@@ -16,6 +16,10 @@ likeCommentPayload:
       allOf: 
         - $ref: '#/commentId'
         - description: Id of the comment that should be liked
+    likedBy:
+      allOf: 
+        - $ref: '#/commentId'
+        - description: The id of the user that have liked the comment
 commentChangedPayload: 
   type: object
   title: commentChangedPayload
@@ -25,6 +29,9 @@ commentChangedPayload:
       allOf: 
         - $ref: '#/commentId'
         - description: Id of the comment that was changed, such as when someone liked it.
+    likeCount:
+      type: integer
+      description: The new like count of how many have liked the comment.
 updateCommentLikesPayload:
   type: object
   title: updateCommentLikesPayload
@@ -34,5 +41,10 @@ updateCommentLikesPayload:
       allOf: 
         - $ref: '#/commentId'
         - description: Id of the comment that was changed, such as when someone liked it.
+    likeCount:
+      type: integer
+      description: The new like count of how many have liked the comment.
 commentId:
   type: string
+userId:
+  type: string