docs: enhance CLI help text and examples

- Clarify project assignment supports both names and IDs
- Improve label filtering help text for multi-team functionality
- Add better examples showcasing new project assignment features
- Enhance project creation help with clearer team association description
- Add more comprehensive usage examples for all new commands

Author: AdiKsOnDev

src/linear_cli/cli/commands/issue.py

@@ -133,7 +133,7 @@ async def fetch_issues() -> dict[str, Any]:
     help="Issue priority (0=None, 1=Low, 2=Normal, 3=High, 4=Urgent)",
 )
 @click.option("--labels", "-L", help="Label names (comma-separated)")
-@click.option("--project", help="Project name or ID to assign the issue to")
+@click.option("--project", help="Project name or ID to assign the issue to (supports both names and IDs)")
 @click.pass_context
 def create(
     ctx: click.Context,
@@ -157,6 +157,7 @@ def create(
         linear-cli issue create "Bug fix" --team ENG --assignee jane@example.com --priority 3
         linear-cli issue create "Enhancement" --labels "feature,ui" --description "Improve UX"
         linear-cli issue create "Database migration" --project "Q4 Backend Work" --team ENG
+        linear-cli issue create "API refactor" --project "Backend Improvements" --priority 2
     """
     cli_ctx = ctx.obj["cli_context"]
     client = cli_ctx.get_client()
@@ -328,7 +329,7 @@ async def fetch_issue() -> dict[str, Any] | None:
     help="New issue priority (0=None, 1=Low, 2=Normal, 3=High, 4=Urgent)",
 )
 @click.option("--labels", "-L", help="New labels (comma-separated, replaces existing)")
-@click.option("--project", help="Project name or ID to assign the issue to")
+@click.option("--project", help="Project name or ID to assign the issue to (supports both names and IDs)")
 @click.pass_context
 def update(
     ctx: click.Context,
@@ -353,6 +354,7 @@ def update(
         linear-cli issue update ENG-123 --priority 4 --labels "bug,critical"
         linear-cli issue update ENG-123 --description "Updated description"
         linear-cli issue update ENG-123 --project "Backend Improvements"
+        linear-cli issue update ENG-123 --project "Q4 Sprint" --priority 3
     """
     cli_ctx = ctx.obj["cli_context"]
     client = cli_ctx.get_client()

src/linear_cli/cli/commands/label.py

@@ -32,9 +32,9 @@ def label_group() -> None:
     "--team",
     "-t",
     multiple=True,
-    help="Team key or ID to filter by (can be used multiple times)",
+    help="Team key or ID to filter by (can be used multiple times for specific teams)",
 )
-@click.option("--all-teams", is_flag=True, help="Show labels from all accessible teams")
+@click.option("--all-teams", is_flag=True, help="Show labels from all accessible teams at once")
 @click.option(
     "--limit",
     "-l",
@@ -55,9 +55,10 @@ def list(
 
     Examples:
         linear-cli label list                           # Labels from default team
-        linear-cli label list --team ENG                # Labels from ENG team
-        linear-cli label list --team ENG --team QA      # Labels from ENG and QA teams
+        linear-cli label list --team ENG                # Labels from ENG team only
+        linear-cli label list --team ENG --team QA      # Labels from both ENG and QA teams
         linear-cli label list --all-teams               # Labels from all accessible teams
+        linear-cli label list --all-teams --limit 50    # Limit labels per team
     """
     cli_ctx = ctx.obj["cli_context"]
     client = cli_ctx.get_client()

src/linear_cli/cli/commands/project.py

@@ -144,9 +144,9 @@ async def create_update() -> dict[str, Any]:
 @click.argument("name")
 @click.option("--description", "-d", help="Project description")
 @click.option(
-    "--team", "-t", multiple=True, help="Team key or ID (can be used multiple times)"
+    "--team", "-t", multiple=True, help="Team key or ID to associate with project (can be used multiple times)"
 )
-@click.option("--lead", help="Project lead email or ID")
+@click.option("--lead", help="Project lead email or ID (user who manages the project)")
 @click.option(
     "--state",
     type=click.Choice(["planned", "started", "paused", "completed", "canceled"]),
@@ -177,6 +177,7 @@ def create(
         linear project create "Feature X" --description "New feature development"
         linear project create "Bug Fixes" --team ENG --team QA --lead john@example.com
         linear project create "Q4 Initiative" --state started --target-date 2024-12-31
+        linear project create "Mobile App" --team ENG --team DESIGN --description "iOS/Android app"
     """
     cli_ctx = ctx.obj["cli_context"]
     client = cli_ctx.get_client()