 	<cfreturn loc.returnValue>
 </cffunction>
 
-<cffunction name="deleteByKey" returntype="boolean" access="public" output="false" hint="Finds the record with the supplied key and deletes it. Returns true on successful deletion of the row, false otherwise.">
-	<cfargument name="key" type="any" required="true" hint="See documentation for `findByKey`">
+<cffunction name="deleteByKey" returntype="boolean" access="public" output="false"
+	hint="Finds the record with the supplied key and deletes it. Returns `true` on successful deletion of the row, `false` otherwise."
+	examples=
+	'
+		<!--- Delete the user with the primary key value of `1` --->
+		<cfset result = model("user").deleteByKey(1)>
+	'
+	categories="model-class" chapters="deleting-records" functions="delete,deleteOne,deleteAll">
+	<cfargument name="key" type="any" required="true" hint="See documentation for @findByKey.">
 	<cfscript>
 		var loc = {};
 		loc.where = $keyWhereString(values=arguments.key);

	<cfreturn loc.returnValue>
</cffunction>

<cffunction name="delete" returntype="boolean" access="public" output="false" hint="Deletes the object which means the row is deleted from the database (unless prevented by a `beforeDelete` callback). Returns true on successful deletion of the row, false otherwise.">
	<cfargument name="parameterize" type="any" required="false" default="#application.wheels.functions.delete.parameterize#" hint="See documentation for `findAll`">
	<cfscript>
		var loc = {};
		loc.returnValue = false;

	<cfreturn loc.returnValue>
</cffunction>

<cffunction name="deleteOne" returntype="boolean" access="public" output="false"
	hint="Gets an object based on conditions and deletes it."
	examples=
	'
		<!--- Delete the user that signed up last --->
		<cfset result = model("user").deleteOne(order="signupDate DESC")>
	'
	categories="model-class" chapters="deleting-records" functions="delete,deleteOne,deleteAll">
	<cfargument name="where" type="string" required="false" default="" hint="See documentation for @findAll.">
	<cfargument name="order" type="string" required="false" default="" hint="See documentation for @findAll.">
	<cfscript>
		var loc = {};
		loc.object = findOne(where=arguments.where, order=arguments.order);
