docs: update doc comments

slang/lib/builder/builder/translation_map_builder.dart

@@ -8,8 +8,8 @@ import 'package:slang/builder/model/translation_map.dart';
 class TranslationMapBuilder {
   /// This method transforms files to an intermediate model [TranslationMap].
   /// After this step,
-  /// - we ignore the environment (i.e. dart:io, build_runner)
-  /// - we ignore the file type (JSON, YAML, CSV) because everything is a map now
+  /// - we removed the environment (i.e. dart:io, build_runner)
+  /// - we removed the file type (JSON, YAML, CSV) because everything is a map now
   ///
   /// The resulting map is in a unmodified state, so no actual i18n handling (plural, rich text) has been applied.
   static Future<TranslationMap> build({

slang/lib/builder/model/slang_file_collection.dart

@@ -4,6 +4,9 @@ import 'package:slang/builder/model/i18n_locale.dart';
 import 'package:slang/builder/model/raw_config.dart';
 import 'package:slang/builder/utils/path_utils.dart';
 
+/// A collection of translation files that can be read in a later step.
+/// This is an abstraction to support build_runner and the custom CLI by
+/// providing a common [FileReader] interface.
 class SlangFileCollection {
   final RawConfig config;
   final List<TranslationFile> files;