diff --git a/10/umbraco-cms/reference/management/models/contenttype.md b/10/umbraco-cms/reference/management/models/contenttype.md
index b0ff4e2064a..4e86532fc6c 100644
--- a/10/umbraco-cms/reference/management/models/contenttype.md
+++ b/10/umbraco-cms/reference/management/models/contenttype.md
@@ -8,7 +8,7 @@ A ContentType corresponds to the Document Type found in the backoffice. The Cont
 
 A Document Type is composed by Properties, which are grouped by Tabs (or PropertyGroups in the API). It can also inherit properties and tabs from other Document Types.
 
-It is also possible to link one or more Templates to a Document Type to choose how you want your model / data rendered to the user.
+It is possible to link one or more Templates to a Document Type. This determines how your model/data is rendered to the user.
 
 * **Namespace:** `Umbraco.Cms.Core.Models`
 * **Assembly:** `Umbraco.Core.dll`
@@ -28,7 +28,7 @@ using Umbraco.Cms.Core.Services;
 
 ### ContentType(IShortStringHelper shortStringHelper, IContentType parent, string alias)
 
-Constructor for creating a new `ContentType` object where the necessary parameters are a short string helper `IShortStringHelper`, the parent `ContentType` as an `IContentType` and the alias of the new `ContentType` as `string`.
+Constructor for creating a new `ContentType` object. The necessary parameters are a short string helper `IShortStringHelper`, the parent `ContentType` as an `IContentType` and the alias of the new `ContentType` as `string`.
 
 ### new ContentType(IShortStringHelper shortStringHelper, int parentId)
 
@@ -82,7 +82,7 @@ return contentType.AllowedTemplates;
 
 Gets a list of `ContentTypes` as `IContentTypeComposition` objects that make up a composition of PropertyGroups and PropertyTypes for the current ContentType.
 
-The ContentTypeComposition provides a mixin-type functionality in that you can compose a ContentType of one or more other ContentTypes in a complex structure. But please note that the backoffice does not fully support these complex structures yet.
+The ContentTypeComposition provides a mixin-type functionality in that you can compose a ContentType of one or more other ContentTypes in a complex structure. But please be aware that the backoffice does not fully support these complex structures yet.
 
 ```csharp
 // Given a `ContentTypeService` object get ContentType by its Id and return ContentTypeComposition
@@ -162,7 +162,7 @@ return contentType.Icon;
 
 ### .Id
 
-Gets the unique `ContentType` Id as a `Int`, this ID is based on a Database identity field, and is therefore not safe to reference in code which are moved between different instances, use Key instead.
+Gets the unique `ContentType` Id as an `Int`. The ID, derived from a database identity field, isn't safe for code references as they are moved across instances. Therefore it's recommended to use `Key` instead.
 
 ### .Key
 
diff --git a/12/umbraco-cms/reference/management/models/contenttype.md b/12/umbraco-cms/reference/management/models/contenttype.md
index d648efa214c..9fa7fc0f9a5 100644
--- a/12/umbraco-cms/reference/management/models/contenttype.md
+++ b/12/umbraco-cms/reference/management/models/contenttype.md
@@ -8,7 +8,7 @@ A ContentType corresponds to the Document Type found in the backoffice. The Cont
 
 A Document Type is composed by Properties, which are grouped by Tabs (or PropertyGroups in the API). It can also inherit properties and tabs from other Document Types.
 
-It is also possible to link one or more Templates to a Document Type to choose how you want your model / data rendered to the user.
+It is possible to link one or more Templates to a Document Type. This determines how your model/data is rendered to the user.
 
 * **Namespace:** `Umbraco.Cms.Core.Models`
 * **Assembly:** `Umbraco.Core.dll`
@@ -28,7 +28,7 @@ using Umbraco.Cms.Core.Services;
 
 ### ContentType(IShortStringHelper shortStringHelper, IContentType parent, string alias)
 
-Constructor for creating a new `ContentType` object where the necessary parameters are a short string helper `IShortStringHelper`, the parent `ContentType` as an `IContentType` and the alias of the new `ContentType` as `string`.
+Constructor for creating a new `ContentType` object. The necessary parameters are a short string helper `IShortStringHelper`, the parent `ContentType` as an `IContentType` and the alias of the new `ContentType` as `string`.
 
 ### new ContentType(IShortStringHelper shortStringHelper, int parentId)
 
@@ -82,7 +82,7 @@ return contentType.AllowedTemplates;
 
 Gets a list of `ContentTypes` as `IContentTypeComposition` objects that make up a composition of PropertyGroups and PropertyTypes for the current ContentType.
 
-The ContentTypeComposition provides a mixin-type functionality in that you can compose a ContentType of one or more other ContentTypes in a complex structure. But please note that the backoffice does not fully support these complex structures yet.
+The ContentTypeComposition provides a mixin-type functionality in that you can compose a ContentType of one or more other ContentTypes in a complex structure. But please be aware that the backoffice does not fully support these complex structures yet.
 
 ```csharp
 // Given a `ContentTypeService` object get ContentType by its Id and return ContentTypeComposition
