add token scope requirements to Reactable.add/remove_reaction

also a warning about remove_reaction raising FORBIDDEN for fun

github/interfaces/reactable.py

@@ -166,6 +166,13 @@ async def add_reaction(
 
         Adds a reaction to the reactable.
 
+        .. note::
+
+            This mutation requires the following token scopes:
+
+            - ``public_repo`` (on a :class:`~github.RepositoryNode`)
+            - ``write:discussions`` (on a :class:`~github.TeamDiscussion` or a :class:`~github.TeamDiscussionComment`)
+
 
         .. note::
 
@@ -206,6 +213,20 @@ async def remove_reaction(
 
         Removes a reaction from the reactable.
 
+        .. note::
+
+            This mutation requires the following token scopes:
+
+            - ``public_repo`` (on a :class:`~github.RepositoryNode`)
+            - ``write:discussions`` (on a :class:`~github.TeamDiscussion` or a :class:`~github.TeamDiscussionComment`)
+
+
+        .. warning::
+
+            For reasons beyond my comprehension, this mutation will
+            raise FORBIDDEN when the reaction you attempt to remove
+            does not exist, despite having the required permission.
+
 
         .. note::