Changes that affect compatibility of Ballerina APIs

[sameerajayasoma]

We need to produce a document similar to the following with the Swan Lake release.

https://docs.microsoft.com/en-us/dotnet/core/compatibility/