Refactor API documentation for job submission (ray-project#32252)

doc/source/cluster/running-applications/job-submission/jobs-package-ref.rst

@@ -3,65 +3,75 @@
 Python SDK API Reference
 ========================
 
+.. currentmodule:: ray.job_submission
+
 For an overview with examples see :ref:`Ray Jobs <jobs-overview>`.
 
 For the CLI reference see :ref:`Ray Job Submission CLI Reference <ray-job-submission-cli-ref>`.
 
 .. _job-submission-client-ref:
 
 JobSubmissionClient
-~~~~~~~~~~~~~~~~~~~
-.. autosummary::
-    :nosignatures:
+-------------------
 
-    ray.job_submission.JobSubmissionClient
-    ray.job_submission.JobSubmissionClient.submit_job
-    ray.job_submission.JobSubmissionClient.stop_job
-    ray.job_submission.JobSubmissionClient.get_job_status
-    ray.job_submission.JobSubmissionClient.get_job_info
-    ray.job_submission.JobSubmissionClient.list_jobs
-    ray.job_submission.JobSubmissionClient.get_job_logs
-    ray.job_submission.JobSubmissionClient.tail_job_logs
+.. autosummary::
+   :toctree: doc/
 
-.. autoclass:: ray.job_submission.JobSubmissionClient
-    :members:
+   JobSubmissionClient
+   JobSubmissionClient.submit_job
+   JobSubmissionClient.stop_job
+   JobSubmissionClient.get_job_status
+   JobSubmissionClient.get_job_info
+   JobSubmissionClient.list_jobs
+   JobSubmissionClient.get_job_logs
+   JobSubmissionClient.tail_job_logs
 
 .. _job-status-ref:
 
 JobStatus
-~~~~~~~~~
+---------
 
-.. autoclass:: ray.job_submission.JobStatus
-    :members:
+.. autosummary::
+   :toctree: doc/
+
+   JobStatus
 
 .. _job-info-ref:
 
 JobInfo
-~~~~~~~
+-------
+
+.. autosummary::
+   :toctree: doc/
 
-.. autoclass:: ray.job_submission.JobInfo
-    :members:
+   JobInfo
 
 .. _job-details-ref:
 
 JobDetails
-~~~~~~~~~~
+----------
+
+.. autosummary::
+   :toctree: doc/
 
-.. autopydantic_model:: ray.job_submission.JobDetails
+   JobDetails
 
 .. _job-type-ref:
 
 JobType
-~~~~~~~
+-------
 
-.. autoclass:: ray.job_submission.JobType
-    :members:
-    :noindex:
+.. autosummary::
+   :toctree: doc/
+
+   JobType
 
 .. _driver-info-ref:
 
 DriverInfo
-~~~~~~~~~~
+----------
 
-.. autopydantic_model:: ray.job_submission.DriverInfo
+.. autosummary::
+   :toctree: doc/
 
+   DriverInfo