doc improvement

core/src/main/java/hudson/model/Computer.java

@@ -664,6 +664,9 @@ public /*transient*/ abstract class Computer extends Actionable implements Acces
     /**
      * Called by {@link Jenkins#updateComputerList()} to notify {@link Computer} that it will be discarded.
      *
+     * <p>
+     * Note that at this point {@link #getNode()} returns null.
+     *
      * @see #onRemoved()
      */
     protected void kill() {
@@ -673,10 +676,14 @@ public /*transient*/ abstract class Computer extends Actionable implements Acces
     /**
      * Called by {@link Jenkins} when this computer is removed.
      *
+     * <p>
      * This happens when list of nodes are updated (for example by {@link Jenkins#setNodes(List)} and
      * the computer becomes redundant. Such {@link Computer}s get {@linkplain #kill() killed}, then
      * after all its executors are finished, this method is called.
      *
+     * <p>
+     * Note that at this point {@link #getNode()} returns null.
+     *
      * @see #kill()
      * @since 1.510
      */