[bug 799562] Clarify API field documentation

* adds max lengths where appropriate
* adds note about including PII-related informational text for
  description and email fields
* adds max_length items to manufacturer and device fields in the
  serializer