Fix docs and validation errors

Author: ZacSweers

src/main/java/io/reactivex/Completable.java

@@ -914,7 +914,7 @@ public final Completable andThen(CompletableSource next) {
      * This allows fluent conversion to any other type.
      * <dl>
      *  <dt><b>Scheduler:</b></dt>
-     *  <dd>{@code to} does not operate by default on a particular {@link Scheduler}.</dd>
+     *  <dd>{@code as} does not operate by default on a particular {@link Scheduler}.</dd>
      * </dl>
      *
      * @param <R> the resulting object type
@@ -925,7 +925,7 @@ public final Completable andThen(CompletableSource next) {
     @Experimental
     @CheckReturnValue
     @SchedulerSupport(SchedulerSupport.NONE)
-    public final <R> R as(CompletableConverter<? extends R> converter) {
+    public final <R> R as(@NonNull CompletableConverter<? extends R> converter) {
         try {
             return ObjectHelper.requireNonNull(converter, "converter is null").apply(this);
         } catch (Throwable ex) {

src/main/java/io/reactivex/CompletableConverter.java

@@ -24,7 +24,7 @@
 @Experimental
 public interface CompletableConverter<R> {
     /**
-     * Applies a function to the upstream Completable and returns a converted value of type <R>.
+     * Applies a function to the upstream Completable and returns a converted value of type {@code R}.
      *
      * @param upstream the upstream Completable instance
      * @return the converted value

src/main/java/io/reactivex/Flowable.java

@@ -5245,7 +5245,7 @@ public final Single<Boolean> any(Predicate<? super T> predicate) {
      *  <dt><b>Backpressure:</b></dt>
      *  <dd>The backpressure behavior depends on what happens in the {@code converter} function.</dd>
      *  <dt><b>Scheduler:</b></dt>
-     *  <dd>{@code to} does not operate by default on a particular {@link Scheduler}.</dd>
+     *  <dd>{@code as} does not operate by default on a particular {@link Scheduler}.</dd>
      * </dl>
      *
      * @param <R> the resulting object type
@@ -5257,7 +5257,7 @@ public final Single<Boolean> any(Predicate<? super T> predicate) {
     @CheckReturnValue
     @BackpressureSupport(BackpressureKind.SPECIAL)
     @SchedulerSupport(SchedulerSupport.NONE)
-    public final <R> R as(FlowableConverter<T, ? extends R> converter) {
+    public final <R> R as(@NonNull FlowableConverter<T, ? extends R> converter) {
         try {
             return ObjectHelper.requireNonNull(converter, "converter is null").apply(this);
         } catch (Throwable ex) {

src/main/java/io/reactivex/FlowableConverter.java

@@ -25,7 +25,7 @@
 @Experimental
 public interface FlowableConverter<T, R> {
     /**
-     * Applies a function to the upstream Flowable and returns a converted value of type <R>.
+     * Applies a function to the upstream Flowable and returns a converted value of type {@code R}.
      *
      * @param upstream the upstream Flowable instance
      * @return the converted value

src/main/java/io/reactivex/Maybe.java

@@ -1995,7 +1995,7 @@ public final Maybe<T> ambWith(MaybeSource<? extends T> other) {
      * This allows fluent conversion to any other type.
      * <dl>
      * <dt><b>Scheduler:</b></dt>
-     * <dd>{@code to} does not operate by default on a particular {@link Scheduler}.</dd>
+     * <dd>{@code as} does not operate by default on a particular {@link Scheduler}.</dd>
      * </dl>
      *
      * @param <R> the resulting object type
@@ -2006,7 +2006,7 @@ public final Maybe<T> ambWith(MaybeSource<? extends T> other) {
     @Experimental
     @CheckReturnValue
     @SchedulerSupport(SchedulerSupport.NONE)
-    public final <R> R as(MaybeConverter<T, ? extends R> converter) {
+    public final <R> R as(@NonNull MaybeConverter<T, ? extends R> converter) {
         try {
             return ObjectHelper.requireNonNull(converter, "converter is null").apply(this);
         } catch (Throwable ex) {

src/main/java/io/reactivex/MaybeConverter.java

@@ -25,7 +25,7 @@
 @Experimental
 public interface MaybeConverter<T, R> {
     /**
-     * Applies a function to the upstream Maybe and returns a converted value of type <R>.
+     * Applies a function to the upstream Maybe and returns a converted value of type {@code R}.
      *
      * @param upstream the upstream Maybe instance
      * @return the converted value

src/main/java/io/reactivex/Observable.java

@@ -4806,7 +4806,7 @@ public final Single<Boolean> any(Predicate<? super T> predicate) {
      * This allows fluent conversion to any other type.
      * <dl>
      *  <dt><b>Scheduler:</b></dt>
-     *  <dd>{@code to} does not operate by default on a particular {@link Scheduler}.</dd>
+     *  <dd>{@code as} does not operate by default on a particular {@link Scheduler}.</dd>
      * </dl>
      *
      * @param <R> the resulting object type
@@ -4817,7 +4817,7 @@ public final Single<Boolean> any(Predicate<? super T> predicate) {
     @Experimental
     @CheckReturnValue
     @SchedulerSupport(SchedulerSupport.NONE)
-    public final <R> R as(ObservableConverter<T, ? extends R> converter) {
+    public final <R> R as(@NonNull ObservableConverter<T, ? extends R> converter) {
         try {
             return ObjectHelper.requireNonNull(converter, "converter is null").apply(this);
         } catch (Throwable ex) {

src/main/java/io/reactivex/ObservableConverter.java

@@ -25,7 +25,7 @@
 @Experimental
 public interface ObservableConverter<T, R> {
     /**
-     * Applies a function to the upstream Observable and returns a converted value of type <R>.
+     * Applies a function to the upstream Observable and returns a converted value of type {@code R}.
      *
      * @param upstream the upstream Observable instance
      * @return the converted value

src/main/java/io/reactivex/Single.java

@@ -1528,7 +1528,7 @@ public final Single<T> ambWith(SingleSource<? extends T> other) {
      * This allows fluent conversion to any other type.
      * <dl>
      * <dt><b>Scheduler:</b></dt>
-     * <dd>{@code to} does not operate by default on a particular {@link Scheduler}.</dd>
+     * <dd>{@code as} does not operate by default on a particular {@link Scheduler}.</dd>
      * </dl>
      *
      * @param <R> the resulting object type
@@ -1539,7 +1539,7 @@ public final Single<T> ambWith(SingleSource<? extends T> other) {
     @Experimental
     @CheckReturnValue
     @SchedulerSupport(SchedulerSupport.NONE)
-    public final <R> R as(SingleConverter<T, ? extends R> converter) {
+    public final <R> R as(@NonNull SingleConverter<T, ? extends R> converter) {
         try {
             return ObjectHelper.requireNonNull(converter, "converter is null").apply(this);
         } catch (Throwable ex) {

src/main/java/io/reactivex/SingleConverter.java

@@ -16,7 +16,7 @@
 import io.reactivex.annotations.*;
 
 /**
- * Convenience interface and callback used by the {@link Single#as} operator to turn an Single into another
+ * Convenience interface and callback used by the {@link Single#as} operator to turn a Single into another
  * value fluently.
  *
  * @param <T> the upstream type
@@ -25,7 +25,7 @@
 @Experimental
 public interface SingleConverter<T, R> {
     /**
-     * Applies a function to the upstream Single and returns a converted value of type <R>.
+     * Applies a function to the upstream Single and returns a converted value of type {@code R}.
      *
      * @param upstream the upstream Single instance
      * @return the converted value