fix machine intel documentation

Signed-off-by: Ronan <ronan.lemartret@iot.bzh>

1 files changed, 47 insertions, 61 deletions

diff --git a/getting-started/machines/intel.md b/getting-started/machines/intel.md
index 310654c..9c71d87 100644
--- a/getting-started/machines/intel.md
+++ b/getting-started/machines/intel.md
@@ -2,88 +2,76 @@
 
 ## Scope
 This documentation is aiming at people who want to run Automotive Grade
-Linux (AGL) on an Intel Hardware (HW). While the reference HW used by
-AGL project is the Open Source Minnowboard.<br>
-(http://wiki.minnowboard.org/MinnowBoard\_Wiki\_Home) this documentation
-can be used to enable most of 64 bits Intel Architecture (IA) using UEFI
-as boot loader. You need to run the 64 bits version of the UEFI boot.<br>
+Linux (AGL) on an Intel Hardware (HW).  
+While the reference HW used by AGL project is the Open Source Minnowboard.  
+This documentation [MinnowBoard wiki](http://wiki.minnowboard.org/MinnowBoard\_Wiki\_Home) 
+can be used to enable most of 64 bits Intel Architecture (IA) using UEFI as boot loader.  
+You need to run the 64 bits version of the UEFI boot.
 Minnowbaord Max and Turbo are both 64 bits capable.
 
-**Note** this page is more focused on please willing to create
-        bespoke AGL image and BSP. If you are more interested by Apps
-        creation, please visit [ Developing
-        Apps for AGL](https://wiki.automotivelinux.org/agl-distro/developer_resources_intel_apps)
+**Note** :  
+ * This page is more focused on please willing to create bespoke AGL image and BSP.  
+If you are more interested by Apps creation, please visit [ Developing Apps for AGL](https://wiki.automotivelinux.org/agl-distro/developer_resources_intel_apps)
 
-UEFI has evolved a lot recently and you likely want to check that your
-HW firmware is up-to-date, this is particularly important for the
-Minnowboard.
+UEFI has evolved a lot recently and you likely want to check that your HW firmware is up-to-date, this is particularly important for the Minnowboard.
 
-` `[`https://firmware.intel.com/projects/minnowboard-max`](https://firmware.intel.com/projects/minnowboard-max)
+[`https://firmware.intel.com/projects/minnowboard-max`](https://firmware.intel.com/projects/minnowboard-max)
 
 ## Where to find an AGL bootable image
 
 ### Building an AGL image from scratch using Yocto.
 
-**Note:** An alternative method for building an image is to use
-        the AGL SDK delivered in a Docker container. There is currently no SDK dedicated to IA 
-        but the SDK provided for the Porter Board can build
-        an IA image without changes (just aglsetup.sh needs to call for Intel).
+**Note:**:  
+ * An alternative method for building an image is to use the AGL SDK delivered in a Docker container.  
+There is currently no SDK dedicated to IA but the SDK provided for the Porter Board can build an IA image without changes (just aglsetup.sh needs to call for Intel).
 
-see chapter 2 of [Porter Quick
-Start](http://iot.bzh/download/public/2016/sdk/AGL-Kickstart-on-Renesas-Porter-board.pdf "wikilink").
+see chapter 2 of [Porter QuickStart](http://iot.bzh/download/public/2016/sdk/AGL-Kickstart-on-Renesas-Porter-board.pdf "wikilink").
 
 #### Download AGL source code
 Downloading the AGL sources from the various Git repositories is automated with the repo
-tools [ to Repo
-Documentation](https://source.android.com/source/using-repo.html "wikilink")
+tools [ to RepoDocumentation](https://source.android.com/source/using-repo.html "wikilink")
 
 To install the repo tool.
 
 ```bash
-  mkdir -p ~/bin
-  export PATH=~/bin:$PATH\
-  curl [https://storage.googleapis.com/git-repo-downloads/repo](https://storage.googleapis.com/git-repo-downloads/repo) > ~/bin/repo\
-  chmod a+x ~/bin/repo
+  mkdir -p ~/bin;
+  export PATH=~/bin:$PATH;
+  curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo;
+  chmod a+x ~/bin/repo;
 ```
 
-
-
 #### Configuring for the current *(older)* stable (blowfish\_2.0.4) (BB)
 
 ```bash
-  cd AGL-2.0.4\
-  repo init -u \
-  [https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo](https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo) \
-  -b blowfish \
-  -m default_blowfish_2.0.4.xml
+  cd AGL-2.0.4;
+  repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo -b blowfish -m default_blowfish_2.0.4.xml
 ```
 #### Configuring for master (CC)
 
 ```bash
-  cd AGL-master\
-  repo init -u [`https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo`](https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo)\
+  cd AGL-master;
+  repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo;
 ```
 
 #### Only for developer working on virtualisation
-**Note :** this is WIP and most likely to fail most of the time)
+**Note :**:  
+This is WIP and most likely to fail most of the time)
 ```bash
-  cd AGL-master-next\
-  repo init -b morty \
-  -u `[`https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo`](https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo)
+  cd AGL-master-next;
+  repo init -b morty -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo;
 ```
 
-Once that you repo is initialised either with the stable or WIP, you
-need to sync the repo to fetch the various git trees.
+Once that you repo is initialised either with the stable or WIP, you need to sync the repo to fetch the various git trees.
 
 #### Downloading the configured AGL source code
 
 ```bash
-  repo sync
+  repo sync;
 ```
 
 #### Building the AGL distro
-You are now ready to initialise your Yocto build. When running the
-command
+You are now ready to initialise your Yocto build.  
+When running the command:
 
 ```bash
   source meta-agl/scripts/aglsetup.sh -h
@@ -109,34 +97,31 @@ internet connection and will required several GB on /tmp as well as on your buil
 ```bash
   bitbake agl-demo-platform
 ```
-** Your newly baked disk image (.hddimg) will be located at **
+** Your newly baked disk image (.hddimg) will be located at **:  
   `tmp/deploy/images/intel-corei7-64/`
 
 ##### Alternative: Download a *ready made* image from AGL web site
 
-The Continuous Integration (CI) process from AGL creates and publish
-daily and stable builds. Pointers to both can be found in [ AGL
-supported HW](agl-distro: "wikilink") (see Reference BSP/Intel).
+The Continuous Integration (CI) process from AGL creates and publish daily and stable builds.  
+Pointers to both can be found in [ AGL supported HW](https://wiki.automotivelinux.org/agl-distro) (see Reference BSP/Intel).
 
-Once you have validated your process you can start to play/work with the
-snapshot pointer.
+Once you have validated your process you can start to play/work with the snapshot pointer.
 
 Note that snapshot build may not work.
 
-Follow the directory
+Follow the directory:  
 
 ` intel-corei7-64/deploy/images/intel-corei7-64/`
 
-and download the file
+and download the file:  
 
 ` agl-demo-platform-intel-corei7-64.hddimg`
 
 ## Create a bootable media
 
-Depending your target HW you will use an USB stick, an SD card or a
-HDD/SDD. The creation process remains the same independently of the
-selected support. It does require to have access to a Linux machine with
-sudo or root password.
+Depending your target HW you will use an USB stick, an SD card or a HDD/SDD.  
+The creation process remains the same independently of the selected support.  
+It does require to have access to a Linux machine with sudo or root password.
 
 ### Insert you removable media in the corresponding interface.
 
@@ -147,16 +132,16 @@ sudo or root password.
   # Note that you want the name of the raw device not of a partition on the media
   #(eg. /dev/sdc or /dev/mmcblk0)
 ```
-### Download the script mkefi-agl.sh 
-This script is present in the directory meta-agl/scripts from blowfish 2.0.4, alternatively you can download it from the following Git repo
+### Download the script mkefi-agl.sh
+This script is present in the directory meta-agl/scripts from blowfish 2.0.4, alternatively you can download it from the following Git repo:  
 
-` `[`https://github.com/dominig/mkefi-agl.sh`](https://github.com/dominig/mkefi-agl.sh)
+[https://github.com/dominig/mkefi-agl.sh](https://github.com/dominig/mkefi-agl.sh)
 
 
 ### check the available option
 
 ```bash
-  sh mkefi-agl.sh -v
+  sh mkefi-agl.sh -v;
 ```
 ### create your media with the command ajusted to your configuration
 
@@ -177,8 +162,9 @@ This script is present in the directory meta-agl/scripts from blowfish 2.0.4, al
 
 1. Let AGL boot
 
-**Note:** depending on the speed of the removable media, the first boot
-may not complete, in that case simply reboot the device. This is quite common with USB2 sticks.<br>
+**Note:**:  
+ * Depending on the speed of the removable media, the first boot may not complete, in that case simply reboot the device.  
+This is quite common with USB2 sticks.  
 By default the serial console is configured and activated at the rate of 115200 bps.
 
 ## How to create your 1st AGL application