diff --git a/5-misc/deployssh.md b/5-misc/deployssh.md
deleted file mode 100644
index f3af963..0000000
--- a/5-misc/deployssh.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Deploy a recipe to a target via ssh
-
-http://www.yoctoproject.org/docs/1.8/mega-manual/mega-manual.html#devtool-deploying-your-software-on-the-target-machine
\ No newline at end of file
diff --git a/5-troubleshooting/boot.md b/5-troubleshooting/boot.md
new file mode 100644
index 0000000..a3d4f5c
--- /dev/null
+++ b/5-troubleshooting/boot.md
@@ -0,0 +1,13 @@
+# Boot issues
+
+## Not bootable
+
+The flashed image must be built using [wic](../3-buildtest/wic.md). You should not flash images that are in `$POKY/build/tmp/deploy/images`.
+
+This can also be due to a mis configured bootloader.
+
+
+## Nothing on screen (happens randomly)
+
+It is caused by the kernel boot command line options.
+In the WKS file used to generate the final image, you must give the option `vga=current` (instead of `vga=0x318` or anything else).
\ No newline at end of file
diff --git a/5-troubleshooting/recipes.md b/5-troubleshooting/recipes.md
new file mode 100644
index 0000000..725ac39
--- /dev/null
+++ b/5-troubleshooting/recipes.md
@@ -0,0 +1,17 @@
+# Recipes issues
+
+## Some files are not added to the image
+
+##### `do_install`
+Be sure that the `do_install` task installs your files in `${D}` directory.
+
+##### `FILES_${PN}`
+Installing files in `${D}` is not enough, you also need to add the files/directories that needs to be included in the image in the `FILES_${PN}` variable.
+
+##### Special files
+Some files are not meant to be included in certain types of images.
+
+For example, `.so` libraries without specific versions are forbidden in the final system, as programs needs to be dynamically linked with the exact version of library they depend of.
+
+A workaraound for this is to define `SOLIBSDEV` to any extension, so `.so` files are not considered as dynamic libraries for this recipe.
+
diff --git a/5-misc/buildproc.md b/6-misc/buildproc.md
similarity index 100%
rename from 5-misc/buildproc.md
rename to 6-misc/buildproc.md
diff --git a/6-misc/deployssh.md b/6-misc/deployssh.md
new file mode 100644
index 0000000..68c098b
--- /dev/null
+++ b/6-misc/deployssh.md
@@ -0,0 +1,3 @@
+# Deploy a recipe to a target via ssh
+
+<todo data-markdown>http://www.yoctoproject.org/docs/1.8/mega-manual/mega-manual.html#devtool-deploying-your-software-on-the-target-machine</todo>
\ No newline at end of file
diff --git a/5-misc/pkgmgr.md b/6-misc/pkgmgr.md
similarity index 100%
rename from 5-misc/pkgmgr.md
rename to 6-misc/pkgmgr.md
diff --git a/5-misc/rorootfs.md b/6-misc/rorootfs.md
similarity index 100%
rename from 5-misc/rorootfs.md
rename to 6-misc/rorootfs.md
diff --git a/5-misc/toolchain.md b/6-misc/toolchain.md
similarity index 100%
rename from 5-misc/toolchain.md
rename to 6-misc/toolchain.md
diff --git a/6-maintenance/clean.md b/7-maintenance/clean.md
similarity index 100%
rename from 6-maintenance/clean.md
rename to 7-maintenance/clean.md
diff --git a/6-maintenance/update.md b/7-maintenance/update.md
similarity index 100%
rename from 6-maintenance/update.md
rename to 7-maintenance/update.md
diff --git a/SUMMARY.md b/SUMMARY.md
index c570687..62d58f4 100644
--- a/SUMMARY.md
+++ b/SUMMARY.md
@@ -31,12 +31,14 @@
 		* [Debugging Yocto builds](4-workflow/debug.md)
 		* [Adding packages/recipes to image](4-workflow/addpkg.md)
 		* [Creation of a distribution based on poky-tiny](4-workflow/distrocreate.md)
-	* [Misc](5-misc/buildproc.md)
-		* [Build process - Tasks](5-misc/buildproc.md)
-		* [Read-only root filesystem](5-misc/rorootfs.md)
-		* [Custom toolchain](5-misc/toolchain.md)
-		* [Deploy a recipe to a target via ssh](5-misc/deployssh.md)
-		* [Package Management (deb)](5-misc/pkgmgr.md)
-	* [Maintenance](6-maintenance/update.md)
-		* [Update Yocto](6-maintenance/update.md)
-		* [Cleaning](6-maintenance/clean.md)
+	* [Troubleshooting](5-troubleshooting/boot.md)
+		* [Boot](5-troubleshooting/boot.md)
+	* [Misc](6-misc/buildproc.md)
+		* [Build process - Tasks](6-misc/buildproc.md)
+		* [Read-only root filesystem](6-misc/rorootfs.md)
+		* [Custom toolchain](6-misc/toolchain.md)
+		* [Deploy a recipe to a target via ssh](6-misc/deployssh.md)
+		* [Package Management (deb)](6-misc/pkgmgr.md)
+	* [Maintenance](7-maintenance/update.md)
+		* [Update Yocto](7-maintenance/update.md)
+		* [Cleaning](7-maintenance/clean.md)