Improvements to wording and naming

TheCakeMonster · Apr 21, 2022 · c1686df · c1686df
1 parent 06d0f60
commit c1686df
Show file tree

Hide file tree

Showing 2 changed files with 11 additions and 16 deletions.
diff --git a/docs/C4Container.puml b/docs/C4Container.puml
@@ -22,17 +22,17 @@ System_Boundary(summarisationSample, "Summarisation Sample") {
 
     ContainerDb(kafka, "Message Bus", "Kafka", "Messaging", $sprite="kafka")
 
-    Container(ordersService, "Order Service", "C#, WebAPI", "Order microservice, responsible for managing orders")
-    ContainerDb(ordersDB, "Orders Database", "PostgreSQL", "Holds order information", $sprite="postgresql")
-    Rel(ordersService, ordersDB, "CRUD", "Entity Framework")
-    Rel(ordersService, kafka, "Publishes Messages", "TCP")
-    Rel(customerGateway, ordersService, "Place Order", "HTTPS")
-
-    Container(activitiesService, "Activity Service", "C#, WebAPI", "Activity microservice, responsible for tracking important system activities")
-    ContainerDb(activitiesDB, "Activities Database", "PostgreSQL", "Holds activity summaries", $sprite="postgresql")
-    Rel(activitiesService, activitiesDB, "CRUD", "Entity Framework")
-    Rel(activitiesService, kafka, "Subscribes to Messages", "TCP")
-    Rel(managementGateway, activitiesService, "Get Summary", "HTTPS")
+    Container(orderService, "Order Service", "C#, WebAPI", "Order microservice, responsible for managing orders")
+    ContainerDb(ordersDB, "Orders Database", "PostgreSQL", "Holds order details and status", $sprite="postgresql")
+    Rel(orderService, ordersDB, "CRUD", "Entity Framework")
+    Rel(orderService, kafka, "Publishes Messages", "TCP")
+    Rel(customerGateway, orderService, "Place Order", "HTTPS")
+
+    Container(activityService, "Activity Service", "C#, WebAPI", "Activity microservice, responsible for tracking important system activities")
+    ContainerDb(activitiesDB, "Activities Database", "PostgreSQL", "Holds summaries/statistics of the activities performed in the system", $sprite="postgresql")
+    Rel(activityService, activitiesDB, "CRUD", "Entity Framework")
+    Rel(activityService, kafka, "Subscribes to Messages", "TCP")
+    Rel(managementGateway, activityService, "Get Summary", "HTTPS")
 }
 
 Rel(customer, customerSite, "Places Order", "HTTPS")

diff --git a/docs/SummarisationSample.Docs.sln b/docs/SummarisationSample.Docs.sln
@@ -9,11 +9,6 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Diagrams", "Diagrams", "{DA
 		C4SystemContext.puml = C4SystemContext.puml
 	EndProjectSection
 EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Templates", "Templates", "{0D0F88C4-F52C-4C46-8CB1-2DD828A51A43}"
-	ProjectSection(SolutionItems) = preProject
-		Templates\C4_Context.puml = Templates\C4_Context.puml
-	EndProjectSection
-EndProject
 Global
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE