Merge pull request #28 from yorikvanhavre/yorikvanhavre-patch-2

Small tweaks to getting started page

Author: chennes

gettingstarted/index.md

@@ -24,30 +24,37 @@ Other combinations may work as well, these are just the ones that you will be ab
 
 FreeCAD depends on many other open source projects to provide the basic foundations of the program. There are many ways of installing these dependencies: for details and the complete list, see the following Wiki pages:
 
-- Linux: https://wiki.freecad.org/Compile_on_Linux
-- Windows: https://wiki.freecad.org/Compile_on_Windows
-- Mac: https://wiki.freecad.org/Compile_on_MacOS
+- Linux: [https://wiki.freecad.org/Compile_on_Linux](https://wiki.freecad.org/Compile_on_Linux)
+- Windows: [https://wiki.freecad.org/Compile_on_Windows](https://wiki.freecad.org/Compile_on_Windows)
+- Mac: [https://wiki.freecad.org/Compile_on_MacOS](https://wiki.freecad.org/Compile_on_MacOS)
 
 ## Setting up for Development
 
-1. Fork https://github.com/FreeCAD/FreeCAD on GitHub
+1. Fork [https://github.com/FreeCAD/FreeCAD](https://github.com/FreeCAD/FreeCAD) on GitHub
 2. Clone your fork: for example, on the command line you can use `git clone https://github.com/YourUsername/FreeCAD FreeCAD-src`
 3. Set up `pre-commit` (our automatic code-formatter and checker):
 
 
-    - `pip install pre-commit`
+    - `pip install pre-commit` or `apt install pre-commit` on Debian/Ubuntu
     - `cd FreeCAD-src`
     - `pre-commit install`
 
+4. We **strongly** recommend doing an out-of-source build, that is, build FreeCAD and put all generated files in a separate directory. Otherwise, the build files will be spread all over the source code and it will be much harder to sort out one from the other. A build directory can be created outside the FreeCAD source folder or inside:
+
+    - `mkdir build`
+    - `cd build`
+
+5. Run CMake, either in via the CMake GUI or on the command line see the wiki compilation page for your operating system for a detailed list of options.
+6. CMake will generate project files that can be read by your IDE of choice. See your IDE's documentation for details. In general:
 
-4. Run CMake, either in via the CMake GUI or on the command line see the wiki compilation page for your operating system for a detailed list of options. Note: we **strongly** recommend doing an out-of-source build, putting all generated files in their own directory.
-5. CMake will generate project files that can be read by your IDE of choice. See your IDE's documentation for details. In general:
- 
-    - On Linux, compile with a command like `cmake --build /path/to/FreeCAD-src` run from your build directory.
+    - On Linux, compile with a command like `cmake --build /path/to/FreeCAD-src` run from your build directory ( or `cmake --build ..` if your build directory is inside FreeCAD-src).
     - On Windows with Visual Studio, build the "ALL_BUILD target" (you will have to change the path to the final executable the first time you try to run that target).
     - On Mac on the command line use `cmake --build /path/to/FreeCAD-src` from your build directory, or if using CLion be sure to "Build All" the first time you run.
 
-6. If you plan on submitting a PR, create a branch: `git checkout -b fixTheThing`
+7. If you plan on submitting a PR, create a branch: 
+
+    - `git branch fixTheThing`
+    - `git checkout fixTheThing` (or both commands in one go: `git checkout -b fixTheThing`)
 
 ## Submitting a PR