Added note for Obsolete methods

15/umbraco-cms/.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md

@@ -3,5 +3,5 @@ title: 'Obsolete Warning: IPublishedSnapshotAccessor'
 ---
 
 {% hint style="warning" %}
-The following example uses `IPublishedSnapshotAccessor`, which is obsolete in Umbraco 15 and will be removed in a future version. For more information, see the[ Version specific upgrades](../../fundamentals/setup/upgrading/version-specific/#umbraco-15) article.
+The following example uses `IPublishedSnapshotAccessor`, which is obsolete in Umbraco 15 and will be removed in a future version. For more information, see the [Version specific upgrades](../../fundamentals/setup/upgrading/version-specific/#umbraco-15) article.
 {% endhint %}

15/umbraco-cms/.gitbook/includes/obsolete-warning-publishedsnapshot.md

@@ -0,0 +1,7 @@
+---
+title: 'Obsolete Warning: PublishedSnapshot'
+---
+
+{% hint style="warning" %}
+The following example uses `PublishedSnapshot`, which is obsolete in Umbraco 15 and will be removed in a future version. For more information, see the [Version specific upgrades](../../fundamentals/setup/upgrading/version-specific/#umbraco-15) article.
+{% endhint %}

15/umbraco-cms/.gitbook/includes/obsolete-warning-snapshot-publishedcache.md

@@ -0,0 +1,7 @@
+---
+title: 'Obsolete Warning: Snapshot and Published Cache'
+---
+
+{% hint style="warning" %}
+The following example uses `Umbraco.Cms.Core.PublishedCache` and `IPublishedSnapshotAccessor` which are obsolete in Umbraco 15 and will be removed in a future version. For more information, see the [Version specific upgrades](../../fundamentals/setup/upgrading/version-specific/#umbraco-15) article.
+{% endhint %}

15/umbraco-cms/.gitbook/includes/obsolete-warning-snapshot.md

@@ -0,0 +1,7 @@
+---
+title: 'Obsolete Warning: Snapshot'
+---
+
+{% hint style="warning" %}
+The following example uses `Umbraco.Cms.Core.PublishedCache`, `IPublishedSnapshotAccessor`, and `PropertyCacheLevel.Snapshot`, which are obsolete in Umbraco 15 and will be removed in a future version. For more information, see the [Version specific upgrades](../../fundamentals/setup/upgrading/version-specific/#umbraco-15) article.
+{% endhint %}

15/umbraco-cms/SUMMARY.md

@@ -41,6 +41,7 @@
       * [Advanced Techniques With Flexible Load Balancing](fundamentals/setup/server-setup/load-balancing/flexible-advanced.md)
       * [Logging With Load Balancing](fundamentals/setup/server-setup/load-balancing/logging.md)
 * [Backoffice](fundamentals/backoffice/README.md)
+  * [Sections](fundamentals/backoffice/sections.md)
   * [Property Editors](fundamentals/backoffice/property-editors/README.md)
     * [Built-in Property Editors](fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/README.md)
       * [Checkbox List](fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/checkbox-list.md)

15/umbraco-cms/customizing/property-editors/full-examples-value-converters.md

@@ -1,6 +1,9 @@
 # Content Picker Value Converter Example
 
+{% include "../../.gitbook/includes/obsolete-warning-snapshot-publishedcache.md" %}
+
 {% code title="ContentPickerPropertyConverter.cs" %}
+
 ```csharp
 using Umbraco.Cms.Core;
 using Umbraco.Cms.Core.Models.PublishedContent;
@@ -48,4 +51,5 @@
             : null;
 }
 ```
+
 {% endcode %}

15/umbraco-cms/customizing/property-editors/property-value-converters.md

@@ -113,6 +113,10 @@
 
 #### `PropertyCacheLevel.Snapshot`
 
+{% hint style="warning" %}
+`PropertyCacheLevel.Snapshot` is obsolete in Umbraco 15 and will be removed in a future version.
+{% endhint %}
+
 The property value will only be cached for the duration of the current _snapshot_.
 
 A snapshot represents a point in time. For example, a snapshot is created for every content request from the frontend. When accessing a property in a snapshot using this cache level, it gets converted, cached throughout the snapshot, and later cleared.
@@ -163,6 +167,8 @@
 
 This method converts the Intermediate to an Object. The returned value is used by the `GetPropertyValue<T>` method of `IPublishedContent`.
 
+{% include "../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 The below example converts the nodeId (converted to `Int` or `Udi` by _ConvertSourceToIntermediate_) into an 'IPublishedContent' object.
 
 ```csharp

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/checkbox-list.md

@@ -98,6 +98,8 @@
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;
 @using Umbraco.Cms.Core.PublishedCache;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/color-picker.md

@@ -118,6 +118,8 @@ Although the use of a GUID is preferable, you can also use the numeric ID to get
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;
 @using Umbraco.Cms.Core.PublishedCache;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/content-picker.md

@@ -248,6 +248,8 @@ Although the use of a GUID is preferable, you can also use the numeric ID to get
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;
 @using Umbraco.Cms.Core.PublishedCache;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/date-time.md

@@ -74,6 +74,8 @@
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @using Umbraco.Cms.Core.PublishedCache;
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/decimal.md

@@ -72,6 +72,8 @@ Although the use of a GUID is preferable, you can also use the numeric ID to get
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;
 @using Umbraco.Cms.Core.PublishedCache;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/document-picker.md

@@ -95,6 +95,8 @@ Although the use of a GUID is preferable, you can also use the numeric ID to get
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @using Umbraco.Cms.Core.PublishedCache;
 @using Umbraco.Cms.Core;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/dropdown/README.md

@@ -125,6 +125,8 @@ Although the use of a GUID is preferable, you can also use the numeric ID to get
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @using Umbraco.Cms.Core.PublishedCache;
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/eye-dropper-color-picker.md

@@ -80,6 +80,8 @@
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @using Umbraco.Cms.Core.PublishedCache;
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/file-upload.md

@@ -130,6 +130,8 @@
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;
 @{

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/label.md

@@ -83,6 +83,8 @@
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @{
     @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/markdown-editor.md

@@ -102,6 +102,8 @@ Although the use of a GUID is preferable, you can also use the numeric ID to get
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @using Umbraco.Cms.Core.PublishedCache;
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/media-picker-3.md

@@ -186,6 +186,8 @@ Although the use of a GUID is preferable, you can also use the numeric ID to get
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @using Umbraco.Cms.Core.PublishedCache;
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/member-group-picker.md

@@ -85,6 +85,8 @@ Although the use of a GUID is preferable, you can also use the numeric ID to get
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @using Umbraco.Cms.Core.PublishedCache;
 @using Umbraco.Cms.Core;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/member-picker.md

@@ -84,6 +84,8 @@
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @using Umbraco.Cms.Core.PublishedCache;
 @using Umbraco.Cms.Core;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/multi-url-picker.md

@@ -138,6 +138,8 @@
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @using Umbraco.Cms.Core.PublishedCache;
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/multiple-textbox.md

@@ -92,6 +92,8 @@ Although the use of a GUID is preferable, you can also use the numeric ID to get
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @using Umbraco.Cms.Core.PublishedCache;
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/numeric.md

@@ -109,6 +109,8 @@
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @using Umbraco.Cms.Core.PublishedCache;
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/radiobutton-list.md

@@ -82,6 +82,8 @@ Although the use of a GUID is preferable, you can also use the numeric ID to get
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @using Umbraco.Cms.Core.PublishedCache;
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/slider.md

@@ -123,6 +123,8 @@ Although the use of a GUID is preferable, you can also use the numeric ID to get
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @using Umbraco.Cms.Core.PublishedCache;
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/tags.md

@@ -107,6 +107,8 @@ Although the use of a GUID is preferable, you can also use the numeric ID to get
 
 If Modelsbuilder is enabled, you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @using Umbraco.Cms.Core.PublishedCache;
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/textarea.md

@@ -83,6 +83,8 @@ Although the use of a GUID is preferable, you can also use the numeric ID to get
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @using Umbraco.Cms.Core.PublishedCache;
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/textbox.md

@@ -91,6 +91,8 @@ Although the use of a GUID is preferable, you can also use the numeric ID to get
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @using Umbraco.Cms.Core.PublishedCache;
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/true-false.md

@@ -80,6 +80,8 @@ Although the use of a GUID is preferable, you can also use the numeric ID to get
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @using Umbraco.Cms.Core.PublishedCache;
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/user-picker.md

@@ -95,6 +95,8 @@ Although the use of a GUID is preferable, you can also use the numeric ID to get
 
 If Modelsbuilder is enabled you can get the alias of the desired property without using a magic string:
 
+{% include "../../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 @inject IPublishedSnapshotAccessor _publishedSnapshotAccessor;
 @{

15/umbraco-cms/fundamentals/backoffice/settings-dashboards.md

@@ -39,7 +39,7 @@ The Published Status dashboard displays the status of your site in the Published
 * Internals - Lets you trigger a NuCache snapshots collection.
 
 {% hint style="info"%}
-As of Umbraco 15 `IPublishedSnapshot`, `IPublishedSnapshotAccessor` & `SnapshotCache` are all obsolete.
+As of Umbraco 15 `IPublishedSnapshot`, `IPublishedSnapshotAccessor`, and `SnapshotCache` are all obsolete.
 {%endhint%}
 
 </details>

15/umbraco-cms/reference/content-delivery-api/additional-preview-environments-support.md

@@ -15,18 +15,20 @@ To get familiar with the preview functionality in the Delivery API, please refer
 The support for configuring additional preview environments in the Delivery API was introduced in version 12.3.
 {% endhint %}
 
-
 ## Configuring custom preview URLs
 
 If your client libraries feature preview functionality, you can enable editors in Umbraco to navigate directly to their preferred preview environments. To achieve this, start by generating the necessary URLs for each environment you wish to allow for preview. These URLs need to trigger preview mode within your application, which will fetch and present draft content from the Delivery API.
 
-Once you have these preview URLs, you will need to register them through code in Umbraco. 
+Once you have these preview URLs, you will need to register them through code in Umbraco.
 
 Additionally, there are plans to simplify this process further. In an upcoming major version of Umbraco, a UI will be introduced, allowing you to configure these custom preview URLs directly from the backoffice.
 
+{% include "../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 Here is an example of how to register such preview URLs for both variant and invariant content using a notification handler:
 
 {% code title="AdditionalPreviewUrlsNotificationHandler.cs" %}
+
 ```csharp
 using Umbraco.Cms.Core.Events;
 using Umbraco.Cms.Core.Models.ContentEditing;
@@ -75,6 +77,7 @@ public class AdditionalPreviewUrlsNotificationHandler : INotificationHandler<Sen
     }
 }
 ```
+
 {% endcode %}
 
 The purpose of this notification handler is to dynamically generate additional preview URLs for published content items only (_for the sake of simplicity_). It constructs two custom preview URLs, one for a development environment and another for a staging environment. These URLs include the content's route, culture variant, and a `preview` query parameter to enable preview mode in the client application.

15/umbraco-cms/reference/content-delivery-api/custom-property-editors-support.md

@@ -26,7 +26,10 @@ Towards the end of the example, you will find the response models that we will b
 
 The `IsConverter()` and `GetPropertyValueType()` methods are inherited from the `PropertyValueConverterBase` class, which is covered in the [Property Value Converters](https://docs.umbraco.com/umbraco-cms/extending/property-editors/property-value-converters) article.
 
+{% include "../../.gitbook/includes/obsolete-warning-snapshot.md" %}
+
 {% code title="MyCustomPickerValueConverter.cs" lineNumbers="true" %}
+
 ```csharp
 using Umbraco.Cms.Core.DeliveryApi;
 using Umbraco.Cms.Core.Models.DeliveryApi;
@@ -112,6 +115,7 @@ public class DeliveryApiItemDetails
     public IApiContentRoute? Route { get; set; }
 }
 ```
+
 {% endcode %}
 
 The Implementation of the `IDeliveryApiPropertyValueConverter` interface can be found in the following methods:
@@ -163,6 +167,8 @@ Property expansion allows us to conditionally add another level of detail to the
 
 In our example, property expansion is implemented within `ConvertIntermediateToDeliveryApiObject()`. By considering the value of the `expanding` parameter, we can modify the `BuildDeliveryApiCustomPicker()` method as follows:
 
+{% include "../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 private DeliveryApiCustomPicker? BuildDeliveryApiCustomPicker(object inter, bool expanding)
 {

15/umbraco-cms/reference/templating/modelsbuilder/introduction.md

@@ -10,6 +10,8 @@ Models can be used anywhere that content is retrieved from the content cache, i.
 
 For each content, media and member type in the Umbraco setup, the generator creates a `*.generated.cs` file, corresponding to the type. For instance, a document type with a textstring property named Title, and a rich text editor named BodyText will look like this:
 
+{% include "../../../.gitbook/includes/obsolete-warning-snapshot-publishedcache.md" %}
+
 ```csharp
 //------------------------------------------------------------------------------
 // <auto-generated>

15/umbraco-cms/reference/templating/modelsbuilder/understand-and-extend.md

@@ -7,6 +7,8 @@ description: "Understand and extend modelsbuilder"
 
 Models are generated as partial classes. In its most basic form, a model for content type `TextPage` ends up in a `TextPage.generated.cs` file and looks like:
 
+{% include "../../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 /// <summary>TextPage</summary>
 [PublishedModel("textPage")]

15/umbraco-cms/reference/using-ioc.md

@@ -365,6 +365,8 @@ Using the UmbracoHelper is only possible when there is an instance of the Umbrac
 
 [Read more about the ExamineManager in the Searching articles](searching/examine/).
 
+{% include "../.gitbook/includes/obsolete-warning-publishedsnapshot.md" %}
+
 {% code title="SearchService.cs" %}
 
 ```csharp

15/umbraco-cms/reference/webhooks/README.md

@@ -134,6 +134,8 @@ builder.WebhookEvents().Clear().AddCms(false);
 
 Sometimes it is desirable to modify one of the standard Umbraco webhooks, for example, to change the Payload. This can be done by adding a custom implementation, as shown in the code example below:
 
+{% include "../../.gitbook/includes/obsolete-warning-ipublishedsnapshotaccessor.md" %}
+
 ```csharp
 [WebhookEvent("Content Published", Constants.WebhookEvents.Types.Content)]
 public class MyCustomContentPublishedWebhookEvent : WebhookEventContentBase<ContentPublishedNotification, IContent>