docs: add links to the GitLab API docs

JohnVillalovos · JohnVillalovos · commit fa56b99925fd · 2021-11-05T22:50:34.000-07:00
Add links to the GitLab API docs for merge_requests.py as it contains
code which spans two different API documentation pages.
diff --git a/gitlab/v4/objects/merge_requests.py b/gitlab/v4/objects/merge_requests.py
@@ -1,3 +1,9 @@
+"""
+GitLab API:
+https://docs.gitlab.com/ee/api/merge_requests.html
+https://docs.gitlab.com/ee/api/merge_request_approvals.html
+"""
+import gitlab
 from gitlab import cli
 from gitlab import exceptions as exc
 from gitlab import types
@@ -253,6 +259,8 @@ def approve(self, sha=None, **kwargs):
         Raises:
             GitlabAuthenticationError: If authentication is not correct
             GitlabMRApprovalError: If the approval failed
+
+        https://docs.gitlab.com/ee/api/merge_request_approvals.html#approve-merge-request
         """
         path = f"{self.manager.path}/{self.get_id()}/approve"
         data = {}
@@ -273,6 +281,8 @@ def unapprove(self, **kwargs):
         Raises:
             GitlabAuthenticationError: If authentication is not correct
             GitlabMRApprovalError: If the unapproval failed
+
+        https://docs.gitlab.com/ee/api/merge_request_approvals.html#unapprove-merge-request
         """
         path = f"{self.manager.path}/{self.get_id()}/unapprove"
         data = {}
