diff --git a/docs/syntax/stateDiagram.md b/docs/syntax/stateDiagram.md
index afb1349ef..72d7ec63b 100644
--- a/docs/syntax/stateDiagram.md
+++ b/docs/syntax/stateDiagram.md
@@ -454,8 +454,8 @@ state or states in the diagram.
 
 **These are the current limitations with state diagram classDefs:**
 
-1.  They cannot be applied to start or end states
-2.  The cannot be applied to or within composite states
+1.  Cannot be applied to start or end states
+2.  Cannot be applied to or within composite states
 
 _These are in development and will be available in a future version._
 
diff --git a/packages/mermaid/src/docs/syntax/stateDiagram.md b/packages/mermaid/src/docs/syntax/stateDiagram.md
index a9cb72948..29e355a72 100644
--- a/packages/mermaid/src/docs/syntax/stateDiagram.md
+++ b/packages/mermaid/src/docs/syntax/stateDiagram.md
@@ -267,8 +267,8 @@ state or states in the diagram.
 
 **These are the current limitations with state diagram classDefs:**
 
-1. They cannot be applied to start or end states
-2. The cannot be applied to or within composite states
+1. Cannot be applied to start or end states
+2. Cannot be applied to or within composite states
 
 _These are in development and will be available in a future version._