lack of documentation on listNamespacedService breaking change

[gyorokpeter]

This worked in 19.0.0:

kube.listNamespacedService(namespace, null, null, null, null, labelSelector, null, null, null, null, null);

But it breaks in 20.0.0:

[ERROR]   required: java.lang.String
[ERROR]   found: java.lang.String,<nulltype>,<nulltype>,<nulltype>,<nulltype>,java.lang.String,<nulltype>,<nulltype>,<nulltype>,<nulltype>,<nulltype>
[ERROR]   reason: actual and formal argument lists differ in length

https://javadoc.io/static/io.kubernetes/client-java-api/20.0.0/io/kubernetes/client/openapi/apis/CoreV1Api.html#listNamespacedService(java.lang.String) makes no mention of this breaking change and how to migrate old code that requires any of the parameters other than the namespace.

Also the changelog file (https://github.com/kubernetes-client/java/blob/master/CHANGELOG.md) cuts off at 14.0.0 so no luck finding this breaking change there either.

[yue9944882]

@gyorokpeter the breaking change is noted here https://github.com/kubernetes-client/java?tab=readme-ov-file#release

[yue9944882]

to obtain the backward-compatible client module, adding a -legacy suffix to the version will do

[gyorokpeter]

In the meantime we found this example: https://github.com/kubernetes-client/java/blob/master/examples/examples-release-20/src/main/java/io/kubernetes/client/examples/WatchExample.java

It would still be useful to update the docs to better explain how to migrate from the old to the new style API.