Added some documentation to the portableAPI:

 - Microsoft.Band.Portable
 - Microsoft.Band.Portable.Notifications

Microsoft.Band.Portable/Microsoft.Band.Portable/BandClientManager.cs

@@ -14,6 +14,9 @@
 
 namespace Microsoft.Band.Portable
 {
+    /// <summary>
+    /// Provides access to paired Band devices and the ability to connect to them.
+    /// </summary>
     public class BandClientManager
     {
         private static Lazy<BandClientManager> instance;
@@ -23,11 +26,21 @@ static BandClientManager()
             instance = new Lazy<BandClientManager>(() => new BandClientManager());
         }
 
+        /// <summary>
+        /// Gets the value representing the current instance of the client manager.
+        /// </summary>
+        /// <value>
+        /// The current instance of the client manager.
+        /// </value>
         public static BandClientManager Instance
         {
             get { return instance.Value; }
         }
 
+        /// <summary>
+        /// Returns a collection of the Band devices that are paired with the current device.
+        /// </summary>
+        /// <returns>A collection of the paired Bands.</returns>
         public async Task<IEnumerable<BandDeviceInfo>> GetPairedBandsAsync()
         {
 #if __ANDROID__
@@ -41,6 +54,12 @@ public async Task<IEnumerable<BandDeviceInfo>> GetPairedBandsAsync()
 #endif
         }
 
+        /// <summary>
+        /// Connects to the Band device specified by the device information, 
+        /// and returns a client that is used for communication.
+        /// </summary>
+        /// <param name="info">The Band device information to connect to.</param>
+        /// <returns>The client instance that is used to communicate with the connected Band device.</returns>
         public async Task<BandClient> ConnectAsync(BandDeviceInfo info)
         {
 #if __ANDROID__

Microsoft.Band.Portable/Microsoft.Band.Portable/IBandClient.cs

@@ -25,6 +25,9 @@
 
 namespace Microsoft.Band.Portable
 {
+    /// <summary>
+    /// Represents a connected Band device.
+    /// </summary>
     public class BandClient
     {
         private readonly Lazy<BandSensorManager> sensors;
@@ -46,6 +49,12 @@ internal BandClient(NativeBandClient client)
         }
 #endif
 
+        /// <summary>
+        /// Gets the value representing the current instance of the sensor manager.
+        /// </summary>
+        /// <value>
+        /// The current instance of the sensor manager.
+        /// </value>
         public BandSensorManager SensorManager
         {
             get
@@ -56,6 +65,12 @@ public BandSensorManager SensorManager
             }
         }
 
+        /// <summary>
+        /// Gets the value representing the current instance of the notification manager.
+        /// </summary>
+        /// <value>
+        /// The current instance of the notification manager.
+        /// </value>
         public BandNotificationManager NotificationManager
         {
             get
@@ -66,6 +81,12 @@ public BandNotificationManager NotificationManager
             }
         }
 
+        /// <summary>
+        /// Gets the value representing the current instance of the tile manager.
+        /// </summary>
+        /// <value>
+        /// The current instance of the tile manager.
+        /// </value>
         public BandTileManager TileManager
         {
             get
@@ -76,6 +97,12 @@ public BandTileManager TileManager
             }
         }
 
+        /// <summary>
+        /// Gets the value representing the current instance of the personalization manager.
+        /// </summary>
+        /// <value>
+        /// The current instance of the personalization manager.
+        /// </value>
         public BandPersonalizationManager PersonalizationManager
         {
             get
@@ -86,6 +113,12 @@ public BandPersonalizationManager PersonalizationManager
             }
         }
 
+        /// <summary>
+        /// Gets a value indicating whether this instance is connected to a Band device.
+        /// </summary>
+        /// <value>
+        /// <c>true</c> if this instance is connected to a Band device; otherwise, <c>false</c>.
+        /// </value>
         public bool IsConnected
         {
             get
@@ -102,6 +135,10 @@ public bool IsConnected
             }
         }
 
+        /// <summary>
+        /// Returns the firmware version of the Band.
+        /// </summary>
+        /// <returns>A string representing the firmware version of the Band.</returns>
         public async Task<string> GetFirmwareVersionAsync()
         {
             CheckDisposed();
@@ -117,6 +154,10 @@ public async Task<string> GetFirmwareVersionAsync()
 #endif
         }
 
+        /// <summary>
+        /// Returns the hardware version of the Band.
+        /// </summary>
+        /// <returns>A string representing the hardware version of the Band.</returns>
         public async Task<string> GetHardwareVersionAsync()
         {
             CheckDisposed();
@@ -132,6 +173,9 @@ public async Task<string> GetHardwareVersionAsync()
 #endif
         }
 
