 	<cfreturn loc.returnValue>
 </cffunction>
 
-<cffunction name="reload" returntype="void" access="public" output="false" hint="Reloads the property values of this object from the database.">
+<cffunction name="reload" returntype="void" access="public" output="false"
+	hint="Reloads the property values of this object from the database."
+	examples=
+	'
+		<!--- Get an object, call a method on it that could potentially change values and then reload the values from the database --->
+		<cfset anEmployee = model("employee").findByKey(params.key)>
+		<cfset anEmployee.someCallThatChangesValuesInTheDatabase()>
+		<cfset anEmployee.reload()>
+	'
+	categories="model-object" chapters="reading-records" functions="">
 	<cfscript>
 		var loc = {};
 		loc.query = findByKey(key=key(), reload=true, returnAs="query");

	<cfreturn returnValue>
</cffunction>

<cffunction name="isNew" returntype="boolean" access="public" output="false" hint="Returns `true` if this object hasn't been saved yet (in other words no record exists in the database yet). Returns `false` if a record exists.">
	<cfscript>
		var loc = {};
		// if no values have ever been saved to the database this object is new

	</cfscript>
</cffunction>

<cffunction name="key" returntype="string" access="public" output="false"
	hint="Returns the value of the primary key for the object. If you have a single primary key named `id` then `someObject.key()` is functionally equivalent to `someObject.id`. This method is more useful when you do dynamic programming and don't know the name of the primary key or when you use composite keys (in which case it's convenient to use this method to get a list of both key values returned)."
	examples=
	'
		<!--- Get an object and then get the primary key value(s) --->
		<cfset anEmployee = model("employee").findByKey(params.key)>
		<cfset val = anEmployee.key()>
	'
	categories="model-object" chapters="object-relational-mapping" functions="">
	<cfargument name="$persisted" type="boolean" required="false" default="false">
	<cfscript>
		var loc = {};
