Add notes to the interface javadocs

Author: marko-radosavljevic

Contest/Assignment/src/org/togetherjava/event/elevator/elevators/FloorPanelSystem.java

@@ -6,9 +6,12 @@
 public interface FloorPanelSystem {
     /**
      * Requests an elevator to move to the given floor to pick up a human.
-     * @param atFloor the floor to pick up the human at, must be within the range served by the system
+     *
+     * @param atFloor                the floor to pick up the human at, must be within the range served by the system
      * @param desiredTravelDirection the direction the human wants to travel into,
      *                               can be used for determination of the best elevator
+     * @apiNote This represents a human standing in the corridor, pressing a button on the wall,
+     * requesting that an elevator comes to pick them up for travel into the given direction.
      */
     void requestElevator(int atFloor, TravelDirection desiredTravelDirection);
 }

Contest/Assignment/src/org/togetherjava/event/elevator/humans/ElevatorListener.java

@@ -21,6 +21,8 @@ public interface ElevatorListener {
      *
      * @param elevatorPanel the system inside the elevator which provides information
      *                      about the elevator and can be used to request a destination floor.
+     * @implNote The default implementation fires this event from all elevators to all humans, not only to humans that are
+     * relevant (i.e. humans that can enter the elevator).
      */
     void onElevatorArrivedAtFloor(ElevatorPanel elevatorPanel);
 }