update vscode documentation

Author: Pesc0

howtousevscode.md

@@ -11,7 +11,7 @@ ms-vscode.cpptools-extension-pack
 ms-python.python
 ```
 
-## Configure CMake
+## Select build configuration
 
 <video autoplay muted playsinline loop src="images/configure.mp4" type="video/mp4"></video>
 
@@ -21,34 +21,27 @@ First on the bottom left corner, in the status bar, select the build type. Optio
 - conda debug
 - conda release
 
-If you are using conda, please select one of the respective ones.
+If you are using conda please select one of the respective ones.
 
-Then press `Ctrl + P` and in the panel write `task ` (don't forget the space after task!). Finally select `Cmake: configure`, and that's it!
-
-You will have to do this when you select a new configutation never used before. If you now select `release` you will have to configure again. If you go back to `debug` it is already configured, you dont have to launch the task.  
+Cmake should automatically configure the project with the selected configuration.
 
 ## First build
 
 <video autoplay muted playsinline loop src="images/build.mp4" type="video/mp4"></video>
 
-Press `Ctrl + P` and write `task ` again (don't forget the space!)
-
-Select `Cmake: build`, and watch it go. Or don't, it takes a lot of time to do a fresh build.
+Press `Ctrl + Shift + B`, or click the build button with the cog icon in the status bar, or run the `CMake: build` task.
 
-There's a much more convenient shortcut to launch a build: `Ctrl + Shift + B`.
+**NOTE:** The first build takes a while.
 
-Note that if you change configuration in the step above you will have to build again.
+**NOTE:** If you change configuration (see step above) you will have to build again.
 
 ## Launching the built executable and debugging
 
-<video autoplay muted playsinline loop src="images/launch_debug.mp4" type="video/mp4"></video>
-
+<video autoplay muted playsinline loop src="images/debug.mp4" type="video/mp4"></video>
 
-On the left panel go to the debug section and click the little green play button. Alternatively press `F5`. Every time you launch the executable a build is triggered, to ensure all the latest changes you made to the code are compiled in.
+On the left panel go to the debug section and click the little green play button. Alternatively press `F5`. Every time you launch the debugger a build is triggered, to ensure all the latest changes you made to the code are compiled in.
 
-The first time VSCode will ask to select some options. Just stick to `[default]` (which is the only option) and `FreeCADMain`. Don't worry you won't have to select these again.
-
-After that you should see freecad launching and the debugger attaching to the process. If an error pops up the python debugger failed to attach (there's 30 second timeout).
+You should see freecad launching and the debugger attaching to the process. If an error pops up the python debugger failed to attach (there's 30 second timeout).
 Close FreeCAD and try launching it again. If it still fails try increasing the timeout located in the file `.vscode/scripts/WaitForDebugpy.py`
 
 To debug please refer to the [documentation](https://code.visualstudio.com/docs/editor/debugging#_debug-actions) or search for a tutorial online. 
@@ -59,18 +52,18 @@ To debug please refer to the [documentation](https://code.visualstudio.com/docs/
 
 **NOTE:** Don't use the restart button. It only restarts the selected debugger, which definitely is not what you want. Instead press the stop button (which stops both debuggers) and launch again.
 
-**NOTE:** During the build process all the python files in the source tree get copied (yes simply copied) to the build directory. You need to place breakpoints in the files inside `build/` otherwise the debugger won't pick them up. This does not apply to cpp files, with those simply place the breakpoints inside the source tree `src/`.
-
 ## Running tests
 
 <video autoplay muted playsinline loop src="images/testing.mp4" type="video/mp4"></video>
 
 The IDE supports running FreeCAD tests as well. On the left panel go to the testing section and click the play button. A build takes place and then all the tests are run and results reported. 
 
-**NOTE:** This is much slower than running the `Tests_run` executable directly. The GIF above is sped up.
+**NOTE:** This is much slower than running the `Tests_run` executable directly. The video above is sped up.
 
 **NOTE:** Only c++ tests are currently integrated. Python tests are run from the `Test workbench` or with the command `FreeCAD -t 0`.
 
+Alternatively, there are two vscode tasks that can be used to run the cpp and python tests directly.
+
 **NOTE:** The debug tests button does not currently work. More configuration is needed to get that to work.
 
 ## General features of VSCode