fix web docs mainly

Author: alexei-led

lib/interface/cli/commands/trigger/create.cmd.js

@@ -8,20 +8,20 @@ const command = new Command({
     aliases: ['t'],
     parent: createRoot,
     cliDocs: {
-        description: 'Add pipeline/s to the existing or new trigger (will be created automatically)',
+        description: 'Set pipeline(s) trigger: connect the `trigger-event` to the pipeline(s). *Note:* `trigger-event` exists only if there is at least one connected pipeline.',
     },
     webDocs: {
-        category: 'Trigger',
-        title: 'add specified pipeline/s to the existing or new trigger',
+        category: 'Triggers',
+        title: 'Set Pipeline Trigger',
     },
     builder: (yargs) => {
         return yargs
             .positional('event-uri', {
-                describe: 'trigger event URI (as defined by trigger type/kind)',
+                describe: '`trigger-event` URI (as defined by trigger `type[/kind]`)',
                 require: true,
             })
             .positional('pipeline', {
-                describe: 'pipeline(s) to be triggered by specified trigger event',
+                describe: 'pipeline(s) to be triggered by the specified `trigger-event`',
                 require: true,
             });
     },

lib/interface/cli/commands/trigger/delete.cmd.js

@@ -10,16 +10,16 @@ const command = new Command({
     aliases: ['t'],
     parent: deleteRoot,
     cliDocs: {
-        description: 'Remove trigger from specified pipeline, this may also remove trigger event w/out pipelines too.',
+        description: 'Remove pipeline trigger. *Note:* this may also remove `trigger-event` definition, if there are no pipelines left, that are connected to it.',
     },
     webDocs: {
         category: 'Triggers',
-        title: 'Remove trigger from specified pipeline',
+        title: 'Remove Pipeline Trigger',
     },
     builder: (yargs) => {
         return yargs
             .positional('event-uri', {
-                describe: 'trigger event URI',
+                describe: '`trigger-event` URI (as defined by trigger `type[/kind]`)',
                 required: true,
             })
             .positional('pipeline', {

lib/interface/cli/commands/trigger/event/get.cmd.js

@@ -10,16 +10,16 @@ const command = new Command({
     aliases: ['te', 'event'],
     parent: getRoot,
     cliDocs: {
-        description: 'Get detailed information about specified trigger event',
+        description: 'Get detailed information about specified `trigger-event`',
     },
     webDocs: {
         category: 'Triggers',
-        title: 'Get detailed information about trigger event',
+        title: 'Get Trigger Event',
     },
     builder: (yargs) => {
         return yargs
             .positional('event-uri', {
-                describe: 'trigger event uri (as defined by trigger type/kind)',
+                describe: '`trigger-event` uri (as defined by trigger `type[/kind]`)',
                 require: true,
             });
     },

lib/interface/cli/commands/trigger/get.cmd.js

@@ -10,11 +10,11 @@ const command = new Command({
     aliases: ['t'],
     parent: getRoot,
     cliDocs: {
-        description: 'Get triggers connected to the specified pipeline',
+        description: 'Get pipeline triggers',
     },
     webDocs: {
         category: 'Triggers',
-        title: 'Get triggers connected to the specified pipeline',
+        title: 'Get Pipeline Triggers',
     },
     builder: (yargs) => {
         return yargs

lib/interface/cli/commands/trigger/type/get.cmd.js

@@ -10,19 +10,19 @@ const command = new Command({
     aliases: ['tt'],
     parent: getRoot,
     cliDocs: {
-        description: 'Get list of trigger types or individual trigger installed in Codefresh environment',
+        description: 'Get a list of system-wide available `trigger-types` or specified `trigger-type`',
     },
     webDocs: {
         category: 'Triggers',
-        title: 'Get available trigger type/s',
+        title: 'Get Trigger Types',
     },
     builder: (yargs) => {
         return yargs
             .positional('type', {
-                describe: '[optional] trigger type (e.g. registry, cron)',
+                describe: '`trigger-type` type name (e.g. `registry`, `cron`)',
             })
             .positional('kind', {
-                describe: '[optional] trigger kind (e.g. dockerhub, cfcr, gcr, acr)',
+                describe: '`trigger-type` kind (e.g. `dockerhub`, `cfcr`, `gcr`, `acr`); only some `trigger-types` may have kinds',
             });
     },
     handler: async (argv) => {