Some doc fixes (#383)

tanjun/annotations.py

@@ -228,7 +228,9 @@ def __init__(
  ----------
  mapping
  Either a mapping of names to the choices values or a sequence
- of `tuple[name, value]` or a sequence of string values.
+ of `tuple[name, value]` or a sequence of choice values.
+ **kwargs
+ Choice values.
  """
  if isinstance(mapping, collections.Sequence):
  mapping_ = (value if isinstance(value, tuple) else (str(value), value) for value in mapping)
@@ -344,8 +346,8 @@ def __init__(
  ) -> None:
  """Create a flag instance.
 
- Arguments
- ---------
+ Parameters
+ ----------
  aliases
  Other names the flag may be triggered by.
 
@@ -486,8 +488,8 @@ async def command(
  def __init__(self, value: typing.Union[int, float], /) -> None:
  """Create an argument maximum value.
 
- Arguments
- ---------
+ Parameters
+ ----------
  value
  The maximum allowed value allowed for an argument.
  """
@@ -547,8 +549,8 @@ async def command(
  def __init__(self, value: typing.Union[int, float], /) -> None:
  """Create an argument minimum value.
 
- Arguments
- ---------
+ Parameters
+ ----------
  value
  The minimum value allowed for an argument.
  """
@@ -592,8 +594,8 @@ def __init__(
  ) -> None:
  """Create an argument name override.
 
- Arguments
- ---------
+ Parameters
+ ----------
  both
  If provided, the name to use for this option in message and slash
  commands.
@@ -677,8 +679,8 @@ async def command(
  def __init__(self, min_value: typing.Union[int, float], max_value: typing.Union[int, Float], /) -> None:
  """Create an argument range limit.
 
- Arguments
- ---------
+ Parameters
+ ----------
  min_value
  The minimum allowed value for this argument.
  max_value
@@ -783,8 +785,8 @@ async def command(
  def __init__(self, *, parse_id: collections.Callable[[str], hikari.Snowflake] = conversion.parse_snowflake) -> None:
  """Create a snowflake or argument marker.
 
- Arguments
- ---------
+ Parameters
+ ----------
  parse_id
  The function used to parse the argument's ID.
 
@@ -842,8 +844,8 @@ def __init__(
  ) -> None:
  """Create a slash command argument channel restraint.
 
- Arguments
- ---------
+ Parameters
+ ----------
  channel_type
  A channel type to restrain this argument by.
  *other_types
@@ -1174,13 +1176,13 @@ def with_annotated_args(
  * [tanjun.annotations.Bool][]
  * [tanjun.annotations.Channel][]
  * [tanjun.annotations.Color][]/[tanjun.annotations.Colour][]
- * [tanjun.annotations.Datetime]
+ * [tanjun.annotations.Datetime][]
  * [tanjun.annotations.Float][]
  * [tanjun.annotations.Int][]
  * [tanjun.annotations.Member][]
  * [tanjun.annotations.Mentionable][]
  * [tanjun.annotations.Role][]
- * [tanjun.annotations.Snowflake]
+ * [tanjun.annotations.Snowflake][]
  * [tanjun.annotations.Str][]
  * [tanjun.annotations.User][]