Apply suggestions from code review

Co-authored-by: Dorukyum <[email protected]>
Co-authored-by: JustaSqu1d <[email protected]>
Signed-off-by: Lala Sabathil <[email protected]>

Author: 3 people

CHANGELOG.md

@@ -24,7 +24,7 @@ These changes are available on the `master` branch, but have not yet been releas
   ([#2421](https://github.com/Pycord-Development/pycord/pull/2421))
 - Added `member` data to the `raw_reaction_remove` event.
   ([#2412](https://github.com/Pycord-Development/pycord/pull/2412))
-- Added `positional` argument to `commands.Flag`
+- Added `positional` argument to `commands.Flag`.
   ([#2443](https://github.com/Pycord-Development/pycord/pull/2443))
 
 ### Fixed

discord/ext/commands/flags.py

@@ -83,7 +83,8 @@ class Flag:
         The maximum number of arguments the flag can accept.
         A negative value indicates an unlimited amount of arguments.
     positional: :class:`bool`
-        Whether the flag is positional or not. There can only be one positional flag.
+        Whether the flag is positional.
+        A :class:`FlagConverter` can only handle one positional flag.
     override: :class:`bool`
         Whether multiple given values overrides the previous value.
     """

docs/ext/commands/commands.rst

@@ -656,7 +656,7 @@ This tells the parser that the ``members`` attribute is mapped to a flag named `
 the default value is an empty list. For greater customisability, the default can either be a value or a callable
 that takes the :class:`~ext.commands.Context` as a sole parameter. This callable can either be a function or a coroutine.
 
-Flags can also have one of its flags be marked as positional. This means that the flag does not require a corresponding
+Flags can also be positional. This means that the flag does not require a corresponding
 value to be passed in by the user. This is useful for flags that are either optional or have a default value.
 For example, in the following code:
 
@@ -667,7 +667,7 @@ For example, in the following code:
         reason: str = commands.flag(default='no reason')
         days: int = commands.flag(default=1)
 
-The ``members`` flag is marked as positional, meaning that the user can invoke the command without specifying the flag
+The ``members`` flag is marked as positional, meaning that the user can invoke the command without explicitly specifying the flag.
 
 In order to customise the flag syntax we also have a few options that can be passed to the class parameter list: