Added Note for obsolete methods

Author: eshanrnh

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 `using 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/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 @@ public class ContentPickerPropertyConverter : IPropertyValueConverter
             : null;
 }
 ```
+
 {% endcode %}

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

@@ -113,6 +113,10 @@ This is particularly useful for property values that contain references to other
 
 #### `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 @@ public object ConvertSourceToIntermediate(IPublishedElement owner, IPublishedPro
 
 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 @@ 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/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 @@ 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/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;