Merge pull request #481 from Arthur-Milchior/IDE

NF: add an IDE help

microbit/src/03-setup/IDE.md

@@ -0,0 +1,31 @@
+# Getting the most out of your IDE
+
+All code in this book assumes that you use a simple terminal to build your code,
+run it, and interact with it. It also makes no assumption about your text editor.
+
+However, you may have your favourite IDEs, providing you auto-complete, type annotation,
+your preferred shortcuts and much more. This section explains how to get the most out
+of your IDE using the code obtained from this book's repo.
+
+# Auto-completion, type annotation, and more
+
+Some IDEs fail to understand the code, because they fail to determine whether a term
+is defined in the microbit or microbit-v2 codebase. If you fail to get auto-completion to work,
+you may want to try to edit the `Cargo.toml` files you encounter through this book, and remove
+all references to the version of microbit you are not using. That is:
+ in the `Cargo.toml` file you must remove the dependency and features you do not use (the part guarded by `#[cfg(feature = "vI")]` and the guard itself)
+
+# IDE configuration
+
+Below, we explain how to configure your IDE to get the most out of this book.
+If your IDE is not listed below, please improve this book by adding a section, so that the next
+reader can get the best experience out of it.
+
+## How to build with IntelliJ
+
+When editing the IntelliJ build configuration, here are a few non-default values:
+* You should edit the command. When this book tells you to run `cargo embed FLAGS`,
+You'll need to replace the default value `run` by the command `embed FLAGS`,
+* You should enable "Emulate terminal in output console". Otherwise, your program will fail to print text to a terminal
+* You should ensure that the working directory is `microbit/src/N-name`, with `N-name` being the directory of the chapter you
+are reading. You can not run from the `src` directory since it contains no cargo file.

microbit/src/SUMMARY.md

@@ -6,6 +6,7 @@
     - [Windows](03-setup/windows.md)
     - [macOS](03-setup/macos.md)
     - [Verify the installation](03-setup/verify.md)
+    - [Setting up your IDE](03-setup/IDE.md)
 - [Meet your hardware](04-meet-your-hardware/README.md)
     - [micro:bit v2](04-meet-your-hardware/microbit-v2.md)
     - [micro:bit v1](04-meet-your-hardware/microbit-v1.md)