field_default_view doc has problems

You right, can you send us a patch

It looks like $entity it only accepts a single entity rather than an array also -- it's not just the arg name that is wrong, but also the param description.

Same problem with the $instance parameter.

And the description says "field values" - perhaps that should be reworded to say it's only for one field on one entity instance?

Probably a good project for a novice doc contributor

While scanning through field.default.inc, I noticed a lot of documentation issues. I'll go ahead and file these.

$instance is an array
$entity is an object

can we docs it ?

@James_Stallings,
can you fix it in same issue if there are similar errors.

This has some whitespace problems:

+ * @param $instance
+*   An array containing each $field on $entity's bundle.

And $field should just be "field" without the $ here, I think -- $field is referring to the field information, which isn't what $instance contains (it contains the field data).

Also, $items is not passed by reference in this function, so I think this change is wrong:

  * @param $items
- *   Array of field values already loaded for the entities, keyed by entity id.
+ *   The field values. This parameter is altered by reference to receive the
+ *   incoming form values.

Finally, I think this sentence should say "of type $entity_type":

+ * @param $entity
+ *   A single object of $entity_type.

One other thing that needs fixing (see comment #2):
And the description says "field values" - perhaps that should be reworded to say it's only for one field on one entity instance?

The changes in the current patch look good -- I just think we need slightly more.

Excellent, thanks! d8/d7 please...

Committed and pushed to 8.x and 7.x. Thanks!

Thanks for your attention to the docs queue as well, James! :) Always nice to get an extra set of hands!