Sync Docs platformio/platformio-core@647b131

en/latest/_sources/projectconf/build_configurations.rst.txt

@@ -40,8 +40,9 @@ PlatformIO:
 If you need to build a project in ``debug`` configuration, please use one of
 these options:
 
+* In :ref:`ide_vscode`: Use build option **Pre-Debug** or **Pre-Debug All** in the ``Project Tasks`` menu.
 * Add :ref:`projectconf_build_type` with ``debug`` value to :ref:`projectconf`
-* Use target ``debug`` for the :option:`pio run --target` command.
+* Use :ref:`cmd_debug` command.
 
 .. note::
   :ref:`piodebug` automatically switches to ``debug`` configuration when you do

en/latest/projectconf/build_configurations.html

@@ -171,8 +171,9 @@
 <p>If you need to build a project in <code class="docutils literal notranslate"><span class="pre">debug</span></code> configuration, please use one of
 these options:</p>
 <ul class="simple">
+<li><p>In <a class="reference internal" href="../integration/ide/vscode.html#ide-vscode"><span class="std std-ref">PlatformIO IDE for VSCode</span></a>: Use build option <strong>Pre-Debug</strong> or <strong>Pre-Debug All</strong> in the <code class="docutils literal notranslate"><span class="pre">Project</span> <span class="pre">Tasks</span></code> menu.</p></li>
 <li><p>Add <a class="reference internal" href="sections/env/options/build/build_type.html#projectconf-build-type"><span class="std std-ref">build_type</span></a> with <code class="docutils literal notranslate"><span class="pre">debug</span></code> value to <a class="reference internal" href="index.html#projectconf"><span class="std std-ref">“platformio.ini” (Project Configuration File)</span></a></p></li>
-<li><p>Use target <code class="docutils literal notranslate"><span class="pre">debug</span></code> for the <a class="reference internal" href="../core/userguide/cmd_run.html#cmdoption-pio-run-t"><code class="xref std std-option docutils literal notranslate"><span class="pre">pio</span> <span class="pre">run</span> <span class="pre">--target</span></code></a> command.</p></li>
+<li><p>Use <a class="reference internal" href="../core/userguide/cmd_debug.html#cmd-debug"><span class="std std-ref">pio debug</span></a> command.</p></li>
 </ul>
 <div class="admonition note">
 <p class="admonition-title">Note</p>