Document the ProductHeaderValue class

Octokit/Http/ProductHeaderValue.cs

@@ -1,14 +1,31 @@
 namespace Octokit
 {
+    /// <summary>
+    /// Represents a product header value. This is used to generate the User Agent string sent with each request. The
+    /// name used should represent the product that's using Octokit.net.
+    /// </summary>
+    /// <remarks>
+    /// This class is a wrapper around <seealso href="https://msdn.microsoft.com/en-us/library/system.net.http.headers.productheadervalue(v=vs.118).aspx"/> 
+    /// so that consumers of Octokit.net would not have to add a reference to the System.Net.Http.Headers namespace.
+    /// </remarks>
     public class ProductHeaderValue
     {
         readonly System.Net.Http.Headers.ProductHeaderValue _productHeaderValue;
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ProductHeaderValue"/> class.
+        /// </summary>
+        /// <param name="name">The name of the product that's using Octokit</param>
         public ProductHeaderValue(string name)
             : this(new System.Net.Http.Headers.ProductHeaderValue(name))
         {
         }
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ProductHeaderValue"/> class.
+        /// </summary>
+        /// <param name="name">The name of the product that's using Octokit</param>
+        /// <param name="version">The version of the product that's using Octokit</param>
         public ProductHeaderValue(string name, string version)
             : this(new System.Net.Http.Headers.ProductHeaderValue(name, version))
         {
@@ -19,11 +36,17 @@
             _productHeaderValue = productHeader;
         }
 
+        /// <summary>
+        /// The name of the product that's using Octokit
+        /// </summary>
         public string Name
         {
             get { return _productHeaderValue.Name; }
         }
 
+        /// <summary>
+        /// Gets the version of the product.
+        /// </summary>
         public string Version
         {
             get { return _productHeaderValue.Version; }
@@ -44,11 +67,22 @@
             return _productHeaderValue.ToString();
         }
 
+        /// <summary>
+        /// Parses a string in the format "foo" or "foo/1.0" and returns the corresponding
+        /// <see cref="ProductHeaderValue" /> instance.
+        /// </summary>
+        /// <param name="input">The input.</param>
         public static ProductHeaderValue Parse(string input)
         {
             return new ProductHeaderValue(System.Net.Http.Headers.ProductHeaderValue.Parse(input));
         }
 
+        /// <summary>
+        /// Parses a string in the format "foo" or "foo/1.0" and returns the corresponding
+        /// <see cref="ProductHeaderValue" /> instance via an out parameter.
+        /// </summary>
+        /// <param name="input">The input.</param>
+        /// <param name="parsedValue">The parsed value.</param>
         public static bool TryParse(string input,
             out ProductHeaderValue parsedValue)
         {