Merge branch 'master' of git.gesis.org:dda/dda-wizard

README.MD

@@ -198,15 +198,43 @@ cd ~/git/dda-wizard/
 mvn
 ```
 
+Bower is used to manage CSS and JavaScript dependencies. You can upgrade dependencies by specifying a newer version in file `bower.json`. You can also run `bower update` and `bower install` to manage dependencies.
+Add the `-h` flag on any command to see how you can use it. For example, `bower update -h`.
+
+For the development of the front-end, the command `grunt serve` can be executed to start a browser-sync session.
+
+## Known errors while building
+Trying to build DDA can produce some errors due to old dependencies.
+Currently known are problems with customizr and phantomjs.
+
 If the first command (npm install) does not work out because of a customizr tarball validity then try the following instead:
 ```
 npm cache clear --force && npm install --no-shrinkwrap --update-binary
 ```
 
-Bower is used to manage CSS and JavaScript dependencies. You can upgrade dependencies by specifying a newer version in file `bower.json`. You can also run `bower update` and `bower install` to manage dependencies.
-Add the `-h` flag on any command to see how you can use it. For example, `bower update -h`.
+Another error you might get is "Failed at the phantomjs@1.9.18 install script."
+The detailed error that caused this is:
 
-For the development of the front-end, the command `grunt serve` can be executed to start a browser-sync session.
+```
+Downloading https://bitbucket.org/ariya/phantomjs/downloads/phantomjs-1.9.8-windows.zip
+Saving to C:\cygwin64\tmp\phantomjs\phantomjs-1.9.8-windows.zip
+Receiving...
+  [=============---------------------------] 32% 0.0s
+Error requesting archive.
+Status: 404
+```
+
+The download of phantomjs through cygwin on Windows 10 failed multiple times. If you encounter this error, download the zip-file yourself (your url might vary, depending on your OS and used method of building), and copy it to the path specified next to "Saving to".
+
+Re-run the npm-command, and the zip-file should be used, and extracted to the correct folder.
+
+```
+Download already available at C:\cygwin64\tmp\phantomjs\phantomjs-1.9.8-windows.zip
+Extracting zip contents
+Copying extracted folder C:\cygwin64\tmp\phantomjs\phantomjs-1.9.8-windows.zip-extract-1597152396837\phantomjs-1.9.8-windows -> C:\Users\fischetm\git\dda-wizard\node_modules\phantomjs\lib\phantom
+Writing location.js file
+Done. Phantomjs binary available at C:\Users\fischetm\git\dda-wizard\node_modules\phantomjs\lib\phantom\phantomjs.exe
+```
 
 ## Staging
 ### Initial setup