Merge pull request #7223 from umbraco/IPublishedContentQuery

Added updates from v15 to v16

Author: eshanrnh

16/umbraco-cms/implementation/services/README.md

@@ -223,6 +223,10 @@ public class HandleUnPublishingHandler : INotificationHandler<ContentUnpublished
 }
 ```
 
+#### Accessing the Published Content Cache via IPublishedContentQuery
+
+When fetching multiple content items by ID, using `UmbracoContext.Content` is limited because it only allows retrieving one item at a time. To query multiple items efficiently, you can use `IPublishedContentQuery`. For more details, see the [IPublishedContentQuery](../../reference/querying/ipublishedcontentquery.md) article.
+
 #### Accessing the Published Content Cache from a Content Finder / UrlProvider
 
 Inside a ContentFinder access to the content cache is possible by injecting `IUmbracoContextAccessor` into the constructor and provided via the PublishedRequest object:

16/umbraco-cms/reference/querying/ipublishedcontentquery.md

@@ -28,6 +28,22 @@ public class SearchService
 
 Now you can access the `IPublishedContentQuery` through `_publishedContentQuery`
 
+## Accessing the Published Content Cache via `IPublishedContentQuery`
+
+Sometimes, you may need to fetch multiple content items by ID, but `UmbracoContext.Content` only allows fetching a single content item at a time.  
+
+{% hint style="warning" %}
+In a background task, accessing the content cache using an injected `IPublishedContentQuery` or `IPublishedContentQueryAccessor` will not work, as they rely on `HttpContext`.  
+{% endhint %}
+
+Instead, use the following approach:  
+
+```csharp
+using UmbracoContextReference _ = _umbracoContextFactory.EnsureUmbracoContext();
+using IServiceScope serviceScope = _serviceProvider.CreateScope();
+IPublishedContentQuery query = serviceScope.ServiceProvider.GetRequiredService<IPublishedContentQuery>();
+```
+
 ## Examples
 
 ### .Search(string term)