Doc: Update documentation for get_best_claim methods

- add version strings
- add references notes
- update ROADMAP.rst

Change-Id: I91d37d637e621cb817174a73eb5bbf44dc7f6a67

Author: xqt

ROADMAP.rst

@@ -1,7 +1,10 @@
 Current Release Changes
 =======================
 
-* (no changes yet)
+* Implement :meth:`pywikibot.ItemPage.get_best_claim` (:phab:`T400610`)
+* Add *expiry* parameter to :meth:`BasePage.watch()<page.BasePage.watch>` and
+  :meth:`Site.watch()<pywikibot.site._apisite.APISite.watch>` (:phab:`T330839`)
+
 
 Deprecations
 ============

pywikibot/page/_page.py

@@ -182,18 +182,20 @@ def set_redirect_target(
         if save:
             self.save(**kwargs)
 
-    def get_best_claim(self, prop: str):
+    def get_best_claim(self, prop: str) -> pywikibot.Claim | None:
         """Return the first best Claim for this page.
 
         Return the first 'preferred' ranked Claim specified by Wikibase
         property or the first 'normal' one otherwise.
 
         .. versionadded:: 3.0
 
-        :param prop: property id, "P###"
+        .. seealso:: :meth:`pywikibot.ItemPage.get_best_claim`
+
+        :param prop: Wikibase property ID, must be of the form ``P``
+            followed by one or more digits (e.g. ``P31``).
         :return: Claim object given by Wikibase property number
             for this page object.
-        :rtype: pywikibot.Claim or None
 
         :raises UnknownExtensionError: site has no Wikibase extension
         """

pywikibot/page/_wikibase.py

@@ -1341,16 +1341,20 @@ def isRedirectPage(self):
             return self._isredir
         return super().isRedirectPage()
 
-    def get_best_claim(self, prop: str):
+    def get_best_claim(self, prop: str) -> pywikibot.Claim | None:
         """Return the first best Claim for this page.
 
         Return the first 'preferred' ranked Claim specified by Wikibase
         property or the first 'normal' one otherwise.
 
-        :param prop: property id, "P###"
+        .. versionadded:: 10.4
+
+        .. seealso:: :meth:`pywikibot.Page.get_best_claim`
+
+        :param prop:  Wikibase property ID, must be of the form ``P``
+            followed by one or more digits (e.g. ``P31``).
         :return: Claim object given by Wikibase property number
             for this page object.
-        :rtype: pywikibot.Claim or None
 
         :raises UnknownExtensionError: site has no Wikibase extension
         """