 	<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.">
+<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."
+	examples=
+	'
+		<!--- Create a new object and then check if it's new (yes, this example is ridiculous. It makes more sense in the context of callbacks for example) --->
+		<cfset anEmployee = model("employee").new()>
+		<cfif anEmployee.isNew()>
+			<!--- Do something... --->
+		</cfif>
+	'
+	categories="model-object" chapters="" functions="">
 	<cfscript>
 		var loc = {};
 		// if no values have ever been saved to the database this object is new

	<cfreturn loc.returnValue>
</cffunction>

<cffunction name="reload" returntype="void" access="public" output="false" hint="Reloads the property values of this object from the database.">
	<cfscript>
		var loc = {};
		loc.query = findByKey(key=key(), reload=true, returnAs="query");

	</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 = {};
