Add Deprecation notice to encoded connections

[Jarema]

Overview

As encoded connections are not properly working in many cases, and we always steer users away from them, we should mark them as deprecated in client API and docs.

Clients and Tools

• Go @piotrpio - Deprecate encoded connections nats.go#1674
• Java @scottf
• JavaScript @aricart
• .Net @scottf
• C @levb
• Python @caspervonb
• Ruby @wallyqs
• Rust @Jarema
• .Net V2 @mtmk

Other Tasks

• docs.nats.io updated @bruth
• Update ADR to Implemented
• Update client features spreadsheet

Client authors please update with your progress. If you open issues in your own repositories as a result of this request, please link them to this one by pasting the issue URL in a comment or main issue description.

[aricart]

JavaScript doesn't implement encoded connections.

[Jarema]

Rust client also does not implement encoded connectionts.

[scottf]

Java does not implement encoded connections. .NET V1 does.

[Tochemey]

Ok please what is the best option for those of us who have been using it. Is there any migration doc?

[Jarema]

@Tochemey We are working on typed pub/sub/kv semantics in clients right now.
Until then, manual serialize/deserialize of the payload is the way to go.

[artooro]

@Jarema do you have a link to the issue for the typed pub/sub/kv semantics? I've been using encoded connections for awhile and was surprised to see the deprecated notice after updating the Go package. Curious what these new typed semantics looks like and whether I should wait to get off of encoded conn until typed semantics is ready.