Always have comments describing what this does and include an example.

"Update an object by ID.  Here we will update a `car` by `car_id` and set it's `year` to whatever the user has provided in the parameter."