Give example of how and where to report build failures

README

@@ -190,3 +190,24 @@ In order to build the documentation, enter the command
  make doc
 
 in the topmost directory.
+
+
+REPORTING ISSUES
+----------------
+
+Issues can be reported in the Git issue tracker online at:
+
+    http://github.com/OPM/opm-core/issues
+
+To help diagnose build errors, please provide a link to a build log together
+with the issue description.
+
+You can capture such a log from the build using the `script' utility, e.g.:
+
+    LOGFILE=$(date +%Y%m%d-%H%M-)build.log ;
+	cmake -E cmake_echo_color --cyan --bold "Log file: $LOGFILE" ;
+    script -q $LOGFILE -c 'cmake ../opm-core -DCMAKE_BUILD_TYPE=Debug' &&
+    script -q $LOGFILE -a -c 'ionice nice make -j 4 -l 3' ||
+    cat CMakeCache.txt CMakeFiles/CMake*.log >> $LOGFILE
+
+The resulting file can be uploaded to for instance gist.github.com.