Added some comments

Directory.Build.props

@@ -13,8 +13,8 @@
     <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
   </PropertyGroup>
   <PropertyGroup>
-    <VersionMajor>1</VersionMajor>
-    <VersionMinor>1</VersionMinor>
+    <VersionMajor>2</VersionMajor>
+    <VersionMinor>0</VersionMinor>
     <BuildNumber>$(BuildNumber)</BuildNumber>
     <BuildNumber Condition="'$(BuildNumber)' == ''">0</BuildNumber>
     <PackageVersion>$(VersionMajor).$(VersionMinor).$(BuildNumber)$(VersionTag)</PackageVersion>

Mindbox.YandexTracker.Abstractions/Entities/Issue.cs

@@ -143,9 +143,9 @@ public sealed record Issue
 	/// Кастомные поля задачи
 	/// </summary>
 	/// <remarks>
-	/// Необходимость JsonNode заключается в том, что мы не знаем какое объект придет к нам с сервера под заданным ключем.
-	/// Чтобы не поломать работу было принято использовать JToken и ограничить доступ к словарю через GetCustomField и
-	/// SetCustomField
+	/// Используем JsonElement, потому что на этапе компиляции мы не знаем, какой объект придет к нам с сервера под
+	/// заданным ключиком. Чтобы не поломать работу было принято использовать JsonElement и ограничить доступ к словарю через
+	/// GetCustomField и SetCustomField.
 	/// </remarks>
 	internal Dictionary<string, JsonElement> CustomFields { get; init; } = [];
 

Mindbox.YandexTracker/JsonConverters/EnumWithEnumMemberAttributeJsonConverter.cs

@@ -0,0 +1,40 @@
+using System;
+using System.Reflection;
+using System.Runtime.Serialization;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace Mindbox.YandexTracker.JsonConverters;
+
+/// <summary>
+/// Кастомный конвертер для сериализации/десериализации enum'ов с атрибутом EnumMemberAttribute.
+/// </summary>
+/// <remarks>
+/// При конвертации в json значение берется из атрибута.
+/// </remarks>
+internal class EnumWithEnumMemberAttributeJsonConverter<T> : JsonConverter<T> where T: Enum
+{
+	public override T Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
+	{
+		string? enumString = reader.GetString();
+		for (var i = 0; i < typeToConvert.GetFields().Length; i++)
+		{
+			var field = typeToConvert.GetFields()[i];
+
+			if (field.GetCustomAttribute<EnumMemberAttribute>()?.Value == enumString)
+			{
+				return (T)field.GetValue(null)!;
+			}
+		}
+
+		if (enumString == null) throw new JsonException($"Unknown value for {nameof(QueueLocalFieldType)} ({enumString})");
+
+		return (T)Enum.Parse(typeToConvert, enumString, true);
+	}
+
+	public override void Write(Utf8JsonWriter writer, T value, JsonSerializerOptions options)
+	{
+		var enumMemberAttribute = value.GetType().GetField(value.ToString())?.GetCustomAttribute<EnumMemberAttribute>();
+		writer.WriteStringValue(enumMemberAttribute != null ? enumMemberAttribute.Value : value.ToString());
+	}
+}

Mindbox.YandexTracker/JsonConverters/YandexDateTimeConverter.cs → Mindbox.YandexTracker/JsonConverters/YandexDateTimeJsonConverter.cs

@@ -5,7 +5,10 @@
 
 namespace Mindbox.YandexTracker.JsonConverters;
 
-internal class YandexDateTimeConverter : JsonConverter<DateTime>
+/// <summary>
+/// Кастомный конвертер для сериализации/десериализации даты и времени в формате Yandex'а.
+/// </summary>
+internal class YandexDateTimeJsonConverter : JsonConverter<DateTime>
 {
 	private const string DateFormat = "yyyy-MM-ddTHH:mm:ss.fffzzz"; // Adjust this to match your JSON date format
 

Mindbox.YandexTracker/JsonConverters/YandexNullableDateTimeConverter.cs → Mindbox.YandexTracker/JsonConverters/YandexNullableDateTimeJsonConverter.cs

@@ -5,7 +5,10 @@
 
 namespace Mindbox.YandexTracker.JsonConverters;
 
-internal class YandexNullableDateTimeConverter : JsonConverter<DateTime?>
+/// <summary>
+/// Кастомный конвертер для сериализации/десериализации nullable даты и времени в формате Yandex'а.
+/// </summary>
+internal class YandexNullableDateTimeJsonConverter : JsonConverter<DateTime?>
 {
 	private const string DateFormat = "yyyy-MM-ddTHH:mm:ss.fffzzz"; // Adjust this to match your JSON date format
 

Mindbox.YandexTracker/YandexTrackerClient.cs

@@ -37,10 +37,10 @@ public YandexTrackerClient(
 		{
 			Converters =
 			{
-				new QueueLocalFieldTypeConverter(),
+				new EnumWithEnumMemberAttributeJsonConverter<QueueLocalFieldType>(),
 				new JsonStringEnumConverter(namingPolicy: JsonNamingPolicy.CamelCase),
-				new YandexDateTimeConverter(),
-				new YandexNullableDateTimeConverter()
+				new YandexDateTimeJsonConverter(),
+				new YandexNullableDateTimeJsonConverter()
 			},
 			DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull,
 			PropertyNamingPolicy = JsonNamingPolicy.CamelCase,