 	<cfreturn loc.returnValue>
 </cffunction>
 
-<cffunction name="save" returntype="boolean" access="public" output="false" hint="Saves the object if it passes validation and callbacks. Returns `true` if the object was saved successfully to the database.">
-	<cfargument name="parameterize" type="any" required="false" default="#application.wheels.functions.save.parameterize#" hint="See documentation for `findAll`">
-	<cfargument name="defaults" type="boolean" required="false" default="#application.wheels.functions.save.defaults#" hint="Whether or not to set default values for properties">
+<cffunction name="save" returntype="boolean" access="public" output="false"
+	hint="Saves the object if it passes validation and callbacks. Returns `true` if the object was saved successfully to the database, `false` if not."
+	examples=
+	'
+		<!--- Save the user object to the database (will automatically do an `INSERT` or `UPDATE` statement depending on if the record is new or already exists --->
+		<cfset user.save()>
+
+		<!--- Save the user object directly in an if statement without using `cfqueryparam` and take appropriate action based on the result --->
+		<cfif user.save(parameterize=false)>
+			<cfset flashInsert(notice="The user was saved!")>
+			<cfset redirectTo(action="userEdit")>
+		<cfelse>
+			<cfset flashInsert(alert="Error, please correct!")>
+			<cfset renderPage(action="userEdit")
+		</cfif>
+	'
+	categories="model-object" chapters="creating-records" functions="">
+	<cfargument name="parameterize" type="any" required="false" default="#application.wheels.functions.save.parameterize#" hint="See documentation for @findAll.">
+	<cfargument name="defaults" type="boolean" required="false" default="#application.wheels.functions.save.defaults#" hint="Whether or not to set default values for properties.">
 	<cfscript>
 		var returnValue = false;
 		clearErrors();

	<cfreturn loc.returnValue>
</cffunction>

<cffunction name="new" returntype="any" access="public" output="false" hint="Creates a new object based on supplied properties and returns it. The object is not saved to the database, it only exists in memory. Property names and values can be passed in either using named arguments or as a struct to the `properties` argument.">
	<cfargument name="properties" type="struct" required="false" default="#StructNew()#" hint="Properties for the object">
	<cfargument name="defaults" type="boolean" required="false" default="#application.wheels.functions.new.defaults#" hint="See documentation for `save`">
	<cfscript>
		var loc = {};
		for (loc.key in arguments)

	<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);
