diff --git a/doc/vs.md b/doc/vs.md index 05e203f8..d9ab1ff9 100644 --- a/doc/vs.md +++ b/doc/vs.md @@ -10,6 +10,10 @@ When building a Visual Studio extension, you should not include StreamJsonRpc in | VS 2017.3 | 1.1.x | VS 2017.5 | 1.2.x | VS 2017.6 | 1.3.x -| TBD | 1.4.x +| VS 2019.0 | 1.5.x +| VS 2019.1 | 1.5.x, 2.0.x StreamJsonRpc versions are forwards and backwards compatible "over the wire". For example it is perfectly legitimate to use StreamJsonRpc 1.4 on the server-side even if the client only uses 1.0, or vice versa. + +StreamJsonRpc is binary compatible within a major version. If you compile against 1.3 for targeting VS 2017.6, you'll successfully run against the StreamJsonRpc 1.5 version when installed in a later version of Visual Studio. +StreamJsonRpc 2.0 introduced breaking changes, so folks who compile against 1.x will continue to run on 1.x, while folks who want the additional functionality of 2.0 may recompile against that and work in VS 2019.1 and later.