add md

.gitignore

@@ -1,4 +1,4 @@
 /*
 !/.gitignore
 !/scripts
-!/README.org
+!/README.*

README.md

@@ -0,0 +1,93 @@
+
+# Table of Contents
+
+1.  [About the Board](#org05120cc)
+2.  [Creating a Bootable Yocto Linux Image](#orgac4cb07)
+    1.  [Create a workspace (OPTIONAL)](#org109b3fc)
+    2.  [Update the repo workspace](#orgfd26467)
+    3.  [Set up the Bitbake environment](#org7077080)
+    4.  [Building Board Disk Image](#orge052232)
+        1.  [Building a Linux Image with a root file system (RootFS)](#org4594f3e)
+        2.  [Building a RAM-based Root Filestystem](#orgec80779)
+        3.  [Building a Linux Image for an external QSPI flash memory](#org38ff821)
+        4.  [Flashing an SD Card](#org23fb3ff)
+3.  [References](#orge93c43d)
+
+
+
+<a id="org05120cc"></a>
+
+# About the Board
+
+![img](./doc/img/PolarFire-Board.png)
+
+
+<a id="orgac4cb07"></a>
+
+# Creating a Bootable Yocto Linux Image
+
+We have two options: Create a new workspace, or we can use this repo as a workspace because this repo is my working workspace.
+
+
+<a id="org109b3fc"></a>
+
+## Create a workspace (OPTIONAL)
+
+    mkdir yocto-dev && cd yocto-dev
+    repo init -u https://github.com/polarfire-soc/polarfire-soc-yocto-manifests.git -b main -m default.xml
+
+
+<a id="orgfd26467"></a>
+
+## Update the repo workspace
+
+    repo sync
+    repo rebase
+
+
+<a id="org7077080"></a>
+
+## Set up the Bitbake environment
+
+    . ./meta-polarfire-soc-yocto-bsp/polarfire-soc_yocto_setup.sh
+
+
+<a id="orge052232"></a>
+
+## Building Board Disk Image
+
+
+<a id="org4594f3e"></a>
+
+### Building a Linux Image with a root file system (RootFS)
+
+    MACHINE=icicle-kit-es bitbake mpfs-dev-cli
+
+
+<a id="orgec80779"></a>
+
+### Building a RAM-based Root Filestystem
+
+    MACHINE=icicle-kit-es bitbake -R conf/initramfs.conf mpfs-initramfs-image
+
+
+<a id="org38ff821"></a>
+
+### Building a Linux Image for an external QSPI flash memory
+
+
+<a id="org23fb3ff"></a>
+
+### Flashing an SD Card
+
+    zcat build/tmp-glibc/deploy/images/icicle-kit-es/mpfs-dev-cli-icicle-kit-es.wic.gz | sudo dd of=/dev/sdX bs=4096 iflag=fullblock oflag=direct conv=fsync status=progress
+
+
+<a id="orge93c43d"></a>
+
+# References
+
+1.  [PolarFire SoC Yocto](https://github.com/polarfire-soc/meta-polarfire-soc-yocto-bsp)
+
+    **\*\***
+