diff --git a/MediaBrowser.Controller/Providers/IExternalId.cs b/MediaBrowser.Controller/Providers/IExternalId.cs
index 149c58847c..ae87aab9ed 100644
--- a/MediaBrowser.Controller/Providers/IExternalId.cs
+++ b/MediaBrowser.Controller/Providers/IExternalId.cs
@@ -3,7 +3,9 @@ using MediaBrowser.Model.Providers;
namespace MediaBrowser.Controller.Providers
{
- /// Represents and identifier for an external provider.
+ ///
+ /// Represents an identifier for an external provider.
+ ///
public interface IExternalId
{
///
@@ -14,11 +16,12 @@ namespace MediaBrowser.Controller.Providers
///
/// Gets the unique key to distinguish this provider/type pair. This should be unique across providers.
///
- // TODO: This property is not actually unique at the moment. It should be updated to be unique.
+ // TODO: This property is not actually unique across the concrete types at the moment. It should be updated to be unique.
string Key { get; }
///
- /// Gets the specific media type for this id.
+ /// Gets the specific media type for this id. This is used to distinguish between the different
+ /// external id types for providers with multiple ids.
///
///
/// This can be used along with the to localize the external id on the client.
diff --git a/MediaBrowser.Model/Providers/ExternalIdInfo.cs b/MediaBrowser.Model/Providers/ExternalIdInfo.cs
index 493c6136ea..92a6395468 100644
--- a/MediaBrowser.Model/Providers/ExternalIdInfo.cs
+++ b/MediaBrowser.Model/Providers/ExternalIdInfo.cs
@@ -13,10 +13,12 @@ namespace MediaBrowser.Model.Providers
///
/// Gets or sets the unique key for this id. This key should be unique across all providers.
///
+ // TODO: This property is not actually unique across the concrete types at the moment. It should be updated to be unique.
public string Key { get; set; }
///
- /// Gets or sets the specific media type for this id.
+ /// Gets or sets the specific media type for this id. This is used to distinguish between the different
+ /// external id types for providers with multiple ids.
///
///
/// This can be used along with the to localize the external id on the client.
diff --git a/MediaBrowser.Model/Providers/ExternalIdMediaType.cs b/MediaBrowser.Model/Providers/ExternalIdMediaType.cs
index 8c5356c926..881cd77fc9 100644
--- a/MediaBrowser.Model/Providers/ExternalIdMediaType.cs
+++ b/MediaBrowser.Model/Providers/ExternalIdMediaType.cs
@@ -1,16 +1,16 @@
namespace MediaBrowser.Model.Providers
{
///
- /// The specific media type of an .
+ /// The specific media type of an .
///
///
- /// This is used as a translation key for clients.
+ /// Client applications may use this as a translation key.
///
public enum ExternalIdMediaType
{
///
- /// There is no specific media type associated with the external id, or the external provider only has one
- /// id type so there is no need to be specific.
+ /// There is no specific media type associated with the external id, or this is the default id for the external
+ /// provider so there is no need to specify a type.
///
General,