Merge pull request #11892 from sstrigler/EMQX-11294-still-many-inaccuracies

EMQX 11294 still many inaccuracies

apps/emqx_bridge/src/emqx_bridge_v2_api.erl

@@ -301,7 +301,7 @@ schema("/nodes/:node/actions/:id/:operation") ->
         'operationId' => '/nodes/:node/actions/:id/:operation',
         post => #{
             tags => [<<"actions">>],
-            summary => <<"Manually start a bridge">>,
+            summary => <<"Manually start a bridge on a given node">>,
             description => ?DESC("desc_api8"),
             parameters => [
                 param_path_node(),

apps/emqx_connector/src/emqx_connector_api.erl

@@ -288,7 +288,7 @@ schema("/nodes/:node/connectors/:id/:operation") ->
         'operationId' => '/nodes/:node/connectors/:id/:operation',
         post => #{
             tags => [<<"connectors">>],
-            summary => <<"Manually start a connector for a given node">>,
+            summary => <<"Manually start a connector on a given node">>,
             description => ?DESC("desc_api8"),
             parameters => [
                 param_path_node(),

rel/i18n/emqx_bridge_v2_api.hocon

@@ -37,20 +37,19 @@ desc_api6.label:
 """Reset Bridge Metrics"""
 
 desc_api7.desc:
-"""Stop/restart bridges on all nodes in the cluster."""
+"""Start bridge on all nodes in the cluster."""
 
 desc_api7.label:
-"""Cluster Bridge Operate"""
+"""Cluster Bridge Operation"""
 
 desc_api8.desc:
-"""Stop/restart bridges on a specific node."""
+"""Start bridge on a specific node."""
 
 desc_api8.label:
-"""Node Bridge Operate"""
+"""Node Bridge Operation"""
 
 desc_api9.desc:
-"""Test creating a new bridge by given id.</br>
-The id must be of format '{type}:{name}'."""
+"""Test creating a new bridge."""
 
 desc_api9.label:
 """Test Bridge Creation"""
@@ -62,7 +61,7 @@ desc_bridge_metrics.label:
 """Get Bridge Metrics"""
 
 desc_enable_bridge.desc:
-"""Enable or Disable bridges on all nodes in the cluster."""
+"""Enable or Disable bridge on all nodes in the cluster."""
 
 desc_enable_bridge.label:
 """Cluster Bridge Enable"""
@@ -92,13 +91,13 @@ desc_param_path_node.label:
 """The node name"""
 
 desc_param_path_operation_cluster.desc:
-"""Operations can be one of: 'start'."""
+"""Operation can be one of: 'start'."""
 
 desc_param_path_operation_cluster.label:
 """Cluster Operation"""
 
 desc_param_path_operation_on_node.desc:
-"""Operations can be one of: 'start'."""
+"""Operation can be one of: 'start'."""
 
 desc_param_path_operation_on_node.label:
 """Node Operation """

rel/i18n/emqx_connector_api.hocon

@@ -37,20 +37,19 @@ desc_api6.label:
 """Reset Connector Metrics"""
 
 desc_api7.desc:
-"""Stop/restart connectors on all nodes in the cluster."""
+"""Start connector on all nodes in the cluster."""
 
 desc_api7.label:
 """Cluster Connector Operate"""
 
 desc_api8.desc:
-"""Stop/restart connectors on a specific node."""
+"""Start connector on a specific node."""
 
 desc_api8.label:
 """Node Connector Operate"""
 
 desc_api9.desc:
-"""Test creating a new connector by given id.</br>
-The id must be of format '{type}:{name}'."""
+"""Test creating a new connector."""
 
 desc_api9.label:
 """Test Connector Creation"""
@@ -62,7 +61,7 @@ desc_connector_metrics.label:
 """Get Connector Metrics"""
 
 desc_enable_connector.desc:
-"""Enable or Disable connectors on all nodes in the cluster."""
+"""Enable or Disable connector on all nodes in the cluster."""
 
 desc_enable_connector.label:
 """Cluster Connector Enable"""
@@ -86,13 +85,13 @@ desc_param_path_node.label:
 """The node name"""
 
 desc_param_path_operation_cluster.desc:
-"""Operations can be one of: 'start' or 'stop'."""
+"""Operation can be one of: 'start'."""
 
 desc_param_path_operation_cluster.label:
 """Cluster Operation"""
 
 desc_param_path_operation_on_node.desc:
-"""Operations can be one of: 'start' or 'start'."""
+"""Operation can be one of: 'start'."""
 
 desc_param_path_operation_on_node.label:
 """Node Operation """