Skip to content

Commit e1fd413

Browse files
konardclaude
andcommitted
Internationalize code comments by translating Russian to English
- Translated Russian XML documentation comments to English in LinksConstants.cs - Translated Russian XML documentation comments to English in ILinksExtensions.cs - Cleaned up bilingual comments in ILinks.cs by removing Russian duplicates - Ensured all public API documentation is now consistently in English - Build verification confirms no compilation errors introduced Fixes #5 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 017803a commit e1fd413

3 files changed

Lines changed: 47 additions & 75 deletions

File tree

csharp/Platform.Data/ILinks.cs

Lines changed: 10 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,9 @@ namespace Platform.Data
1010
{
1111
/// <summary>
1212
/// <para>Represents an interface for manipulating data in the Links (links storage) format.</para>
13-
/// <para>Представляет интерфейс для манипуляции с данными в формате Links (хранилища связей).</para>
1413
/// </summary>
1514
/// <remarks>
1615
/// <para>This interface is independent of the size of the content of the link, meaning it is suitable for both doublets, triplets, and link sequences of any size.</para>
17-
/// <para>Этот интерфейс не зависит от размера содержимого связи, а значит подходит как для дуплетов, триплетов и последовательностей связей любого размера.</para>
1816
/// </remarks>
1917
public interface ILinks<TLinkAddress, TConstants>
2018
where TLinkAddress : IUnsignedNumber<TLinkAddress>
@@ -24,11 +22,9 @@ public interface ILinks<TLinkAddress, TConstants>
2422

2523
/// <summary>
2624
/// <para>Returns the set of constants that is necessary for effective communication with the methods of this interface.</para>
27-
/// <para>Возвращает набор констант, который необходим для эффективной коммуникации с методами этого интерфейса.</para>
2825
/// </summary>
2926
/// <remarks>
3027
/// <para>These constants are not changed since the creation of the links storage access point.</para>
31-
/// <para>Эти константы не меняются с момента создания точки доступа к хранилищу связей.</para>
3228
/// </remarks>
3329
TConstants Constants
3430
{
@@ -42,23 +38,20 @@ TConstants Constants
4238

4339
/// <summary>
4440
/// <para>Counts and returns the total number of links in the storage that meet the specified restriction.</para>
45-
/// <para>Подсчитывает и возвращает общее число связей находящихся в хранилище, соответствующих указанному ограничению.</para>
4641
/// </summary>
47-
/// <param name="restriction"><para>Restriction on the contents of links.</para><para>Ограничение на содержимое связей.</para></param>
48-
/// <returns><para>The total number of links in the storage that meet the specified restriction.</para><para>Общее число связей находящихся в хранилище, соответствующих указанному ограничению.</para></returns>
42+
/// <param name="restriction"><para>Restriction on the contents of links.</para></param>
43+
/// <returns><para>The total number of links in the storage that meet the specified restriction.</para></returns>
4944
[MethodImpl(MethodImplOptions.AggressiveInlining)]
5045
TLinkAddress Count(IList<TLinkAddress>? restriction);
5146

5247
/// <summary>
5348
/// <para>Passes through all the links matching the pattern, invoking a handler for each matching link.</para>
54-
/// <para>Выполняет проход по всем связям, соответствующим шаблону, вызывая обработчик (handler) для каждой подходящей связи.</para>
5549
/// </summary>
5650
/// <param name="restriction">
5751
/// <para>Restriction on the contents of links. Each constraint can have values: Constants.Null - the 0th link denoting a reference to the void, Any - the absence of a constraint, 1..∞ a specific link index.</para>
58-
/// <para>Ограничение на содержимое связей. Каждое ограничение может иметь значения: Constants.Null - 0-я связь, обозначающая ссылку на пустоту, Any - отсутствие ограничения, 1..∞ конкретный индекс связи.</para>
5952
/// </param>
60-
/// <param name="handler"><para>A handler for each matching link.</para><para>Обработчик для каждой подходящей связи.</para></param>
61-
/// <returns><para>Constants.Continue, if the pass through the links was not interrupted, and Constants.Break otherwise.</para><para>Constants.Continue, в случае если проход по связям не был прерван и Constants.Break в обратном случае.</para></returns>
53+
/// <param name="handler"><para>A handler for each matching link.</para></param>
54+
/// <returns><para>Constants.Continue, if the pass through the links was not interrupted, and Constants.Break otherwise.</para></returns>
6255
[MethodImpl(MethodImplOptions.AggressiveInlining)]
6356
TLinkAddress Each(IList<TLinkAddress>? restriction, ReadHandler<TLinkAddress>? handler);
6457

@@ -68,78 +61,57 @@ TConstants Constants
6861

6962
/// <summary>
7063
/// <para>Creates a link.</para>
71-
/// <para>Создаёт связь.</para>
64+
/// </summary>
7265
/// <param name="substitution">
7366
/// <para>The content of a new link. This argument is optional, if the null passed as value that means no content of a link is set.</para>
74-
/// <para>Содержимое новой связи. Этот аргумент опционален, если null передан в качестве значения это означает, что никакого содержимого для связи не установлено.</para>
7567
/// </param>
7668
/// <param name="handler">
7769
/// <para>A function to handle each executed change. This function can use Constants.Continue to continue proccess each change. Constants.Break can be used to stop receiving of executed changes.</para>
78-
/// <para>Функция для обработки каждого выполненного изменения. Эта функция может использовать Constants.Continue чтобы продолжить обрабатывать каждое изменение. Constants.Break может быть использована для остановки получения выполненных изменений.</para>
7970
/// </param>
80-
/// </summary>
8171
/// <returns>
8272
/// <para>
8373
/// Constants.Continue if all executed changes are handled.
8474
/// Constants.Break if proccessing of handled changes is stoped.
8575
/// </para>
86-
/// <para>
87-
/// Constants.Continue если все выполненные изменения обработаны.
88-
/// Constants.Break если обработака выполненных изменений остановлена.
89-
/// </para>
9076
/// </returns>
9177
[MethodImpl(MethodImplOptions.AggressiveInlining)]
9278
TLinkAddress Create(IList<TLinkAddress>? substitution, WriteHandler<TLinkAddress>? handler);
9379

9480
/// <summary>
95-
/// Обновляет связь с указанными restriction[Constants.IndexPart] в адресом связи
96-
/// на связь с указанным новым содержимым.
81+
/// <para>Updates a link with the specified restriction[Constants.IndexPart] as the link address to a link with the specified new content.</para>
9782
/// </summary>
9883
/// <param name="restriction">
99-
/// Ограничение на содержимое связей.
100-
/// Предполагается, что будет указан индекс связи (в restriction[Constants.IndexPart]) и далее за ним будет следовать содержимое связи.
101-
/// Каждое ограничение может иметь значения: Constants.Null - 0-я связь, обозначающая ссылку на пустоту,
102-
/// Constants.Itself - требование установить ссылку на себя, 1..∞ конкретный индекс другой связи.
84+
/// <para>Restriction on the content of links.</para>
85+
/// <para>It is assumed that a link index will be specified (in restriction[Constants.IndexPart]) followed by the link content.</para>
86+
/// <para>Each restriction can have values: Constants.Null - the 0th link denoting a reference to emptiness, Constants.Itself - requirement to set a reference to itself, 1..∞ specific index of another link.</para>
10387
/// </param>
104-
/// <param name="substitution"></param>
88+
/// <param name="substitution"><para>The new content of the link.</para></param>
10589
/// <param name="handler">
10690
/// <para>A function to handle each executed change. This function can use Constants.Continue to continue proccess each change. Constants.Break can be used to stop receiving of executed changes.</para>
107-
/// <para>Функция для обработки каждого выполненного изменения. Эта функция может использовать Constants.Continue чтобы продолжить обрабатывать каждое изменение. Constants.Break может быть использована для остановки получения выполненных изменений.</para>
10891
/// </param>
10992
/// <returns>
11093
/// <para>
11194
/// Constants.Continue if all executed changes are handled.
11295
/// Constants.Break if proccessing of handled changes is stoped.
11396
/// </para>
114-
/// <para>
115-
/// Constants.Continue если все выполненные изменения обработаны.
116-
/// Constants.Break если обработака выполненных изменений остановлена.
117-
/// </para>
11897
/// </returns>
11998
[MethodImpl(MethodImplOptions.AggressiveInlining)]
12099
TLinkAddress Update(IList<TLinkAddress>? restriction, IList<TLinkAddress>? substitution, WriteHandler<TLinkAddress>? handler);
121100

122101
/// <summary>
123102
/// <para>Deletes links that match the specified restriction.</para>
124-
/// <para>Удаляет связи соответствующие указанному ограничению.</para>
125103
/// </summary>
126104
/// <param name="restriction">
127105
/// <para>Restriction on the content of a link. This argument is optional, if the null passed as value that means no restriction on the content of a link are set.</para>
128-
/// <para>Ограничение на содержимое связи. Этот аргумент опционален, если null передан в качестве значения это означает, что никаких ограничений на содержимое связи не установлено.</para>
129106
/// </param>
130107
/// <param name="handler">
131108
/// <para>A function to handle each executed change. This function can use Constants.Continue to continue proccess each change. Constants.Break can be used to stop receiving of executed changes.</para>
132-
/// <para>Функция для обработки каждого выполненного изменения. Эта функция может использовать Constants.Continue чтобы продолжить обрабатывать каждое изменение. Constants.Break может быть использована для остановки получения выполненных изменений.</para>
133109
/// </param>
134110
/// <returns>
135111
/// <para>
136112
/// Constants.Continue if all executed changes are handled.
137113
/// Constants.Break if proccessing of handled changes is stoped.
138114
/// </para>
139-
/// <para>
140-
/// Constants.Continue если все выполненные изменения обработаны.
141-
/// Constants.Break если обработака выполненных изменений остановлена.
142-
/// </para>
143115
/// </returns>
144116
[MethodImpl(MethodImplOptions.AggressiveInlining)]
145117
TLinkAddress Delete(IList<TLinkAddress>? restriction, WriteHandler<TLinkAddress>? handler);

0 commit comments

Comments
 (0)