Copyedit JavaDoc documentation (#83)

* Initial plan

* Add comprehensive JavaDoc and fix copyediting issues

Co-authored-by: trask <[email protected]>

* Remove new JavaDoc, keep only copyediting fixes

Co-authored-by: trask <[email protected]>

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: trask <[email protected]>

Author: Copilot

agent/runtime-attach/src/main/java/com/microsoft/applicationinsights/attach/ApplicationInsights.java

@@ -22,8 +22,8 @@
 public final class ApplicationInsights {
 
   /**
-   * This property allows configuring an Application Insights json file. It can be helpful to get an
-   * Application Insights json file by Spring profile.
+   * This property allows configuring an Application Insights JSON file. It can be helpful to load
+   * different Application Insights JSON files based on Spring profile.
    */
   public static final String APPLICATIONINSIGHTS_RUNTIME_ATTACH_CONFIGURATION_FILE =
       "applicationinsights.runtime-attach.configuration.classpath.file";
@@ -42,7 +42,7 @@ private ApplicationInsights() {}
    * Attach the Application Insights agent for Java to the current JVM. The attachment must be
    * requested at the beginning of the main method.
    *
-   * @throws ConfigurationException If the file given by the
+   * @throws ConfigurationException if the file specified by the
    *     applicationinsights.runtime-attach.configuration.classpath.file property was not found
    */
   public static void attach() {

classic-sdk/core/src/main/java/com/microsoft/applicationinsights/telemetry/AvailabilityTelemetry.java

@@ -63,7 +63,7 @@ public void setMessage(String message) {
     data.setMessage(message);
   }
 
-  /** Gets a dictionary of custom defined metrics. */
+  /** Gets a map of custom defined metrics. */
   public ConcurrentMap<String, Double> getMetrics() {
     return data.getMeasurements();
   }

classic-sdk/core/src/main/java/com/microsoft/applicationinsights/telemetry/BaseTelemetry.java

@@ -39,7 +39,7 @@ public TelemetryContext getContext() {
   }
 
   /**
-   * Gets a dictionary of application-defined property names and values providing additional
+   * Gets a map of application-defined property names and values providing additional
    * information about this event.
    */
   @Override

classic-sdk/core/src/main/java/com/microsoft/applicationinsights/telemetry/EventTelemetry.java

@@ -40,7 +40,7 @@ public void setName(String name) {
     data.setName(name);
   }
 
-  /** Gets a dictionary of custom defined metrics. */
+  /** Gets a map of custom defined metrics. */
   public ConcurrentMap<String, Double> getMetrics() {
     return data.getMeasurements();
   }

classic-sdk/core/src/main/java/com/microsoft/applicationinsights/telemetry/ExceptionTelemetry.java

@@ -73,7 +73,7 @@ public SeverityLevel getSeverityLevel() {
         : SeverityLevel.values()[data.getSeverityLevel().getValue()];
   }
 
-  /** Gets a dictionary of custom defined metrics. */
+  /** Gets a map of custom defined metrics. */
   public ConcurrentMap<String, Double> getMetrics() {
     return data.getMeasurements();
   }

classic-sdk/core/src/main/java/com/microsoft/applicationinsights/telemetry/PageViewTelemetry.java

@@ -59,7 +59,7 @@ public void setDuration(long duration) {
     data.setDuration(duration);
   }
 
-  /** Gets a dictionary of custom defined metrics. */
+  /** Gets a map of custom defined metrics. */
   public ConcurrentMap<String, Double> getMetrics() {
     return data.getMeasurements();
   }

classic-sdk/core/src/main/java/com/microsoft/applicationinsights/telemetry/TelemetryContext.java

@@ -123,12 +123,12 @@ public String getInstrumentationKey() {
     return null;
   }
 
-  /** Gets a dictionary of application-defined property values. */
+  /** Gets a map of application-defined property values. */
   public ConcurrentMap<String, String> getProperties() {
     return properties;
   }
 
-  /** Gets a dictionary of context tags. */
+  /** Gets a map of context tags. */
   public ConcurrentMap<String, String> getTags() {
     return tags;
   }