Docs: Add Javadoc Comments to Public Methods in Command.java #9

Author: Thidas Senavirathna

src/main/java/com/mycmd/Command.java

@@ -1,5 +1,26 @@
 package com.mycmd;
 
+/**
+ * Represents a shell command that can be executed inside the MyCMD shell.
+ * Implementations perform their operation when {@link #execute(String[], ShellContext)} is called.
+ */
 public interface Command {
+    /**
+     * Execute the command.
+     *
+     * <p>Implementations should perform all output to standard output or use the provided
+     * {@link ShellContext} for interactions that depend on the shell state (for example,
+     * changing the current directory).</p>
+     *
+     * @param args    command-line style arguments passed to the command. May be empty but
+     *                will not be null.
+     * @param context current shell context containing state such as the current working
+     *                directory. Implementations may read and/or modify this context.
+     * @throws Exception if the command cannot complete successfully. The caller (shell)
+     *                   is responsible for catching and reporting exceptions.
+     *
+     * @implNote Common concrete commands include `date` and `time` which simply print the
+     * current date/time to standard output. See their implementations for formatting details.
+     */
     void execute(String[] args, ShellContext context);
 }

src/main/java/com/mycmd/commands/DateCommand.java

@@ -4,7 +4,20 @@
 import com.mycmd.ShellContext;
 import java.time.LocalDate;
 
+/**
+ * Command that prints the current date to standard output.
+ *
+ * <p>This command does not use the provided {@link ShellContext} but keeps the
+ * parameter to conform to the {@link Command} contract. The output is produced
+ * using {@link LocalDate#now()} and printed in ISO-8601 format (yyyy-MM-dd).</p>
+ */
 public class DateCommand implements Command {
+    /**
+     * Print the current date.
+     *
+     * @param args    ignored for this command; may be empty or contain unused tokens.
+     * @param context the current shell context; not used by this command.
+     */
     @Override
     public void execute(String[] args, ShellContext context) {
         System.out.println("The current date is: " + java.time.LocalDate.now());

src/main/java/com/mycmd/commands/TimeCommand.java

@@ -5,7 +5,26 @@
 import java.time.LocalTime;
 import java.time.format.DateTimeFormatter;
 
+/**
+ * Command that prints the current local time to standard output using a simple
+ * custom formatter.
+ *
+ * <p>The time is formatted with the pattern "H.mm.ss.SS" where:
+ * <ul>
+ *   <li>H - hour-of-day (0-23)</li>
+ *   <li>mm - minute-of-hour</li>
+ *   <li>ss - second-of-minute</li>
+ *   <li>SS - fraction-of-second (two digits)</li>
+ * </ul>
+ * Example output: "The current time is: 13.5.07.12"</p>
+ */
 public class TimeCommand implements Command {
+    /**
+     * Print the current time.
+     *
+     * @param args    ignored for this command; may be empty or contain unused tokens.
+     * @param context the current shell context; not used by this command.
+     */
     @Override
     public void execute(String[] args, ShellContext context) {
         LocalTime now = LocalTime.now();