pio-debug, piodebuggdb: add page (#5780)

* pio-debug, piodebuggdb: add page

* Apply suggestion from code review

Co-authored-by: bl-ue <54780737+bl-ue@users.noreply.github.com>

* Apply suggestion from code review

Co-authored-by: bl-ue <54780737+bl-ue@users.noreply.github.com>

Co-authored-by: bl-ue <54780737+bl-ue@users.noreply.github.com>

pages/common/pio-debug.md

@@ -0,0 +1,24 @@
+# pio debug
+
+> Debug PlatformIO projects.
+> More information: <https://docs.platformio.org/en/latest/core/userguide/cmd_debug.html>.
+
+- Debug the PlatformIO project in the current directory:
+
+`pio debug`
+
+- Debug a specific PlatformIO project:
+
+`pio debug --project-dir {{path/to/platformio_project}}`
+
+- Debug a specific environment:
+
+`pio debug --environment {{environment}}`
+
+- Debug a PlatformIO project using a specific configuration file:
+
+`pio debug --project-conf {{path/to/platformio.ini}}`
+
+- Debug a PlatformIO project using the `gdb` debugger:
+
+`pio debug --interface={{gdb}} {{gdb_options}}`

pages/common/piodebuggdb.md

@@ -0,0 +1,7 @@
+# piodebuggdb
+
+> This command is an alias of `pio debug --interface=gdb`.
+
+- View documentation for the original command:
+
+`tldr pio debug`