Merge branch 'refactor/secondary_console_usb_serial_improvement' into 'master'

refactor(console): Warn if secondary console is active

Closes IDFGH-10484

See merge request espressif/esp-idf!24494

docs/en/api-reference/system/console.rst

@@ -14,6 +14,10 @@ ESP-IDF provides ``console`` component, which includes building blocks needed to
 
   These features can be used together or independently. For example, it is possible to use line editing and command registration features, but use ``getopt`` or custom code for argument parsing, instead of `argtable3`_. Likewise, it is possible to use simpler means of command input (such as ``fgets``) together with the rest of the means for command splitting and argument parsing.
 
+.. note::
+
+  When using a console application on a chip that supports a hardware USB serial interface, we suggest to disable the secondary serial console output. The secondary output will be output-only and consequently does not make sense in an interactive application.
+
 Line editing
 ------------
 

docs/zh_CN/api-reference/system/console.rst

@@ -14,6 +14,10 @@ ESP-IDF 提供了 ``console`` 组件，它包含了开发基于串口的交互
 
   这些功能模块可以一起使用也可以独立使用，例如仅使用行编辑和命令注册的功能，然后使用 ``getopt`` 函数或者自定义的函数来实现参数解析，而不是直接使用 `argtable3 <https://www.argtable.org/>`_ 库。同样地，还可以使用更简单的命令输入方法（比如 ``fgets`` 函数）和其他用于命令分割和参数解析的方法。
 
+.. note::
+
+  当在支持硬件 USB 串行接口的芯片上使用控制台应用程序时，建议禁用次级串口控制台输出。次级输出仅用于显示，对于交互式应用程序没有任何作用。
+
 行编辑
 ------