README Add a placeholder for the readme, fix typos in images

Author: stffrdhrn

README.md

@@ -0,0 +1,69 @@
+## OpenRISC Tutorials
+
+This repository contains the source for the [OpenRISC architecture tutorials](https://openrisc.io/tutorials/)
+
+These documents are helpful for users who want to get started
+developing software and SoC's using the OpenRISC cpu architecture.
+
+## Outline
+
+We are currently in progress working on a new structure
+and the intended outline is:
+
+```
+Getting started with OpenRISC
+
+Programmers Guide
+ - Link to the architecture
+
+Toolchain Options
+  Binaries
+   - downloads from github, need to setup CI for building
+
+  Obtaining
+   - or1k-linux-          gcc
+   - or1k-elf-            newlib
+   - or1k-unknown-gnu-    glibc
+   - or1k-unkiown-musl-   musl
+     - https://github.com/richfelker/musl-cross-make - or1k/openrisc needs update
+   - or1k-unknown-uclibc-
+     - https://uclibc-ng.org/docs/ - docs to build
+
+ Platforms
+  Loading binaries into platforms. ELF binaries explaination.
+  - or1ksim
+  - QEMU
+  - Fusesoc
+  - Litex
+
+Programs on OpenRISC
+
+ Memory layout
+ - Elf binary lays out memeory for linux/bare metal.
+
+Linux on OpenRISC
+ Memory layout
+ - In addition to ELF binary
+ - Device tree
+ - Rootfs loaded to memory for embedded systems / no sd card
+
+ Rootfs
+ - buildroot
+ - busybox
+
+ Running linux on or1ksim
+  - defconfig + busybox
+
+ Running linux on QEMU
+  - virt_defconfig + buildroot
+
+ Running linux on Litex SoC
+  - SIM + litex_defconfig + buildroot
+  - arty + litex_defconfig + buildroot
+
+ Running Linux on fusesoc SoC
+  - SIM + defconfig + busybox
+  - de0_nano + defconfig + busybox
+  - de0_nano-multicore + smp_defconfig + busybox
+```
+

images.md

@@ -133,14 +133,16 @@ podman run -it --rm stffrdhrn/or1k-verilog-env
 This will bring you to the container prompt which
 has access to the verilog development environment.
 
-```
 Create the `hello.c` file as described above, then to compile our program run
 `gcc` from the OpenRISC toolchain as below:
 
 ```bash
 or1k-elf-gcc hello.c -o hello
 ```
 
+This will compile our Hello World program using the OpenRISC baremetal toolchain
+and output an ELF file to `hello`.
+
 After our program is compiled we want to prepare to run the program, check that the
 fusesoc environment is setup correctly using the following commands:
 
@@ -153,7 +155,7 @@ Changing directories to `/tmp/src/cores` is needed as fusesoc looks
 for verilog IP cores starting in the current directory.  The `fusesoc core-info`
 command checks if our `mor1kx-generic` SoC is available as expected.
 
-To compile to verilog SoC and run it we use:
+To compile and run the verilog SoC we use:
 
 ```bash
 fusesoc run --target mor1kx_tb mor1kx-generic --elf_load ../hello