Fix ambiguous method signatures; update documentation

Author: sbabcoc

README.md

@@ -20,8 +20,10 @@ The objects passed to your service provider implementation are members of a hier
 
 * `LifecycleHooks.getParentOf(Object runner)`  
 Get the parent runner that owns the specified child runner.
-* `LifecycleHooks.getTestClassFor(Object target)`  
-Get the test class object that wraps the specified instance.
+* `LifecycleHooks.getParentOf(FrameworkMethod method)`  
+Get the parent runner that owns the specified method.
+* `LifecycleHooks.getRunnerForTarget(Object target)`  
+Get the parent runner owns the specified instance.
 * `LifecycleHooks.getRunnerFor(TestClass testClass)`  
 Get the parent runner associated with the specified test class object.
 * `LifecycleHooks.getTestClassWith(Object method)`  
@@ -72,8 +74,8 @@ public class ExploringWatcher implements TestClassWatcher2, MethodWatcher {
     public void beforeInvocation(Object target, FrameworkMethod method, Object... params) {
         // get the 'atomic test' for this method
         AtomicTest atomicTest = RunReflectiveCall.getAtomicTestFor(method);
-        // get the test class of the runner that owns this method
-        TestClass testClass = LifecycleHooks.getTestClassFor(target);
+        // get the runner that owns this target
+        Object runner = LifecycleHooks.getRunnerForTarget(target);
         ...
     }
 

src/main/java/com/nordstrom/automation/junit/LifecycleHooks.java

@@ -232,7 +232,7 @@ public static Object intercept(@This final Object runner,
          * @param target instance of JUnit test class
          * @return {@link org.junit.runners.BlockJUnit4ClassRunner BlockJUnit4ClassRunner} for specified instance
          */
-        static Object getRunnerFor(Object target) {
+        static Object getRunnerForTarget(Object target) {
             return TARGET_TO_RUNNER.get(target);
         }
     }
@@ -243,8 +243,8 @@ static Object getRunnerFor(Object target) {
      * @param target instance of JUnit test class
      * @return {@link org.junit.runners.BlockJUnit4ClassRunner BlockJUnit4ClassRunner} for specified instance
      */
-    public static Object getRunnerFor(Object target) {
-        return CreateTest.getRunnerFor(target);
+    public static Object getRunnerForTarget(Object target) {
+        return CreateTest.getRunnerForTarget(target);
     }
 
     /**
@@ -306,7 +306,7 @@ public static boolean hasConfiguration(TestClass testClass) {
      * @return {@link Description} object for the indicated child
      */
     public static Description describeChild(Object target, Object child) {
-        Object runner = getRunnerFor(target);
+        Object runner = getRunnerForTarget(target);
         return invoke(runner, "describeChild", child);
     }