+        /// <summary>
+        /// Disconnects from the current Band device.
+        /// </summary>
         public async Task DisconnectAsync()
         {
             CheckDisposed();

Microsoft.Band.Portable/Microsoft.Band.Portable/IBandDeviceInfo.cs

@@ -9,6 +9,9 @@
 
 namespace Microsoft.Band.Portable
 {
+    /// <summary>
+    /// Represents a paired device.
+    /// </summary>
     public class BandDeviceInfo
     {
 #if __ANDROID__ || __IOS__ || WINDOWS_PHONE_APP
@@ -20,6 +23,12 @@ internal BandDeviceInfo(NativeBandDeviceInfo info)
         }
 #endif
 
+        /// <summary>
+        /// Gets the name of the Band device this instance represents.
+        /// </summary>
+        /// <value>
+        /// The name of the Band device.
+        /// </value>
         public string Name
         {
             get

Microsoft.Band.Portable/Microsoft.Band.Portable/Notifications/BandNotificationManager.cs

@@ -8,6 +8,9 @@
 
 namespace Microsoft.Band.Portable.Notifications
 {
+    /// <summary>
+    /// Represents the notification manager for a connected Band device.
+    /// </summary>
     public class BandNotificationManager
     {
         private readonly BandClient client;
@@ -23,16 +26,42 @@ internal BandNotificationManager(BandClient client, NativeBandNotificationManage
         }
 #endif
 
+        /// <summary>
+        /// Sends a message to a specific tile to the connected Band device with the provided tile ID, title,
+        /// body and timestamp.
+        /// </summary>
+        /// <param name="tileId">The tile identifier.</param>
+        /// <param name="title">The message title.</param>
+        /// <param name="body">The message body.</param>
+        /// <param name="timestamp">The message timestamp.</param>
         public async Task SendMessageAsync(Guid tileId, string title, string body, DateTime timestamp)
         {
             await SendMessageAsync(tileId, title, body, timestamp, false);
         }
 
+        /// <summary>
+        /// Sends a message to a specific tile to the connected Band device with the provided tile ID, title, body, 
+        /// timestamp and, optionally, with a dialog.
+        /// </summary>
+        /// <param name="tileId">The tile identifier.</param>
+        /// <param name="title">The message title.</param>
+        /// <param name="body">The message body.</param>
+        /// <param name="timestamp">The message timestamp.</param>
+        /// <param name="showDialog">Display a dialog if set to <c>true</c>; otherwise, don't.</param>
         public async Task SendMessageAsync(Guid tileId, string title, string body, DateTime timestamp, bool showDialog)
         {
             await SendMessageAsync(tileId, title, body, timestamp, showDialog ? MessageFlags.ShowDialog : MessageFlags.None);
         }
 
+        /// <summary>
+        /// Sends a message to a specific tile to the connected Band device with the provided tile ID, title, body, 
+        /// timestamp and with message flags to control how the message is provided.
+        /// </summary>
+        /// <param name="tileId">The tile identifier.</param>
+        /// <param name="title">The message title.</param>
+        /// <param name="body">The message body.</param>
+        /// <param name="timestamp">The message timestamp.</param>
+        /// <param name="messageFlags">The message flags to control how the message is provided to the Band device.</param>
         public async Task SendMessageAsync(Guid tileId, string title, string body, DateTime timestamp, MessageFlags messageFlags)
         {
 #if __ANDROID__ || __IOS__
@@ -42,6 +71,12 @@ public async Task SendMessageAsync(Guid tileId, string title, string body, DateT
 #endif
         }
 
+        /// <summary>
+        /// Shows a dialog on the connected Band device.
+        /// </summary>
+        /// <param name="tileId">The tile identifier.</param>
+        /// <param name="title">The message title.</param>
+        /// <param name="body">The message body.</param>
         public async Task ShowDialogAsync(Guid tileId, string title, string body)
         {
 #if __ANDROID__ || __IOS__
@@ -51,6 +86,10 @@ public async Task ShowDialogAsync(Guid tileId, string title, string body)
 #endif
         }
 
+        /// <summary>
+        /// Vibrates the connected Band device using the specified vibration type.
+        /// </summary>
+        /// <param name="vibrationType">Type of vibration to use.</param>
         public async Task VibrateAsync(VibrationType vibrationType)
         {
 #if __ANDROID__ || __IOS__

Microsoft.Band.Portable/Microsoft.Band.Portable/Notifications/MessageFlags.cs

@@ -1,8 +1,17 @@
 namespace Microsoft.Band.Portable.Notifications
 {
+    /// <summary>
+    /// Represents flags that control how a message is sent to a Band device.
+    /// </summary>
     public enum MessageFlags
     {
+        /// <summary>
+        /// Use the default message style.
+        /// </summary>
         None,
+        /// <summary>
+        /// Show dialog when sending a message.
+        /// </summary>
         ShowDialog
     }
 }

Microsoft.Band.Portable/Microsoft.Band.Portable/Notifications/VibrationType.cs

@@ -1,15 +1,45 @@
 namespace Microsoft.Band.Portable.Notifications
 {
+    /// <summary>
+    /// Represents a type of vibration that can be sent to a Band device.
+    /// </summary>
     public enum VibrationType
     {
+        /// <summary>
+        /// The ramp down vibration type.
+        /// </summary>
         RampDown,
+        /// <summary>
+        /// The ramp up vibration type.
+        /// </summary>
         RampUp,
+        /// <summary>
+        /// The notification one-tone vibration type.
+        /// </summary>
         NotificationOneTone,
+        /// <summary>
+        /// The notification two-tone vibration type.
+        /// </summary>
         NotificationTwoTone,
+        /// <summary>
+        /// The notification alarm vibration type.
+        /// </summary>
         NotificationAlarm,
+        /// <summary>
+        /// The notification timer vibration type.
+        /// </summary>
         NotificationTimer,
+        /// <summary>
+        /// The one-tone high vibration type.
+        /// </summary>
         OneToneHigh,
+        /// <summary>
+        /// The three-tone high vibration type.
+        /// </summary>
         ThreeToneHigh,
+        /// <summary>
+        /// The two-tone high vibration type.
+        /// </summary>
         TwoToneHigh
     }
 }

Microsoft.Band.Portable/Microsoft.Band.Portable/UserConsent.cs

@@ -1,9 +1,21 @@
 namespace Microsoft.Band.Portable
 {
+    /// <summary>
+    /// Represents the result of a request for user consent.
+    /// </summary>
     public enum UserConsent
     {
+        /// <summary>
+        /// The user declined consent.
+        /// </summary>
         Declined,
+        /// <summary>
+        /// The user granted consent.
+        /// </summary>
         Granted,
+        /// <summary>
+        /// The user has not yet reponded to a request.
+        /// </summary>
         Unspecified
     }
 }