[docs] Fix Deprecated annotation indentation

[krfricke]

Signed-off-by: Kai Fricke kai@anyscale.com

Why are these changes needed?

Our Documentation build job currently returns errors like this:

/ray/python/ray/air/checkpoint.py:docstring of ray.air.checkpoint.Checkpoint.from_object_ref:9: WARNING: Content block expected for the "warning" directive; none found.

The reason for this is the Deprecated annotation that adds a warning block to the __doc__ property to be rendered in our documentation.

The code is faulty: A misplaced newline character in the DEPRECATED message block removes the proper indentation:

        Returns:
            If called by a driver, this returns the job ID. If called in
            a task, return the job ID of the associated driver.

        .. warning::
            
    DEPRECATED: This API is deprecated and may be removed in future Ray releases.
Use get_job_id() instead

Additionally, newline characters in the deprecation message are also not indented correctly:

        Returns:
            If called by a driver, this returns the job ID. If called in
            a task, return the job ID of the associated driver.

        .. warning::

            DEPRECATED: This API is deprecated and may be removed in future Ray releases.
Use get_job_id() instead

This PR fixes both problems:

        Returns:
            If called by a driver, this returns the job ID. If called in
            a task, return the job ID of the associated driver.

        .. warning::

            DEPRECATED: This API is deprecated and may be removed in future Ray releases.
            Use get_job_id() instead
        

Related issue number

Checks

• I've signed off every commit(by using the -s flag, i.e., git commit -s) in this PR.
• I've run scripts/format.sh to lint the changes in this PR.
• I've included any doc changes needed for https://docs.ray.io/en/master/.
• I've made sure the tests are passing. Note that there might be a few flaky tests, see the recent failures at https://flakey-tests.ray.io/
• Testing Strategy
  • Unit tests
  • Release tests
  • This PR is not tested :(