2.x: Observable.throttleWithTimeout is confusing

[romanzes]

The documentation for Observable.throttleWithTimeout() implies that it's different from debounce() and invites to read about the differences:

Information on debounce vs throttle:
Debounce and Throttle: visual explanation
Debouncing: javascript methods
Javascript - don't spam your server: debounce and throttle

Of these links, the first one isn't available anymore and the last two are about JS.

Looking at the method's implementation, it becomes clear that in RxJava it's not different from debounce in any way:

@CheckReturnValue
@SchedulerSupport(SchedulerSupport.COMPUTATION)
public final Observable<T> throttleWithTimeout(long timeout, TimeUnit unit) {
    return debounce(timeout, unit);
}

Do we really need both methods? If yes, could the documentation say explicitly that they are synonyms? Could these links to third-party websites be removed?

[akarnokd]

Yes, it is an alias so it can be more easily discovered along the throttle methods. debounce is a traditional ReactiveX naming and we kept it for historical reasons.

You can update the javadocs (on both Flowable and Observable if you want. PR welcome.

[romanzes]

@akarnokd thanks for the clarification. Will open a PR soon :)

[akarnokd]

Closing via #6049