More documentation

README.md

+<img src="./document/images/play_illustration.png" alt="VIPS app in Google Play" style="width: 500px;"/>
+
 # VIPS Field Observation App
 
-> The Field Pest Observation App for VIPS users
+Providing an easy way to register pest observations made in the field by registered VIPS users. Available for Android and iOS smartphones.
+
+## Architecture
+The app has been built using 
+* [Apache Cordova](https://cordova.apache.org/) v.11.0.0
+* [Vue.js version 2](https://v2.vuejs.org/) and [vue-cli](https://cli.vuejs.org/)
+
+Most of the UI has been built in vue, and then compiled to the cordova www folder, and then subsequently used to build for the smartphone platforms.
 
 ## Prerequisites: node, npm, vue-cli and cordova
 Make sure you have the correct versions of npm and nodejs
@@ -115,7 +124,7 @@ There's a simple translation example in /components/ObservationList.js:
 </template>
 ```
 
-(TODO: Update this documentation when code in ObservationList changes)
+**(TODO: Update this documentation when code in ObservationList changes)**
 
 Change the startup language in the app here in `/i18n.js`:
 
@@ -182,21 +191,6 @@ Before building, signing and publishing, make sure you bump the version in `pack
 	xmlns:cdv="http://cordova.apache.org/ns/1.0">
 ```
 
-### Notes and docs
-
-[Developer account for Google Play](https://play.google.com/console/)
-
-https://stackoverflow.com/questions/69357694/unable-to-build-app-bundle-aab-in-cordova
-
-https://cordova.apache.org/docs/en/11.x/guide/platforms/android/plugin.html
-
-https://developer.android.com/guide/app-bundle
-
-https://developer.android.com/studio/publish#unknown-sources
-
-
-## Building a production version (signing etc).
-### Android
 [Signing the app](https://cordova.apache.org/docs/en/latest/guide/platforms/android/#signing-an-app)
 
 For NIBIO, a signing key was originally created sometime in 2021, but it has been lost. After contacting Google Play Developer Support, we received instructions for how to generate a new key (example code):
@@ -213,7 +207,22 @@ We then extracted the PEM to send to Google (example code)
 keytool -export -rfc -alias upload -file upload_certificate.pem -keystore keystore.jks
 
 ```
-### iOS
+
+### Notes and docs
+
+[Developer account for Google Play](https://play.google.com/console/)
+
+https://stackoverflow.com/questions/69357694/unable-to-build-app-bundle-aab-in-cordova
+
+https://cordova.apache.org/docs/en/11.x/guide/platforms/android/plugin.html
+
+https://developer.android.com/guide/app-bundle
+
+https://developer.android.com/studio/publish#unknown-sources
+
+
+
+## iOS Publishing
 On iOS, do the regular `npm run build`, and then `cordova build ios`. You should then be ready to run the app in a simulator or a real device in XCode. Remember that in order to run it on a real device, you must sign it (see XCode screenshot below) with either your personal team account (for debug only) or a company account for distributing to App Store.
 
 ![Signing an app in XCode](./document/images/ios_signing.png "Signing an app in XCode")