refactor(race): deprecate race operator in favor of static race (#3611)

* refactor(race): deprecate race operator in favor of static race

deprecate race operator in favor of static race, similar to other deprecated operators concat,
merge, etc

#3603

* refactor(race): keep original documentation and mark as deprecated

src/internal/operators/race.ts

@@ -4,9 +4,13 @@ import { MonoTypeOperatorFunction, OperatorFunction } from '../types';
 import { race as raceStatic } from '../observable/race';
 
 /* tslint:disable:max-line-length */
+/** @deprecated Deprecated in favor of static race. */
 export function race<T>(observables: Array<Observable<T>>): MonoTypeOperatorFunction<T>;
+/** @deprecated Deprecated in favor of static race. */
 export function race<T, R>(observables: Array<Observable<T>>): OperatorFunction<T, R>;
+/** @deprecated Deprecated in favor of static race. */
 export function race<T>(...observables: Array<Observable<T> | Array<Observable<T>>>): MonoTypeOperatorFunction<T>;
+/** @deprecated Deprecated in favor of static race. */
 export function race<T, R>(...observables: Array<Observable<any> | Array<Observable<any>>>): OperatorFunction<T, R>;
 /* tslint:enable:max-line-length */
 
@@ -17,6 +21,7 @@ export function race<T, R>(...observables: Array<Observable<any> | Array<Observa
  * @return {Observable} An Observable that mirrors the output of the first Observable to emit an item.
  * @method race
  * @owner Observable
+ * @deprecated Deprecated in favor of static race.
  */
 export function race<T>(...observables: Array<Observable<T> | Array<Observable<T>>>): MonoTypeOperatorFunction<T> {
   return function raceOperatorFunction(source: Observable<T>) {