Initial Home page

Development-Guide.md

@@ -0,0 +1,47 @@
+Welcome to the Nextcloud Android app wiki and the development guide!
+This page serves as a short guide to get you up to speed to start developing for the Nextcloud Android app.
+
+#Getting started
+Getting the app up and running on your phone or tablet checkout the [setup guide](https://github.com/nextcloud/android/blob/master/SETUP.md).
+
+#Contribution process
+We are all about quality while not sacrificing speed so we use a very pragmatic workflow.
+* Any change needs to be submitted/introduced via a [pull request](https://github.com/nextcloud/android/pulls)
+* To assure the quality of the app, any PR gets reviewed,approved and tested by [two developers](https://github.com/nextcloud/android/blob/master/MAINTAINERS) before it will be merged to master
+
+#Releases
+At the moment we are releasing the app in two app stores:
+* [Google Play Store](https://play.google.com/store/apps/details?id=com.nextcloud.client)
+* f-droid (work in progress)
+
+We do differentiate between three different kinds of releases:
+* stable releases
+* stable beta releases done via the Beta program of the Google Play store
+* development beta releases done as a standalone app that can be installed in parallel to the stable app
+
+##Release process
+###Stable Release
+_Stable_ releases are based on the git [master](https://github.com/nextcloud/android).
+
+1. Bump the version name and version code in the [AndroidManifest.xml](https://github.com/nextcloud/android/blob/master/AndroidManifest.xml), see below the version name and code concept.
+2. Create a [release/tag](https://github.com/nextcloud/android/releases) in git. Tag name following the naming schema: ```stable-Mayor.Minor.Hotfix``` (e.g. 1.2.0) naming the version number following the [semantic versioning schema](http://semver.org/)
+
+###Stable Beta Release
+_Stable Beta_ releases are based on the git [master](https://github.com/nextcloud/android) and are done between stable releases.
+
+1. Bump the version name and version code in the [AndroidManifest.xml](https://github.com/nextcloud/android/blob/master/AndroidManifest.xml), see below the version name and code concept.
+2. Create a [release/tag](https://github.com/nextcloud/android/releases) in git. Tag name following the naming schema: ```Mayor.Minor.Hotfix-betaIncrement``` (e.g. 1.2.0-beta12) naming the version number following the [semantic versioning schema](http://semver.org/)
+
+###Beta Release
+_Beta_ releases are based on the git [beta](https://github.com/nextcloud/android/tree/beta) and are done independently from stable releases and integrate open PRs that might not be production ready or heavily tested but being put out there for people willing to test new features and provide valuable feedback on new features to be incorporated before a feature gets released in the stable app.
+
+1. Bump the version name and version code in the [AndroidManifest.xml](https://github.com/nextcloud/android/blob/master/AndroidManifest.xml), see below the version name and code concept.
+2. Create a [release/tag](https://github.com/nextcloud/android/releases) in git. Tag name following the naming schema: ```beta-YYYYMMDD``` (e.g. beta-20160612)
+
+##Version Name and number
+For _stable_ and _stable beta_ the version name follows the [semantic versioning schema](http://semver.org/) and the version number has several digits reserved to parts of the versioning schema, where:
+
+* 2 digits for beta code
+* 2 digits for hot fix code
+* 3 digits for minor version code
+* n digits for mayor version code