docs: add some additional docs to new methods

Author: helightdev

packages/dogs/lib/src/converters/enum.dart

@@ -70,6 +70,7 @@ mixin EnumConverter<T> on DogConverter<T> {
 }
 
 
+/// A runtime string-based [EnumConverter] implementation
 class RuntimeEnumConverter extends SimpleDogConverter<String> with EnumConverter<String> {
   @override
   final List<String> values;

packages/dogs/lib/src/extensions.dart

@@ -157,6 +157,9 @@ extension DogEngineShortcuts on DogEngine {
     return convertIterableFromNative(value, type ?? T, kind);
   }
 
+  /// Converts a field map to an instance of [T] using the structure
+  /// associated with [T] or [type] and the supplied [IterableKind].
+  /// If [tree] is supplied, the structure associated with the tree is used.
   T fromFieldMap<T>(Map<String,dynamic> fieldMap, {IterableKind kind = IterableKind.none, Type? type, TypeTree? tree}) {
     final structureType = tree?.base.typeArgument ?? type ?? T;
     final structure = findStructureByType(structureType);
@@ -166,6 +169,10 @@ extension DogEngineShortcuts on DogEngine {
     return structure.instantiateFromFieldMap(fieldMap);
   }
 
+
+  /// Converts a value of type [T] to a field map using the structure
+  /// associated with [T] or [type] and the supplied [IterableKind].
+  /// If [tree] is supplied, the structure associated with the tree is used.
   Map<String,dynamic> toFieldMap<T>(T value, {IterableKind kind = IterableKind.none, Type? type, TypeTree? tree}) {
     final structureType = tree?.base.typeArgument ?? type ?? T;
     final structure = findStructureByType(structureType);

packages/dogs/lib/src/schema/spec.dart

@@ -33,7 +33,12 @@ extension SchemaGenerateExtension on DogEngine {
       return converter.describeOutput(this, config);
     });
   }
-  
+
+  /// Materializes a [type] schema, creating a [MaterializedConverter] that
+  /// can be used to convert data to and from the schema.
+  ///
+  /// Materialization will create an engine fork with the custom types defined
+  /// in the schema.
   MaterializedConverter materialize(SchemaType type) {
     return DogsMaterializer.get(this).materialize(type);
   }