Open Radar

 
Summary:
CNContactFormatter.descriptorForRequiredKeysForStyle() is a required method for use in assembling a CNKeyDescriptor array to pass to CNContactFetchRequest(keysToFetch:) (see rdar://23889946).

The only reference to this method is in the high-level Contacts.framework documentation here:
https://developer.apple.com/library/watchos/documentation/Contacts/Reference/Contacts_Framework/index.html

Currently, there is no documentation at the parent class, CNContactFormatter:
https://developer.apple.com/library/watchos/documentation/Contacts/Reference/CNContactFormatter_Class/index.html#//apple_ref/occ/cl/CNContactFormatter

It seems pretty important to document this method in the usual places developers would expect to look, considering this is a must-use method for this process.

Steps to Reproduce:
1. Look for CNContactFormatter.descriptorForRequiredKeysForStyle() documentation under the CNContactFormatter class reference

Expected Results:
1. Find CNContactFormatter.descriptorForRequiredKeysForStyle() documentation under the CNContactFormatter class reference

Actual Results:
2. Do not find CNContactFormatter.descriptorForRequiredKeysForStyle() documentation under the CNContactFormatter class reference

Version:
Contacts Framework Reference Introduction - https://developer.apple.com/library/watchos/documentation/Contacts/Reference/Contacts_Framework/index.html

CNContactFormatter - https://developer.apple.com/library/watchos/documentation/Contact

Notes:


Configuration:
iOS 9.2

Attachments: