with improved understanding of test cases

src/main/java/com/zipcodewilmington/phonebook/Person.java

@@ -24,14 +24,17 @@ public class Person {
     }
 
     public String getNumbers(){
+
         return phoneNumber.toString();
     }
 
     public void removeSingleNumber (String number){
+
         phoneNumber.remove(number);
     }
 
     public void addAdditionalNumber(String number){
+
         phoneNumber.add(number);
     }
 }

src/main/java/com/zipcodewilmington/phonebook/PhoneBook.java

@@ -13,9 +13,12 @@ public class PhoneBook {
     public static void main(String[] args) {
 
         PhoneBook myPhoneBookActualObjectInstance= new PhoneBook();
+        //adding two people:
         myPhoneBookActualObjectInstance.add("vince", "1123456789");
         myPhoneBookActualObjectInstance.add("amy", "29387429");
-        myPhoneBookActualObjectInstance.personTreeMap.get("amy").addAdditionalNumber("2344");
+        //asking the program to get a person using it's name and adding an additional number to it:
+        myPhoneBookActualObjectInstance.addAdditionalNumberToEntry("amy", "2344");
+        //printing out the entire phonebook
         System.out.println(myPhoneBookActualObjectInstance.displayEntirePhoneBookContents());
     }
 
@@ -40,6 +43,12 @@ public class PhoneBook {
         personTreeMap.remove(name);
     }
 
+    //newly added thanks to "the falcon"
+    public void addAdditionalNumberToEntry (String name, String number){
+        personTreeMap.get(name).addAdditionalNumber(number);
+
+    }
+
     public String lookup(String name) {
 
         return personTreeMap.get(name).getNumbers();

src/test/java/com/zipcodewilmington/phonebook/PersonTest.java

@@ -0,0 +1,20 @@
+package com.zipcodewilmington.phonebook;
+
+import org.junit.Test;
+
+import static org.junit.Assert.*;
+
+public class PersonTest {
+
+    @Test
+    public void getNumbers() {
+    }
+
+    @Test
+    public void removeSingleNumber() {
+    }
+
+    @Test
+    public void addAdditionalNumber() {
+    }
+}

src/test/java/com/zipcodewilmington/phonebook/PhoneBookTest.java

@@ -23,9 +23,20 @@ public class PhoneBookTest {
 
     @Test
     public void addEntryTestCase1(){
+        //Given
+            //a person object
+            // a name and a number object
         new Person("Addison", "1234");
+
+
+        //When
+            //we add the person to the phonebook
         testPhonebook.add("Addison", "1234");
         String testNumber = testPhonebook.lookup("Addison");
+
+        //Then
+            //we expect to see that person object with assigned name and number
+
         Assert.assertTrue(testNumber.equals("[1234]"));
     }
 
@@ -48,66 +59,135 @@ public class PhoneBookTest {
 
     @Test
     public void removeEntireEntryTest2(){
+        //Given
+            //2 person objects
+            // 2 names and 2 phone numbers
+
         testPhonebook.add("Andrea", "8888");
         testPhonebook.add("Alexei", "8877");
+
+        //When
+            //a user/dev removes one entry from the phonebook
         testPhonebook.removeEntireEntry("Alexei");
         String testList = testPhonebook.showNamesOnly();
+
+        //Then
+            //we expect to see that entry gone. we expect only to see all the other entries.
         Assert.assertTrue(testList.equals("Andrea\n"));
 
+    }
+
+        //newly added thanks to "the falcon"
+    @Test
+    public void addAddtionalNumberToEntryTest() {
+        //Given
+            //A name and a number
+        testPhonebook.add("test", "123");
+
+
+        //When
+            //we add additional number
+        testPhonebook.addAdditionalNumberToEntry("test", "200");
 
+
+        //Then
+            //we expect expect to see that additional number added to the entry
+            String expected = "[123, 200]";
+            String actual = testPhonebook.lookup("test");
+            Assert.assertEquals(expected,actual);
     }
 
     @Test
     public void testLookup() {
 
+        //Given
+            //a person object with name and number
+
         testPhonebook.add("JohnDoe", "1123");
 
+        //When
+            //we try and look up a person's phone number by using their name as the search thing
         String expected = "[1123]";
         String actual = testPhonebook.lookup("JohnDoe");
 
+        //Then
+            //we expect to see their number
+
         Assert.assertEquals(expected, actual);
 
     }
 
     @Test
     public void testListNamesOnly1 (){
+        //Given
+            //a bunch of people with names and numbers
         testPhonebook.add("Andrea", "8888");
         testPhonebook.add("Alexei", "8877");
         testPhonebook.add("Addison", "1234");
         testPhonebook.add("AdDy", "1234");
+
+        //When
+            //we ask the program to display just the names
         String actual = testPhonebook.showNamesOnly();
         String expected = "AdDy\nAddison\nAlexei\nAndrea\n";
+
+        //Then
+            //we expect to see just the names
         Assert.assertEquals(expected, actual);
     }
 
     @Test
     public void displayEntirePhoneBookContentsTest(){
+        //Given
+            //a list of peoples name and numbers
         testPhonebook.add("Andrea", "8888");
         testPhonebook.add("Alexei", "8877");
+        //When
+            //we ask to see all entries with name and numbers
         String actual = testPhonebook.displayEntirePhoneBookContents();
-        String expected = "Alexei's phone number: [8877]\nAndrea's phone number: [8888]\n";
+        String expected = "Alexei's phone number(s): [8877]\nAndrea's phone number(s): [8888]\n";
+        //Then
+            //we expect to see all entries with name and numbers
         Assert.assertEquals(expected, actual);
     }
 
     @Test
     public void addAdditionalNumberTest(){
+        //Given
+            //a person object with an existing number
         testPhonebook.add("Andrea", "8888");
+        //When
+            // we add an addtional number to that person object
         testPhonebook.personTreeMap.get("Andrea").addAdditionalNumber("1111");
+
+        //Then
+            // we expect to see that number added
         String actual= testPhonebook.displayEntirePhoneBookContents();
         String expected = "Andrea's phone number(s): [8888, 1111]\n";
+//        String actual = testPhonebook.lookup("Andrea");
+//        String expected = "[8888, 1111]";
         Assert.assertEquals(expected, actual);
 
     }
-
     @Test
     public void removeSingleNumberTest(){
+        //Given
+            //an entry with more than 1 number
         testPhonebook.add("Andrea", "8888");
         testPhonebook.personTreeMap.get("Andrea").addAdditionalNumber("1111");
         testPhonebook.personTreeMap.get("Andrea").addAdditionalNumber("2222");
+
+        //When
+            //we try to remove a number
         testPhonebook.personTreeMap.get("Andrea").removeSingleNumber("1111");
+
+        //Then
+            //we expect to see the original entry with all of its numbers except the one we removed
         String actual = testPhonebook.displayEntirePhoneBookContents();
         String expected = "Andrea's phone number(s): [8888, 2222]\n";
         Assert.assertEquals(expected, actual);
     }
 
+
+
 }