Improve some comments

bidict/_base.py

@@ -28,7 +28,7 @@
 from ._typing import KT, VT, MISSING, OKT, OVT, IterItems, MapOrIterItems
 
 
-# Disable some pyright strict diagnostics that are not helpful in this file:
+# Disable pyright strict diagnostics causing many false positives or that are just not helpful in this file:
 # pyright: reportPrivateUsage=false, reportUnknownArgumentType=false, reportUnknownMemberType=false, reportUnknownVariableType=false, reportUnnecessaryIsInstance=false
 
 
@@ -162,6 +162,9 @@ def __init__(self, *args: MapOrIterItems[KT, VT], **kw: VT) -> None:
         if args or kw:
             self._update(get_arg(*args), kw, rbof=False)
 
+    # If Python ever adds support for higher-kinded types, `inverse` could use them, e.g.
+    #     def inverse(self: BT[KT, VT]) -> BT[VT, KT]:
+    # Ref: https://github.com/python/typing/issues/548#issuecomment-621571821
     @property
     def inverse(self) -> 'BidictBase[VT, KT]':
         """The inverse of this bidirectional mapping instance."""
@@ -492,7 +495,7 @@ def _init_from(self, other: MapOrIterItems[KT, VT]) -> None:
         # If other is a bidict, use its existing backing inverse mapping, otherwise
         # other could be a generator that's now exhausted, so invert self._fwdm on the fly.
         inv = other.inverse if isinstance(other, BidictBase) else inverted(self._fwdm)
-        self._invm.update(inv)  # pyright: ignore
+        self._invm.update(inv)  # pyright: ignore  # https://github.com/jab/bidict/pull/242#discussion_r824223403
 
     #: Used for the copy protocol.
     #: *See also* the :mod:`copy` module

bidict/_bidict.py

@@ -135,7 +135,7 @@ def popitem(self) -> t.Tuple[KT, VT]:
         del self._invm[val]
         return key, val
 
-    @t.overload  # type: ignore [override]
+    @t.overload  # type: ignore [override]  # https://github.com/jab/bidict/pull/242#discussion_r825464731
     def update(self, __m: t.Mapping[KT, VT], **kw: VT) -> None: ...
     @t.overload
     def update(self, __i: IterItems[KT, VT], **kw: VT) -> None: ...