fix(command-deploy): update alias description (#2872)

* docs: Updated alias description

* fix(command-deploy): update alias description

Co-authored-by: erezrokah <erezrokah@users.noreply.github.com>

docs/commands/deploy.md

@@ -88,7 +88,7 @@ netlify deploy
 - `functions` (*string*) - Specify a functions folder to deploy
 - `prod` (*boolean*) - Deploy to production
 - `prodIfUnlocked` (*boolean*) - Deploy to production if unlocked, create a draft otherwise
-- `alias` (*string*) - Specifies the alias for deployment. Useful for creating predictable deployment URLs. Maximum 37 characters.
+- `alias` (*string*) - Specifies the alias for deployment, the string at the beginning of the deploy subdomain. Useful for creating predictable deployment URLs. Avoid setting an alias string to the same value as a deployed branch. `alias` doesn’t create a branch deploy and can’t be used in conjunction with the branch subdomain feature. Maximum 37 characters.
 - `branch` (*string*) - Serves the same functionality as --alias. Deprecated and will be removed in future versions
 - `open` (*boolean*) - Open site after deploy
 - `message` (*string*) - A short message to include in the deploy log

src/commands/deploy.js

@@ -575,7 +575,7 @@ DeployCommand.flags = {
   }),
   alias: flagsLib.string({
     description:
-      'Specifies the alias for deployment. Useful for creating predictable deployment URLs. Maximum 37 characters.',
+      'Specifies the alias for deployment, the string at the beginning of the deploy subdomain. Useful for creating predictable deployment URLs. Avoid setting an alias string to the same value as a deployed branch. `alias` doesn’t create a branch deploy and can’t be used in conjunction with the branch subdomain feature. Maximum 37 characters.',
   }),
   branch: flagsLib.string({
     char: 'b',