diff --git a/example/electric-vehicles.jv b/example/electric-vehicles.jv
index 7bfa6b76..324da40f 100644
--- a/example/electric-vehicles.jv
+++ b/example/electric-vehicles.jv
@@ -8,7 +8,7 @@
 // - Understand how to construct a pipeline with multiple sinks
 // - Understand the use of runtime parameters
 
-// 0. We can use elements defined in other files using the "use" syntax.
+// 0. We can use elements defined in other files with the "use" syntax.
 // In this case, we use the value type UsStateCode when later specifying the table column value types. 
 use { UsStateCode } from './state-codes.jv';
 
diff --git a/example/state-codes.jv b/example/state-codes.jv
index f4c68b7d..fa4549c0 100644
--- a/example/state-codes.jv
+++ b/example/state-codes.jv
@@ -13,8 +13,8 @@ publish valuetype UsStateCode oftype text {
   ];
 }
 
-// 2. The publish keyword can be used after definition (see below).
-// When using this delayed publish syntax, the published element can also be renamed for access from outside of the file. 
+// 2. The publish keyword can be used after a definition as well (see below).
+// When using this delayed publish syntax, the published element can also be renamed. Doing so will make it available using the changed name whenever it is imported with the `use` syntax in another file. 
 constraint UsStateCodeAllowlist on text: value in [
   "AL",
   "AK",