add comment

Author: dcharkes

pkgs/json_syntax_generator/lib/src/parser/schema_analyzer.dart

@@ -45,6 +45,20 @@ class SchemaAnalyzer {
   final List<String> publicSetters;
 
   /// For subtypes of these classes, the union tag values are exposed.
+  ///
+  /// For example, if `Asset.type` is `NativeCodeAsset.typeValue`, then the
+  /// asset is a native code asset. Listing `Asset` in [visbleUnionTagValues]
+  /// will add `static const typeValue = 'native_code';`:
+  ///
+  /// ```dart
+  /// class NativeCodeAsset extends Asset {
+  ///   static const typeValue = 'native_code';
+  /// }
+  ///
+  /// class Asset {
+  ///   String? get type => _reader.get<String?>('type');
+  /// }
+  /// ```
   final List<String> visbleUnionTagValues;
 
   SchemaAnalyzer(