@@ -162,7 +162,7 @@ return contentType.Icon;
 
 ### .Id
 
-Gets the unique `ContentType` Id as a `Int`, this ID is based on a Database identity field, and is therefore not safe to reference in code which are moved between different instances, use Key instead.
+Gets the unique `ContentType` Id as an `Int`. The ID, derived from a database identity field, isn't safe for code references as they are moved across instances. Therefore it's recommended to use `Key` instead.
 
 ### .Key
 
diff --git a/13/umbraco-cms/reference/management/models/contenttype.md b/13/umbraco-cms/reference/management/models/contenttype.md
index d648efa214c..9fa7fc0f9a5 100644
--- a/13/umbraco-cms/reference/management/models/contenttype.md
+++ b/13/umbraco-cms/reference/management/models/contenttype.md
@@ -8,7 +8,7 @@ A ContentType corresponds to the Document Type found in the backoffice. The Cont
 
 A Document Type is composed by Properties, which are grouped by Tabs (or PropertyGroups in the API). It can also inherit properties and tabs from other Document Types.
 
-It is also possible to link one or more Templates to a Document Type to choose how you want your model / data rendered to the user.
+It is possible to link one or more Templates to a Document Type. This determines how your model/data is rendered to the user.
 
 * **Namespace:** `Umbraco.Cms.Core.Models`
 * **Assembly:** `Umbraco.Core.dll`
@@ -28,7 +28,7 @@ using Umbraco.Cms.Core.Services;
 
 ### ContentType(IShortStringHelper shortStringHelper, IContentType parent, string alias)
 
-Constructor for creating a new `ContentType` object where the necessary parameters are a short string helper `IShortStringHelper`, the parent `ContentType` as an `IContentType` and the alias of the new `ContentType` as `string`.
+Constructor for creating a new `ContentType` object. The necessary parameters are a short string helper `IShortStringHelper`, the parent `ContentType` as an `IContentType` and the alias of the new `ContentType` as `string`.
 
 ### new ContentType(IShortStringHelper shortStringHelper, int parentId)
 
@@ -82,7 +82,7 @@ return contentType.AllowedTemplates;
 
 Gets a list of `ContentTypes` as `IContentTypeComposition` objects that make up a composition of PropertyGroups and PropertyTypes for the current ContentType.
 
-The ContentTypeComposition provides a mixin-type functionality in that you can compose a ContentType of one or more other ContentTypes in a complex structure. But please note that the backoffice does not fully support these complex structures yet.
+The ContentTypeComposition provides a mixin-type functionality in that you can compose a ContentType of one or more other ContentTypes in a complex structure. But please be aware that the backoffice does not fully support these complex structures yet.
 
 ```csharp
 // Given a `ContentTypeService` object get ContentType by its Id and return ContentTypeComposition
@@ -162,7 +162,7 @@ return contentType.Icon;
 
 ### .Id
 
-Gets the unique `ContentType` Id as a `Int`, this ID is based on a Database identity field, and is therefore not safe to reference in code which are moved between different instances, use Key instead.
+Gets the unique `ContentType` Id as an `Int`. The ID, derived from a database identity field, isn't safe for code references as they are moved across instances. Therefore it's recommended to use `Key` instead.
 
 ### .Key