Exporter: Comment and tag

src/Famix-Value-Exporter/FASTBuilder.class.st

@@ -1,10 +1,13 @@
+"
+I am a helper for the `FamixValue2ASTVisitor` hierarchy of classes to build AST.
+"
 Class {
 	#name : #FASTBuilder,
 	#superclass : #Object,
 	#instVars : [
 		'model'
 	],
-	#category : #'Famix-Value-Exporter'
+	#category : #'Famix-Value-Exporter-Helpers'
 }
 
 { #category : #testing }

src/Famix-Value-Exporter/FASTJavaBuilder.class.st

@@ -1,10 +1,13 @@
+"
+I am used to handle Java type references and imports.
+"
 Class {
 	#name : #FASTJavaBuilder,
 	#superclass : #FASTBuilder,
 	#instVars : [
 		'typeNameDictionary'
 	],
-	#category : #'Famix-Value-Exporter'
+	#category : #'Famix-Value-Exporter-Helpers'
 }
 
 { #category : #ast }

src/Famix-Value-Exporter/FamixValue2ASTVisitor.class.st

@@ -10,7 +10,7 @@ Class {
 		'id',
 		'statementBlock'
 	],
-	#category : #'Famix-Value-Exporter'
+	#category : #'Famix-Value-Exporter-Visitors'
 }
 
 { #category : #testing }

src/Famix-Value-Exporter/FamixValue2FASTJavaVisitor.class.st

@@ -1,12 +1,12 @@
 "
-A visitor for exporting a FamixValue model to FASTJava.
+A visitor to export a FamixValue model to FASTJava.
 The generated code is a block statement with a variable declared for each value.
 
 Object attributes are initialized by finding the corresponding setters.
-Collections and Dictionaries are constructed with the `add(element)` and `put(key, value)` methods respectively.
+Collections and Dictionaries are constructed with the methods `add(element)` and `put(key, value)` respectively.
 
-When exporting a `FamixValueOfObjectAttribute`, if the setter for its `FamixTAttribute` cannot be found, they are set using the Java Reflection API.
-All attributes that fall in this category are added as `markedForReflection`.
+When exporting a `FamixValueOfObjectAttribute`, if the setter for its `FamixTAttribute` cannot be found, it is set using the Java Reflection API.
+All attributes that fall into this category are added as `markedForReflection`.
 "
 Class {
 	#name : #FamixValue2FASTJavaVisitor,
@@ -18,7 +18,7 @@ Class {
 		'staticAttributesCache',
 		'objectExportStrategy'
 	],
-	#category : #'Famix-Value-Exporter'
+	#category : #'Famix-Value-Exporter-Visitors'
 }
 
 { #category : #private }

src/Famix-Value-Exporter/FamixValue2PharoVisitor.class.st

@@ -1,13 +1,14 @@
 "
-A visitor for exporting a FamixValue model to the Pharo AST, see `RBEntity` and `RBNode`.
+A visitor for exporting a FamixValue model to the Pharo AST, see `RBNode`.
 
 Object attributes are initialized by finding the corresponding setters.
-Collections and Dictionaries are constructed with the `withAll:` class method.
+Collections are constructed using the `withAll:` class method.
+Dictionaries are constructed using the `newFrom:` class method.
 "
 Class {
 	#name : #FamixValue2PharoVisitor,
 	#superclass : #FamixValue2ASTVisitor,
-	#category : #'Famix-Value-Exporter'
+	#category : #'Famix-Value-Exporter-Visitors'
 }
 
 { #category : #testing }

src/Famix-Value-Exporter/FamixValueAbstractObjectExportStrategy.class.st

@@ -1,3 +1,7 @@
+"
+I am a strategy for exporting objects used by the `FamixValue2ASTVisitor` hierarchy of classes.
+Objects can be complex to recreate due to deep nesting and circular dependencies, resulting in a lot of code. My subclasses define where that code goes.
+"
 Class {
 	#name : #FamixValueAbstractObjectExportStrategy,
 	#superclass : #Object,

src/Famix-Value-Exporter/FamixValueHelperObjectExportStrategy.class.st

@@ -1,3 +1,7 @@
+"
+I generate the code to recreate objects in helper functions.
+For each object, a dedicated function is generated that takes no arguments and returns the recreated object.
+"
 Class {
 	#name : #FamixValueHelperObjectExportStrategy,
 	#superclass : #FamixValueAbstractObjectExportStrategy,

src/Famix-Value-Exporter/FamixValueInlineObjectExportStrategy.class.st

@@ -1,3 +1,7 @@
+"
+I recreate objects inline.
+The context of the visitor will contain the code to recreate the objects.
+"
 Class {
 	#name : #FamixValueInlineObjectExportStrategy,
 	#superclass : #FamixValueAbstractObjectExportStrategy,