добавлены комментарии

Author: Mr-Rm

src/OneScript.Core/Values/IBslComparable.cs

@@ -8,8 +8,8 @@ This Source Code Form is subject to the terms of the
 namespace OneScript.Values
 {
     /// <summary>
-    /// Èíòåðôåéñ-ìàðêåð äëÿ ïðèìèòèâíûõ òèïîâ, äîïóñêàþùèõ ñðàâíåíèå íà áîëüøå/ìåíüøå.
-    /// Èñïîëüçóåòñÿ GenericIValueComparer äëÿ îïðåäåëåíèÿ âîçìîæíîñòè ñðàâíåíèÿ.
+    /// Интерфейс-маркер для примитивных типов, допускающих сравнение на больше/меньше.
+    /// Используется GenericIValueComparer для определения возможности сравнения.
     /// </summary>
     public interface IBslComparable
     {

src/ScriptEngine/Machine/GenericIValueComparer.cs

@@ -67,8 +67,15 @@ private int CompareAsStrings(IValue x, IValue y)
         private int CompareByPresentations(IValue x, IValue y)
         {
             return ((BslValue)x).ToString(_process).CompareTo(((BslValue)y).ToString(_process));
-        }
-
+        }
+
+        /// <summary>
+        /// Сравнение переменных разных типов. Правила сравнения соответствуют 1С v8.3.27:
+        /// Переменные типа "Тип" следуют за всеми прочими;
+        /// Другие примитивные типы предшествуют объектным типам;
+        /// Между собой примитивные типы упорядочиваются в последовательности, указанной в orderedTypes;
+        /// Объектные типы упорядочиваются по строковому представлению.
+        /// </summary>
         private int CompareByTypes(IValue x, IValue y)
         {
             var ix = orderedTypes.IndexOf(x.SystemType);