content: command name

Add pages:

* command custom name
* command alias

Author: reka

docs/command-alias.md

@@ -0,0 +1,49 @@
+---
+tags:
+- command
+- naming
+---
+
+## Overview
+
+Typer doesn't support multiple aliases for the same command.
+
+You can define an alias in Python by:
+
+* Calling one command function from the other.
+* Calling the same private function from both commands.
+
+## Two Commands Calling the Same Function
+
+Create 2 commands `pycon` and `display-pycon` executing the same function:
+
+```python
+@app.command()
+def display_pycon():
+    _print_pycon()
+
+
+@app.command()
+def pycon():
+    _print_pycon()
+
+
+def _print_pycon():
+    Console().print("PyCon!")
+```
+
+If the aliased command also has options, consider using the [re-use options](re-using-options.md) pattern.
+
+## CLIG Recommendation on Command Aliases
+
+> Don’t allow arbitrary abbreviations of subcommands. For example, say your command has an install subcommand. When you added it, you wanted to save users some typing, so you allowed them to type any non-ambiguous prefix, like mycmd ins, or even just mycmd i, and have it be an alias for mycmd install. Now you’re stuck: you can’t add any more commands beginning with i, because there are scripts out there that assume i means install.
+
+> There’s nothing wrong with aliases—saving on typing is good—but they should be explicit and remain stable.
+
+[CLIG Guidelines / Future-proofing](https://clig.dev/#future-proofing)
+
+## More Info
+
+* [CLIG Guidelines / Naming](https://clig.dev/#naming)
+* [CLIG Guidelines / Subcommands](https://clig.dev/#subcommands)
+* [CLIG Guidelines / Future-proofing](https://clig.dev/#future-proofing)

docs/command-custom-name.md

@@ -0,0 +1,28 @@
+---
+tags:
+- command
+- naming
+---
+
+## Overview
+
+By default, Typer creates a command with the same name as the function.
+
+* If the function name contains an `_` => It wil be replaced with `-`.
+* You can define a custom command name in the 1st argument of the `@app.command()` decorator.
+
+## Custom Command Name
+
+Define a command named `list` using the function `list_items`.
+
+```python
+@app.command("list")
+def list_items():
+```
+
+This pattern is useful if your command name is the name of a Python built-in function (like `list`) or a Python standard library module (like `os`).
+
+## More Info
+
+* [Typer / Custom Command Name](https://typer.tiangolo.com/tutorial/commands/name/)
+* [CLIG Guidelines / Naming](https://clig.dev/#naming)

docs/option-with-aliases.md

@@ -1,6 +1,7 @@
 ---
 tags:
 - option
+- naming
 ---
 
 ## Overview

docs/re-using-options.md

@@ -2,6 +2,7 @@
 tags: 
 - consistency
 - option
+- naming
 title: Re-using Typer Options
 ---