[git-jxj]

Why are these changes needed?

The Python client README calls submit_job on the kuberay_job_api module, which raises AttributeError; the method belongs to RayjobApi. The example also contains an unserializable metadata placeholder, an undefined namespace, and a python -c command that tries to evaluate a filename.

Instantiate RayjobApi and provide a concrete job name, namespace, and executable entrypoint. Explain how to select an existing cluster in another namespace. Keep the example compatible with the renamed kuberay_client package.

Related issue number

N/A — correction to the existing RayJob submission example.

Labels

• If this PR has user-facing changes that require documentation updates at release time, I have added the doc-updates-required label.
• If this PR contains breaking changes, I have added the breaking-change label.

AI assistance

Yes. AI assisted with the documentation changes and testing.

Checks

• I've made sure the tests are passing.
• Testing Strategy
  • Unit tests
  • Manual tests

Manual test instructions

Executed the README snippet through the real Python client with Kubernetes server-side dry-run and validated the job body against the current RayJob CRD schema. Executed the example entrypoint locally (output: 2). Ran markdownlint 0.44.0 with the repository configuration and the applicable whitespace/file pre-commit checks. This does not run a RayJob or a Ray cluster.

[win5923]

Thanks!