doc: update documentations

cherrypick_generator/lib/src/bind_parameters_spec.dart

@@ -11,25 +11,58 @@
 // limitations under the License.
 //
 
+/// ----------------------------------------------------------------------------
+/// BindParameterSpec - describes a single method parameter and how to resolve it.
 ///
-/// Описывает один параметр метода и возможность его разрешения из контейнера.
+/// ENGLISH
+/// Describes a single parameter for a provider/binding method in the DI system.
+/// Stores the parameter type, its optional `@named` key for named resolution,
+/// and whether it is a runtime "params" argument. Used to generate code that
+/// resolves dependencies from the DI scope:
+///   - If the parameter is a dependency type (e.g. SomeDep), emits:
+///         currentScope.resolve<SomeDep>()
+///   - If the parameter is named, emits:
+///         currentScope.resolve<SomeDep>(named: 'yourName')
+///   - If it's a runtime parameter (e.g. via @params()), emits:
+///         args
 ///
-/// Например, если метод принимает SomeDep dep, то
-/// BindParameterSpec хранит тип SomeDep, а generateArg отдаст строку
+/// RUSSIAN
+/// Описывает один параметр метода в DI, и его способ разрешения из контейнера.
+/// Сохраняет имя типа, дополнительное имя (если параметр аннотирован через @named),
+/// и признак runtime-параметра (@params).
+/// Для обычной зависимости типа (например, SomeDep) генерирует строку вида:
 ///   currentScope.resolve<SomeDep>()
-///
+/// Для зависимости с именем:
+///   currentScope.resolve<SomeDep>(named: 'имя')
+/// Для runtime-параметра:
+///   args
+/// ----------------------------------------------------------------------------
 class BindParameterSpec {
+  /// Type name of the parameter (e.g. SomeService)
   /// Имя типа параметра (например, SomeService)
   final String typeName;
 
+  /// Optional name for named resolution (from @named)
   /// Необязательное имя для разрешения по имени (если аннотировано через @named)
   final String? named;
 
+  /// True if this parameter uses @params and should be provided from runtime args
+  /// Признак, что параметр — runtime (через @params)
   final bool isParams;
 
   BindParameterSpec(this.typeName, this.named, {this.isParams = false});
 
-  /// Генерирует строку для получения зависимости из DI scope (с учётом имени)
+  /// --------------------------------------------------------------------------
+  /// generateArg
+  ///
+  /// ENGLISH
+  /// Generates Dart code for resolving the dependency from the DI scope,
+  /// considering type, named, and param-argument.
+  ///
+  /// RUSSIAN
+  /// Генерирует строку для получения зависимости из DI scope (с учётом имени
+  /// и типа параметра или runtime-режима @params).
+  /// --------------------------------------------------------------------------
   String generateArg([String paramsVar = 'args']) {
     if (isParams) {
       return paramsVar;