1 files changed, 27 insertions, 5 deletions
diff --git a/src/DotNetOAuth/ChannelElements/ITokenGenerator.cs b/src/DotNetOAuth/ChannelElements/ITokenGenerator.cs
index 45bc5b2..b9d690f 100644
--- a/src/DotNetOAuth/ChannelElements/ITokenGenerator.cs
+++ b/src/DotNetOAuth/ChannelElements/ITokenGenerator.cs
@@ -5,14 +5,36 @@
 //-----------------------------------------------------------------------
 
 namespace DotNetOAuth.ChannelElements {
-	using System;
-	using System.Collections.Generic;
-	using System.Linq;
-	using System.Text;
-
+	/// <summary>
+	/// An interface allowing OAuth hosts to inject their own algorithm for generating tokens and secrets.
+	/// </summary>
 	internal interface ITokenGenerator {
+		/// <summary>
+		/// Generates a new token to represent a not-yet-authorized request to access protected resources.
+		/// </summary>
+		/// <param name="consumerKey">The consumer that requested this token.</param>
+		/// <returns>The newly generated token.</returns>
+		/// <remarks>
+		/// This method should not store the newly generated token in any persistent store.
+		/// This will be done in <see cref="ITokenManager.StoreNewRequestToken"/>.
+		/// </remarks>
 		string GenerateRequestToken(string consumerKey);
+
+		/// <summary>
+		/// Generates a new token to represent an authorized request to access protected resources.
+		/// </summary>
+		/// <param name="consumerKey">The consumer that requested this token.</param>
+		/// <returns>The newly generated token.</returns>
+		/// <remarks>
+		/// This method should not store the newly generated token in any persistent store.
+		/// This will be done in <see cref="ITokenManager.ExpireRequestTokenAndStoreNewAccessToken"/>.
+		/// </remarks>
 		string GenerateAccessToken(string consumerKey);
+
+		/// <summary>
+		/// Returns a cryptographically strong random string for use as a token secret.
+		/// </summary>
+		/// <returns>The generated string.</returns>
 		string GenerateSecret();
 	}
 }