diff --git a/14/umbraco-cms/customizing/foundation/working-with-data/repositories.md b/14/umbraco-cms/customizing/foundation/working-with-data/repositories.md
index 1998828021c..b094f93569e 100644
--- a/14/umbraco-cms/customizing/foundation/working-with-data/repositories.md
+++ b/14/umbraco-cms/customizing/foundation/working-with-data/repositories.md
@@ -20,12 +20,12 @@ const repositoryManifest = {
};
```
-With a repository we can have different data sources depending on the state of the app. It can be from a server, an offline database, a store, a Signal-R connection, etc. That means that the consumer will not have to be concerned how to access the data, add or remove items from a collection of items, etc. This means we get a loose connection between the consumer and the data-storing procedures hiding all complex implementation.
+With a repository we can have different data sources depending on the state of the app. The data sources can come from places like a server, an offline database, a store, or a Signal-R connection. That means that the consumer will not have to be concerned how to access the data, add or remove items from a collection, etc. This means we get a loose connection between the consumer and the data-storing procedures hiding all complex implementation.
### Data flow with a repository
Data flow
-A repository has to be instanced in the context where it is used. It should take a host element as part of the constructor, so any contexts consumed in the repository (notifications, modals, etc.) get rendered in the correct DOM context.
+A repository has to be instanced in the context where it is used. It should take a host element as part of the constructor. This ensures that any contexts consumed in the repository, like notifications or modals, are rendered in the correct DOM context.
A repository can be called directly from an element, but will often be instantiated in a context, like the Workspace Context.
diff --git a/15/umbraco-cms/customizing/foundation/working-with-data/repositories.md b/15/umbraco-cms/customizing/foundation/working-with-data/repositories.md
index 1998828021c..b094f93569e 100644
--- a/15/umbraco-cms/customizing/foundation/working-with-data/repositories.md
+++ b/15/umbraco-cms/customizing/foundation/working-with-data/repositories.md
@@ -20,12 +20,12 @@ const repositoryManifest = {
};
```
-With a repository we can have different data sources depending on the state of the app. It can be from a server, an offline database, a store, a Signal-R connection, etc. That means that the consumer will not have to be concerned how to access the data, add or remove items from a collection of items, etc. This means we get a loose connection between the consumer and the data-storing procedures hiding all complex implementation.
+With a repository we can have different data sources depending on the state of the app. The data sources can come from places like a server, an offline database, a store, or a Signal-R connection. That means that the consumer will not have to be concerned how to access the data, add or remove items from a collection, etc. This means we get a loose connection between the consumer and the data-storing procedures hiding all complex implementation.
### Data flow with a repository
Data flow
-A repository has to be instanced in the context where it is used. It should take a host element as part of the constructor, so any contexts consumed in the repository (notifications, modals, etc.) get rendered in the correct DOM context.
+A repository has to be instanced in the context where it is used. It should take a host element as part of the constructor. This ensures that any contexts consumed in the repository, like notifications or modals, are rendered in the correct DOM context.
A repository can be called directly from an element, but will often be instantiated in a context, like the Workspace Context.
