Web.PublishedCache - introduce contextual caches

src/Umbraco.Web/PublishedCache/IPublishedContentCache.cs

@@ -9,15 +9,17 @@ namespace Umbraco.Web.PublishedCache
 {
     internal interface IPublishedContentCache : IPublishedCache
     {
-        // do we want that one?
+        // FIXME do we want that one?
         IPublishedContent GetByRoute(UmbracoContext umbracoContext, string route, bool? hideTopLevelNode = null);
-        // do we want that one?
+
+        // FIXME do we want that one?
         IPublishedContent GetByUrlAlias(UmbracoContext umbracoContext, int rootNodeId, string alias);
 
-        // vs. having a GetDocumentByXPath ?!
-
-        // do we want to get-by-xpath?
-
+        /// <summary>
+        /// Gets a value indicating whether the cache contains published content.
+        /// </summary>
+        /// <param name="umbracoContext">The context.</param>
+        /// <returns>A value indicating whether the cache contains published content.</returns>
         bool HasContent(UmbracoContext umbracoContext);
     }
 }