Add additional javadocs on integrations

smithy-trait-codegen/codegen-core/src/main/java/software/amazon/smithy/traitcodegen/integrations/idref/IdRefDecoratorIntegration.java

@@ -20,6 +20,10 @@
 import software.amazon.smithy.traitcodegen.TraitCodegenUtils;
 import software.amazon.smithy.utils.ListUtils;
 
+/**
+ * Handles the conversion of String members and String types with the {@code IdRef} trait to
+ * the {@link ShapeId} type.
+ */
 public class IdRefDecoratorIntegration implements TraitCodegenIntegration {
     private static final String INTEGRATION_NAME = "id-ref-integration";
     private static final Symbol SHAPE_ID_SYMBOL = TraitCodegenUtils.fromClass(ShapeId.class).toBuilder()

smithy-trait-codegen/codegen-core/src/main/java/software/amazon/smithy/traitcodegen/integrations/javadoc/JavaDocIntegration.java

@@ -13,6 +13,9 @@
 import software.amazon.smithy.utils.CodeSection;
 import software.amazon.smithy.utils.ListUtils;
 
+/**
+ * Adds Javadocs to generated Trait classes.
+ */
 public final class JavaDocIntegration implements TraitCodegenIntegration  {
 
     @Override

smithy-trait-codegen/codegen-core/src/main/java/software/amazon/smithy/traitcodegen/integrations/strings/StringListTraitGenerator.java

@@ -17,6 +17,13 @@
 import software.amazon.smithy.utils.SmithyBuilder;
 import software.amazon.smithy.utils.ToSmithyBuilder;
 
+/**
+ * Generates traits for the special case where the list's member is represented by a
+ * java string symbol.
+ *
+ * <p>List Traits with only a member shape that can be represented as a java string
+ * can use the base trait class {@link StringListTrait}.
+ */
 final class StringListTraitGenerator extends TraitGenerator {
     private static final String CLASS_TEMPLATE = "public final class $1T extends StringListTrait implements "
             + "ToSmithyBuilder<$1T> {";

smithy-trait-codegen/codegen-core/src/main/java/software/amazon/smithy/traitcodegen/integrations/strings/StringTraitGenerator.java

@@ -13,6 +13,13 @@
 import software.amazon.smithy.traitcodegen.generators.traits.TraitGenerator;
 import software.amazon.smithy.traitcodegen.writer.TraitCodegenWriter;
 
+/**
+ * Generates traits for the special case where the trait is a String trait that can
+ * be represented by a Java String symbol.
+ *
+ * <p>When a String trait is represented by a Java string, the trait can use the
+ * base class {@link StringTrait}.
+ */
 public class StringTraitGenerator extends TraitGenerator {
     private static final String CLASS_TEMPLATE = "public final class $T extends StringTrait {";
 

smithy-trait-codegen/codegen-core/src/main/java/software/amazon/smithy/traitcodegen/integrations/strings/StringsIntegration.java

@@ -16,8 +16,7 @@
 /**
  * Handles the special cases related to the use of strings.
  *
- * <p>
- * NOTE: Must be run after all other integrations to ensure any symbol changes
+ * <p>NOTE: Must be run after all other integrations to ensure any symbol changes
  * applied by other integrations are picked up
  */
 public class StringsIntegration implements TraitCodegenIntegration {

smithy-trait-codegen/codegen-core/src/main/java/software/amazon/smithy/traitcodegen/integrations/uniqueitems/UniqueItemDecoratorIntegration.java

@@ -18,6 +18,12 @@
 import software.amazon.smithy.traitcodegen.TraitCodegenUtils;
 import software.amazon.smithy.utils.ListUtils;
 
+/**
+ * Handles type conversions associated with the use of the {@code UniqueItems} trait.
+ *
+ * <p>Lists shapes and list members with the UniqueItems trait should be represented by
+ * a {@link Set} rather than a list.
+ */
 public class UniqueItemDecoratorIntegration implements TraitCodegenIntegration {
     private static final String SET_INITIALIZER = "forOrderedSet()";
     private static final String INTEGRATION_NAME = "unique-items-integration";