Issue #570/#729 Update CHANGELOG.md and update doc test

Author: soxofaan

CHANGELOG.md

@@ -14,7 +14,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 
 - `DataCube.save_result()` (and related methods) now return a `SaveResult`/`StacResource` object instead of another `DataCube` object to be more in line with the official `save_result` specification ([#402](https://github.com/Open-EO/openeo-python-client/issues/402), [#720](https://github.com/Open-EO/openeo-python-client/issues/720))
-- Deprecate `BatchJob.run_synchronous` in favor of `BatchJob.start_and_wait` and `BatchJob.download_result`
+- Deprecate `BatchJob.run_synchronous` in favor of `BatchJob.start_and_wait` ([#570](https://github.com/Open-EO/openeo-python-client/issues/570)).
 
 ### Removed
 

openeo/rest/job.py

@@ -273,6 +273,8 @@ def start_and_wait(
         :param soft_error_max: maximum number of soft errors (e.g. temporary connection glitches) to allow
         :param show_error_logs: whether to automatically print error logs when the batch job failed.
 
+        :return: Handle to the job created at the backend.
+
         .. versionchanged:: 0.37.0
             Added argument ``show_error_logs``.
         """

tests/internal/test_documentation.py

@@ -55,7 +55,7 @@ def test_extract_main_description():
         (DataCube.download, DataCube.execute_batch),
         (DataCube.create_job, DataCube.execute_batch),
         # DataCube vs BatchJob
-        # (BatchJob.run_synchronous, DataCube.execute_batch),
+        (BatchJob.start_and_wait, DataCube.execute_batch),
         # DataCube vs VectorCube
         (DataCube.download, VectorCube.download),
         (DataCube.create_job, VectorCube.create_job),