[net6.0] Update Essentials Contacts API Docs

src/Essentials/src/Contacts/Contacts.netstandard.tvos.watchos.cs

@@ -4,7 +4,6 @@
 
 namespace Microsoft.Maui.ApplicationModel.Communication
 {
- /// <include file="../../docs/Microsoft.Maui.Essentials/Contacts.xml" path="Type[@FullName='Microsoft.Maui.ApplicationModel.Communications.Contacts']/Docs/*" />
  class ContactsImplementation : IContacts
  {
  public Task<Contact> PickContactAsync() =>

src/Essentials/src/Contacts/Contacts.shared.cs

@@ -5,26 +5,50 @@
 
 namespace Microsoft.Maui.ApplicationModel.Communication
 {
+ /// <summary>
+ /// The Contacts API lets a user pick a contact and retrieve information about it.
+ /// </summary>
  public interface IContacts
  {
+ /// <summary>
+ /// Opens the operating system's default UI for picking a contact from the device.
+ /// </summary>
+ /// <returns>A single contact, or <see langword="null"/> if the user cancelled the operation.</returns>
  Task<Contact?> PickContactAsync();
 
+ /// <summary>
+ /// Gets a collection of all the contacts on the device.
+ /// </summary>
+ /// <param name="cancellationToken">A token that can be used for cancelling the operation.</param>
+ /// <returns>A collection of contacts on the device.</returns>
  Task<IEnumerable<Contact>> GetAllAsync(CancellationToken cancellationToken = default);
  }
 
- /// <include file="../../docs/Microsoft.Maui.Essentials/Contacts.xml" path="Type[@FullName='Microsoft.Maui.ApplicationModel.Communications.Contacts']/Docs/*" />
+ /// <summary>
+ /// The Contacts API lets a user pick a contact and retrieve information about it.
+ /// </summary>
  public static class Contacts
  {
- /// <include file="../../docs/Microsoft.Maui.Essentials/Contacts.xml" path="//Member[@MemberName='PickContactAsync']/Docs/*" />
+ /// <summary>
+ /// Opens the operating system's default UI for picking a contact from the device.
+ /// </summary>
+ /// <returns>A single contact, or <see langword="null"/> if the user cancelled the operation.</returns>
  public static Task<Contact?> PickContactAsync() =>
  Default.PickContactAsync();
 
- /// <include file="../../docs/Microsoft.Maui.Essentials/Contacts.xml" path="//Member[@MemberName='GetAllAsync']/Docs/*" />
+ /// <summary>
+ /// Gets a collection of all the contacts on the device.
+ /// </summary>
+ /// <param name="cancellationToken">A token that can be used for cancelling the operation.</param>
+ /// <returns>A collection of contacts on the device.</returns>
  public static Task<IEnumerable<Contact>> GetAllAsync(CancellationToken cancellationToken = default) =>
  Default.GetAllAsync(cancellationToken);
 
  static IContacts? defaultImplementation;
 
+ /// <summary>
+ /// Provides the default implementation for static usage of this API.
+ /// </summary>
  public static IContacts Default =>
  defaultImplementation ??= new ContactsImplementation();