diff --git a/cmd/pipeline/convert.go b/cmd/pipeline/convert.go
index a5981b0c..184f7716 100644
--- a/cmd/pipeline/convert.go
+++ b/cmd/pipeline/convert.go
@@ -45,9 +45,9 @@ type statusResponse struct {
 
 type ConvertCmd struct {
 	File    string `help:"Path to the pipeline file to convert (required)" short:"F" required:""`
-	Vendor  string `help:"CI/CD vendor (auto-detected if not specified)" short:"v"`
+	Vendor  string `help:"CI/CD vendor (auto-detected if the file name matches vendor path and name - otherwise, needs to be specified)" short:"v"`
 	Output  string `help:"Custom path to save the converted pipeline (default: .buildkite/pipeline.<vendor>.yml)" short:"o"`
-	Timeout int    `help:"Timeout in seconds for conversion" default:"300"`
+	Timeout int    `help:"Timeout in seconds for conversion (increase for large pipelines, decrease to fail conversion on timeout)" default:"300"`
 }
 
 func (c *ConvertCmd) Help() string {
@@ -61,7 +61,7 @@ Supported vendors:
   - harness (Harness CI) (beta)
   - bitrise (Bitrise) (beta)
 
-The command will automatically detect the vendor based on the file name if not specified.
+The command will automatically detect the vendor based on the file path and name if not specified.
 
 By default, the converted pipeline is saved to .buildkite/pipeline.<vendor>.yml.
 Use the --output flag to specify a custom output path.