--- a/client/docs/developer.md	Thu Aug 23 18:50:32 2018 +0200
+++ b/client/docs/developer.md	Fri Aug 24 10:08:49 2018 +0200
@@ -1,18 +1,85 @@
+# General considerations
+
+## We chose [vuejs](https://vuejs.org/)
+
+Vue is a modern framework for webdevelopment.
+It offers a very homogenous ecosystem (vuejs, vuecli, vue-router vuex) combined with up to date fontend rendering techniques like virtual DOM.
+
+## We chose [vue cli](https://cli.vuejs.org/)
+
+Vue cli allows a good jumpstart for a vuejs project.
+There is no manual boilerplate to write. Everything is in place and already wired. The skeleton is easy extendable and in contrast to
+other frameworks (i.e. create-react-app) there is no "eject" for further customization necessary.
+
+Configuration:
+
+- Babel
+- Router
+- Vuex
+- CSSPreprocessor
+- Linter+Unit
+- Testing+E2E
+- Testing
+- No Typescript (No advantages)
+- No PWA (IE11 compatibility makes more modern approaches unavailable)
+
+- SASS as CSS Preprocessor (widely used, allows programmatic CSS, familarity)
+- Eslint + Prettier (Rationale below)
+- Lint on Save
+- Jest as Unittesting framework (zeroconf, ease of use) [productpage](https://jestjs.io/
+- Nightwatch (Seleniumbased, familarity with selenium, Chromedriver ootB)
+
+Everything in dedicated config files
+
+## We chose [vuex](https://vuex.vuejs.org/guide/)
+
+Vuex is the store component of vuejs. For medium to complex applications it is reasonable to centralize state globally, to make every possible interaction with state transparent. Interactions with state become traceable in contrast to chains built with components and properties.
+
+Perhaps it is resonable to configure [strict mode](https://vuex.vuejs.org/api/#strict) in the future (for development). State changes should only be allowed through `actions` and `mutations`.
+
+Besides traceability vuex allows to dumb down components.
+
+## We chose [prettier](https://prettier.io/) in combination with [eslint](https://eslint.org/)
+
+To enforce tight styling guidelines (e.g. avoidance of problems with [semicolons](https://eslint.org/docs/rules/no-unexpected-multiline)) and strict formatting rules, prettier was chosen. Prettier as a plugin is widey supported:
+
+- [vim](https://github.com/prettier/vim-prettier)
+- [emacs](https://github.com/prettier/prettier-emacs)
+- [VSCode](https://github.com/prettier/prettier-vscode)
+
+On top, there is [pretty quick](https://www.npmjs.com/package/pretty-quick) a tool, which allows autmatically solving linting issues for you.
+
+Overall prettier makes styling issues a non-issue: You get achieve styled code as a result. Code which is automatically formatted is easier to read for humans (it is in every project the same guideline) and easier to read for machines (which offer help like `pretty-quick`).
+
+Similar philosophy as behind [gofmt](https://golang.org/cmd/gofmt/)
+
+## We chose [env](https://github.com/motdotla/dotenv) as configurtion file format
+
+It is good practice to store configuration in the environment (see [12 factor app](https://12factor.net/config)).
+From this idea evolved the practice to use `.env` files for configuring the environment.
+`.env` is a standard widely supported, e.g.
+
+- [go](https://github.com/joho/godotenv)
+- [Node](https://www.npmjs.com/package/dotenv)
+- [Webpack](https://www.npmjs.com/package/dotenv-webpack)
+
+Last but not least: `.env` is the format, which is used by [vue-cli](https://cli.vuejs.org/guide/mode-and-env.html)
+
 # Translation
 
 We want to internationalize our application for the following
 languages:
 
-* EN
-* DE
-* SK
-* HU
-* HR
-* RS
-* BiH
-* BG
-* RO
-* UA
+- EN
+- DE
+- SK
+- HU
+- HR
+- RS
+- BiH
+- BG
+- RO
+- UA
 
 ## Our preferred translation cycle is as follows:
 
@@ -29,13 +96,14 @@
       $gettext("Dear Sir") opposed to $("greeting")
 
 Downsides:
-* At present (July 2018) there are some annoying issues, which demand quirky solutions:
+
+- At present (July 2018) there are some annoying issues, which demand quirky solutions:
 
-  * [xgettext fails with some .vue files](https://github.com/Polyconseil/vue-gettext/issues/28) which forces us to use `(`, `)` around templates
-  *  [translations in attributes](https://github.com/Polyconseil/vue-gettext/issues/9) which leaves us with either interpolating in templates with `<translate></translate>` or use computed properties in Vue components (cf. Login component).
-* Is dependend on external (=non JS) tools (`xgettext`) which are not able to consume `.vue`-files directly, which in turn leads to unexpected behaviour.
-*
+  - [xgettext fails with some .vue files](https://github.com/Polyconseil/vue-gettext/issues/28) which forces us to use `(`, `)` around templates
+  - [translations in attributes](https://github.com/Polyconseil/vue-gettext/issues/9) which leaves us with either interpolating in templates with `<translate></translate>` or use computed properties in Vue components (cf. Login component).
 
+- Is dependend on external (=non JS) tools (`xgettext`) which are not able to consume `.vue`-files directly, which in turn leads to unexpected behaviour.
+-
 
 ## Commands