Subject docs depend on deprecated operator

[skelly-energid]

Describe the bug

The Subject docs https://rxjs.dev/guide/subject explain multicasting with reference to a deprecated multicast operator. That operator seems to be deprecated. The explanation should refer to something not deprecated instead (if the new API works the same way "under the hood").

Expected behavior

Clear docs that reference relevant further material.

Reproduction code

No response

Reproduction URL

No response

Version

latest

Environment

No response

Additional context

No response

[kwonoj]

multicast will be deprecated, not already deprecated.

rxjs/src/operators/index.ts

Line 58 in 9db6563

export { multicast } from '../internal/operators/multicast';

[skelly-energid]

The documentation clearly carries a "DEPRECATED" label : https://rxjs.dev/api/index/function/multicast

Also, this first thing the documentation says is that it will be removed in an upcoming version.

Surely that means newcomers should not use it. Why direct newcomers to it as a comparison if they should not use it?