fix: deprecate description to version_description

[nunoferna]

Fixes #1284

Description

• Deprecates the Python client description parameter in favor of version_description when registering models / HF models.
• Preserves backwards compatibility: if description is provided, a DeprecationWarning is emitted and the value is used as version_description when the new parameter is not set.
• Updates Python client tests and async-upload job tests/integration tests to use version_description.
• Updates documentation/examples to use version_description instead of description.

How Has This Been Tested?

Python client unit tests: cd clients/python && make test-e2e-run

Merge criteria:

• All the commits have been signed-off (To pass the DCO check)

• The commits have meaningful messages
• Automated tests are provided as part of the PR for major new functionalities; testing instructions have been added in the PR body (for PRs involving changes that are not immediately obvious).
• The developer has manually tested the changes and verified that the changes work.
• Code changes follow the kubeflow contribution guidelines.
• For first time contributors: Please reach out to the Reviewers to ensure all tests are being run, ensuring the label ok-to-test has been added to the PR.

If you have UI changes

• The developer has added tests or explained why testing cannot be added.
• Included any necessary screenshots or gifs if it was a UI change.
• Verify that UI/UX changes conform the UX guidelines for Kubeflow.

[pboyd]

/ok-to-test

[jonburdo]

/test

[google-oss-prow]

@jonburdo: No presubmit jobs available for kubeflow/model-registry@main

Details

In response to this:

/test

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

[nunoferna]

/test ?

[google-oss-prow]

@nunoferna: No presubmit jobs available for kubeflow/model-registry@main

Details

In response to this:

/test ?

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

[jonburdo]

@tarilabs @Al-Pragliola We may need one of you to approve the test runs

[jonburdo]

Just a couple small things to fix. Otherwise this looks great!

I'm hoping we can get the tests approved to run soon :)
I did try this out locally and ran the tests myself though, and it works as expected.

[tarilabs]

/ok-to-test

[jonburdo]

/retest

[jonburdo]

/ok-to-test

[jonburdo]

We're getting close!

The async-job test failure happens because we are installing a release of model-registry python client rather than using the current state of the repo. I think the best thing to do for now is to treat it as a separate component and revert those changes for now. We can update it later after a release of the python client.

Something like:

git fetch upstream
git restore jobs/async-upload/ --source=upstream/main

[tarilabs]

• #2007 (review)

thank you very much @nunoferna for your contributions
and for @jonburdo for the guidance
great teamwork!

/lgtm
/approve

[google-oss-prow]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: tarilabs

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details

Needs approval from an approver in each of these files:

• OWNERS [tarilabs]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment