README ++

doc/litex/alpine/README.md

@@ -1,6 +1,17 @@
-https://blog.ari.lt/b/how-to-manually-install-alpine-linux-on-any-linux-distribution/
-https://wiki.gentoo.org/wiki/OpenRC_to_systemd_Cheatsheet
+# Getting Alpine linux to run on RISC-V
 
+So this README compile a set of command lines which were used to get it up on running on the VexiiRiscv RV64GC litex SoC.
+You can find most of the fundamental informations on the links bellow : 
+
+- https://blog.ari.lt/b/how-to-manually-install-alpine-linux-on-any-linux-distribution/
+- https://wiki.gentoo.org/wiki/OpenRC_to_systemd_Cheatsheet
+
+Overall, if you have a system which can run Debian, then it should be able to run Alpine without issues.
+The one tricky thing with alpine linux is that the image you can download generaly need a few tweeks using chroot to be functional.
+
+## Image setup 
+
+```bash
 cd /media/rawrr/rootfs
 sudo rm -rf *
 sudo tar xpvf /media/data2/download/alpine-minirootfs-3.20.1-riscv64.tar.gz --xattrs-include='*.*' --numeric-owner
@@ -15,18 +26,22 @@ rc-update add loadkeys boot
 rc-update add chronyd boot
 
 apk add xf86-video-fbdev xterm
+```
 
-setup-keymap ch fr 
+## Scrap commands
 
+```bash
+setup-keymap ch fr
 XKBMODEL="pc105"
 XKBLAYOUT="ch"
 XKBVARIANT="fr"
 XKBOPTIONS=""
+
 mount -o remount,rw /
 
 kbd-bkeymaps
 
 loadkeys ch-fr
 
 apk add chocolate-doom --repository=https://dl-cdn.alpinelinux.org/alpine/edge/testing
-
+```

doc/litex/buildroot/README.md

@@ -2,6 +2,11 @@
 
 This readme document (from scratch) how to generate all the images to run buildroot Litex + VexiiRiscv.
 
+The hardware requirements are to have : 
+- RV32IMA CPU
+- Some RAM (64 MB)
+- SDCARD support
+
 ## Setup environnement variables
 
 ```shell

doc/litex/debian/README.md

@@ -2,6 +2,11 @@
 
 This readme document (from scratch) how to generate all the images to run debian Litex + VexiiRiscv.
 
+The hardware requirements are to have :
+- RV64IMAFDC CPU
+- A good amount of RAM (128 MB)
+- SDCARD support
+
 ## Setup environnement variables
 
 ```shell