Ignore Raises sections without explicit raise statements

These are either specifying what sub-classes of a base class could do,
or are specifying exceptions that are raised indirectly.

Signed-off-by: Leandro Lucarella <[email protected]>

Author: llucax

src/frequenz/channels/_base_classes.py

@@ -194,7 +194,9 @@ async def ready(self) -> bool:
         """
         return await self._recv.ready()  # pylint: disable=protected-access
 
-    def consume(self) -> U:
+    # We need a noqa here because the docs have a Raises section but the code doesn't
+    # explicitly raise anything.
+    def consume(self) -> U:  # noqa: DOC502
         """Return a transformed value once `ready()` is complete.
 
         Returns:

src/frequenz/channels/util/_timer.py

@@ -482,8 +482,10 @@ def __init__(
         if auto_start:
             self.reset(start_delay=start_delay)
 
+    # We need a noqa here because the docs have a Raises section but the documented
+    # exceptions are raised indirectly.
     @classmethod
-    def timeout(
+    def timeout(  # noqa: DOC502
         cls,
         delay: timedelta,
         /,
@@ -530,8 +532,10 @@ def timeout(
             loop=loop,
         )
 
+    # We need a noqa here because the docs have a Raises section but the documented
+    # exceptions are raised indirectly.
     @classmethod
-    def periodic(
+    def periodic(  # noqa: DOC502
         cls,
         period: timedelta,
         /,
@@ -661,7 +665,9 @@ def stop(self) -> None:
         # We need to make sure it's not None, otherwise `ready()` will start it
         self._next_tick_time = self._now()
 
-    async def ready(self) -> bool:
+    # We need a noqa here because the docs have a Raises section but the documented
+    # exceptions are raised indirectly.
+    async def ready(self) -> bool:  # noqa: DOC502
         """Wait until the timer `interval` passed.
 
         Once a call to `ready()` has finished, the resulting tick information