Add info about IPublishedContentQuery in background task

[bjarnef]

Description

Based on issue: umbraco/Umbraco-CMS#18883

It would be useful to link to this from here regarding documentation about custom filter:
https://docs.umbraco.com/umbraco-cms/reference/content-delivery-api/extension-api-for-querying#custom-filter

Type of suggestion

• Typo/grammar fix
• Updated outdated content
• New content
• Updates related to a new version
• Other

Product & version (if relevant)

Deadline (if relevant)

When should the content be published?

[bjarnef]

@kjac @AndyButland I added some documentation about this and not just on comment of method in source code :)

[eshanrnh]

Thanks @bjarnef for the PR 🙌 I have added a suggestion to keep the warning concise and moved the extra info as a paragraph above and below it.

Let me know if it doesn't make sense, or feel free to adjust.

[bjarnef]

@eshanrnh great! 🙌 it should probably also be added to v13 docs .. and a link from Delivery API filter from here https://docs.umbraco.com/umbraco-cms/reference/content-delivery-api/extension-api-for-querying#custom-filter would be great.

[kjac]

Hi all,

@bjarnef thanks for this 💪

I do feel this is very specific for IPublishedContentQuery. Wouldn't it be better to put this in the dedicated reference for that service (https://docs.umbraco.com/umbraco-cms/reference/querying/ipublishedcontentquery)?

[eshanrnh]

Hey @bjarnef 👋

Quick question — did you see @kjac's's message shared earlier? This PR has been open for a while, and we would like to move forward on it, if possible.

[bjarnef]

@eshanrnh yes, I think it would be great to move it to https://docs.umbraco.com/umbraco-cms/reference/querying/ipublishedcontentquery and perhaps we can link to more info about IPublishedContentQuery from services here, where I originally added this.

Feel free to make any adjustments to this PR 🙌