Improve documentation in NettyScheduler for clarity on virtual thread inheritance rules

Author: franz1981

core/src/main/java/io/netty/loom/NettyScheduler.java

@@ -7,25 +7,23 @@
 /**
  * Global Netty scheduler proxy for virtual threads.
  *
- * <p>Exact inheritance rule: a newly started virtual thread will inherit the
- * caller's {@code EventLoopScheduler} only when both of the following are true:
- * <ul>
+ * <p>Inheritance rule (exact): a newly started virtual thread inherits the
+ * caller's {@code EventLoopScheduler} only when both conditions are true:
+ * <ol>
  *   <li>{@code jdk.pollerMode} is {@code 3} (per-carrier pollers); and</li>
- *   <li>the thread performing the start/poller I/O is itself run by an
- *       {@code EventLoopScheduler} (i.e. the current thread's
- *       {@code EventLoopScheduler.currentThreadSchedulerContext().scheduler()} is
- *       non-null).</li>
- * </ul>
+ *   <li>the thread performing the start/poller I/O is itself running under an
+ *       {@code EventLoopScheduler} (i.e. {@code EventLoopScheduler.currentThreadSchedulerContext().scheduler()}
+ *       returns a non-null {@code SharedRef}).</li>
+ * </ol>
  *
- * <p>If either condition is false the virtual thread does not inherit an
- * {@code EventLoopScheduler} and falls back to the default JDK scheduler.
+ * <p>The current implementation only attempts scheduler inheritance for
+ * poller-created virtual threads (recognized by the {@code "-Read-Poller"}
+ * name suffix). If either condition above is not met (or the thread kind is
+ * unrecognized) the virtual thread falls back to the default JDK scheduler.
  *
- * <p>Implementation note: the current implementation attempts inheritance only
- * for poller-created virtual threads (recognized by the {@code "-Read-Poller"}
- * name suffix).
- *
- * <p>This class is a proxy/dispatcher; see {@link EventLoopScheduler} for
- * details about scheduler attachment and execution.
+ * <p>This class is a proxy/dispatcher and does not implement a standalone
+ * scheduling policy. See {@link EventLoopScheduler} for details about scheduler
+ * attachment and execution.
  */
 
 public class NettyScheduler implements Thread.VirtualThreadScheduler {