Update docstrings

Author: thewhaleking

bittensor_cli/cli.py

@@ -5810,11 +5810,18 @@ def subnets_set_symbol(
         symbol: str = typer.Argument(help="The symbol to set for your subnet."),
     ):
         """
-        Allows the user to update their subnet symbol.
+        Allows the user to update their subnet symbol to a different available symbol. The full list of available symbols can be found here:
+        [#8CB9E9]https://github.com/opentensor/subtensor/blob/main/pallets/subtensor/src/subnets/symbols.rs#L8[/#8CB9E9]
+
 
         EXAMPLE
 
-        [green]$[/green] btcli subnets set-symbol --netuid 1 シ
+        [green]$[/green] btcli subnets set-symbol [dark_orange]--netuid 1 シ[/dark_orange]
+
+
+        JSON OUTPUT:
+        If --json-output is used, the output will be in the following schema:
+        [#AFEFFF]{success: [dark_orange]bool[/dark_orange], message: [dark_orange]str[/dark_orange]}[/#AFEFFF]
         """
         self.verbosity_handler(quiet, verbose, json_output)
         if len(symbol) > 1:

bittensor_cli/src/commands/subnets/subnets.py

@@ -2458,7 +2458,12 @@ async def set_symbol(
     prompt: bool = False,
     json_output: bool = False,
 ) -> bool:
-    """Set a subtensor's symbol"""
+    """
+    Set a subtensor's symbol, given the netuid and symbol.
+
+    The symbol must be a symbol that subtensor recognizes as available
+    (defined in https://github.com/opentensor/subtensor/blob/main/pallets/subtensor/src/subnets/symbols.rs#L8)
+    """
     if not await subtensor.subnet_exists(netuid):
         err = f"Subnet {netuid} does not exist."
         if json_output: