Merge pull request #1219 from SUSE/docs-improvements

Improve documentation

docs/development.md

@@ -2,6 +2,7 @@
 
 > **Note:** This document is work in progress.
 
+
 The Stratos Console UI provides a single comprehensive and ubiquitous user 
 experience for: discovering, composing, developing and managing Cloud Native 
 workloads which are hosted in a myriad of: public, managed and private 
@@ -153,6 +154,13 @@ $ gulp dev
 
 In both cases the console should be available via https://localhost:3100
 
+> **Note:** If you see the following error when running 'gulp dev' you may need to increase your OS ulimit.
+```
+Error: ENFILE: file table overflow, scandir <snip>;
+    at Error (native)
+-bash: /dev/null: Too many open files in system
+```
+
 ### Linting
 We use eslint to executing linting. To run these execute...
 ```