Rework a bit Arch page and add contribution info

docs/arch.md

@@ -1,29 +1,31 @@
 This document is a guide for installing Arch Linux ARM on the Helios4.
 
-## What you need before you start
+**Arch Linux ARM** is a port of Arch Linux for ARM processors. Its design philosophy is simplicity and full control to the end user, and like its parent operating system Arch Linux, aims to be very Unix-like. More info [here](https://archlinuxarm.org/).
 
-Look at the "[What you need before you start](/install/#what-you-need-before-you-start)" section of the Helios4 install guide.
+## Prerequisite
 
-## Using an Arch Linux ARM image file for Helios4
+Refer to the following [section](/install/#what-you-need-before-you-start) of the Helios4 install guide.
+
+## Arch Linux ARM image for Helios4
 
 Arch Linux ARM can be installed on Helios4 using an image file containing both the **Arch Linux ARM system** and the **U-Boot** boot loader.
 
-This image can be created using the `build-archlinux-img-for-helios4.sh` script provided by the [alarm-helios4-image-builder](https://github.com/gbcreation/alarm-helios4-image-builder) project, or you can use a pre-built image from the same project. Each method is described below.
+This image can be created using the `build-archlinux-img-for-helios4.sh` script provided by the [alarm-helios4-image-builder](https://github.com/gbcreation/alarm-helios4-image-builder) project, or you can use pre-built images provided by the same project. Each method is described below.
 
 Once you get an image file, follow the instructions from the [Installing Arch Linux ARM on Helios4](#installing-arch-linux-arm-on-helios4) section below.
 
-### The Arch Linux ARM image builder for Helios4
+### Arch Linux ARM image builder
 
-The `build-archlinux-img-for-helios4.sh` script provided by the [alarm-helios4-image-builder](https://github.com/gbcreation/alarm-helios4-image-builder) project allows to create a bootable Arch Linux ARM image file for Helios4 automatically.
+The `build-archlinux-img-for-helios4.sh` script provides an easy way to automatically create a bootable Arch Linux ARM image file for Helios4.
 
 #### Requirements
 
-The `build-archlinux-img-for-helios4.sh` script expects to be used on a **x86 system running [Arch Linux](https://archlinux.org)**. It needs `qemu-arm-static` to work. You can install it using the [qemu-user-static](https://aur.archlinux.org/packages/qemu-user-static/) or [qemu-user-static-bin](https://aur.archlinux.org/packages/qemu-user-static-bin/) packages from the AUR.
+The `build-archlinux-img-for-helios4.sh` script expects to be run on a **x86 system running [Arch Linux](https://archlinux.org)**. It needs `qemu-arm-static` to work. You can install it using the [qemu-user-static](https://aur.archlinux.org/packages/qemu-user-static/) or [qemu-user-static-bin](https://aur.archlinux.org/packages/qemu-user-static-bin/) packages from the AUR.
 
 #### Usage
 
 !!! note
-    This script needs to execute commands as the superuser. If not run as root, it will re-run itself using sudo.
+    This script needs to execute commands as superuser. If not run as root, it will re-run itself using sudo.
 
 ```shell
 $ git clone https://github.com/gbcreation/alarm-helios4-image-builder.git
@@ -31,11 +33,11 @@ $ cd alarm-helios4-image-builder
 $ sh ./build-archlinux-img-for-helios4.sh
 ```
 
-Once the Arch Linux ARM image created, follow the instructions from the [Installing Arch Linux ARM on Helios4](#installing-arch-linux-arm-on-helios4) section below.
+Once the Arch Linux ARM image is created, go to [Installing Arch Linux ARM on Helios4](#installing-arch-linux-arm-on-helios4) section.
 
 ### Pre-built images
 
-You can download a pre-built Arch Linux ARM image for Helios4 from the [alarm-helios4-img-builder](https://github.com/gbcreation/alarm-helios4-image-builder/releases) project.
+You can download [here](https://github.com/gbcreation/alarm-helios4-image-builder/releases) pre-built Arch Linux ARM images for Helios4.
 
 ```shell
 $ wget https://github.com/gbcreation/alarm-helios4-image-builder/releases/download/2019-02-27/ArchLinuxARM-helios4-2019-02-27.img.gz{,.md5}
@@ -49,11 +51,11 @@ Once you get an Arch Linux ARM image, follows these instructions to use it on He
 
 ### Writing image / power-up Helios4 / connecting to serial console
 
-Follows these steps from the [Helios4 install guide](/install):
+Follows these steps from the Helios4 [install guide](/install):
 
 - [step 2](/install/#step-2-writing-an-image-to-a-microsd-card) to write the Arch Linux ARM image to a microSD card
 - [step 3](/install/#step-3-power-up-helios4) to power-up Helios4
-- [step 4](/install/#step-4-connect-to-helios4-serial-console) to connect to the Helios4 serial console. 
+- [step 4](/install/#step-4-connect-to-helios4-serial-console) to connect to the Helios4 serial console.
 
 !!! note
     Arch Linux ARM is configured by default to get its IP address from a DHCP server. As an alternative to **step 4**, you can connect to your router to find the IP address given to Helios4, then connect to this latter using SSH.
@@ -80,7 +82,7 @@ The Pacman keyring is already initialized in the images created by the `build-ar
 
 ## What to do next?
 
-You can now configure Arch Linux ARM according to you needs and use **pacman** to install third party applications.
+You can now configure Arch Linux ARM according to your needs and use **pacman** to install 3rd party applications.
 
 Here are some useful links from the [Arch Linux wiki](https://wiki.archlinux.org) to get started:
 
@@ -93,3 +95,6 @@ Here are some useful links from the [Arch Linux wiki](https://wiki.archlinux.org
 - [Nextcloud](https://wiki.archlinux.org/index.php/Nextcloud)
 - [NFS](https://wiki.archlinux.org/index.php/NFS)
 - [Samba](https://wiki.archlinux.org/index.php/Samba)
+
+
+*Page contributed by [gbcreation](https://github.com/gbcreation)*

docs/freebsd.md

@@ -72,3 +72,5 @@ This time, just sit back and watch as FreeBSD comes up.
 
 ### Default User
 The FreeBSD image by crochet comes with an unlocked root account. This means you do not need to enter a password to log in as root.
+
+*Page contributed by [Artox](https://github.com/Artox)*

mkdocs.yml

@@ -62,7 +62,7 @@ pages:
 - Download: 'download.md'
 - Install: 'install.md'
 - O/S:
-  - Arch Linux ARM : 'archlinuxarm.md'
+  - Arch Linux : 'arch.md'
   - Armbian : 'armbian.md'
   - FreeBSD : 'freebsd.md'
   - U-Boot (bootloader) : 'uboot.md'