From 7839b3c3ec721e08921b8e76aa6e72f9b0d0a7d7 Mon Sep 17 00:00:00 2001
From: Roberto Polli <roberto.polli@par-tec.it>
Date: Thu, 25 Feb 2021 16:31:13 +0100
Subject: [PATCH] Reformat with phptidy.

---
 bib.php                      | 116 +++++++-----
 data.php                     | 339 +++++++++++++++++++++--------------
 detail.php                   | 176 ++++++++++--------
 functions.php                | 273 ++++++++++++++++++----------
 graph.php                    | 138 ++++++++------
 head.php                     | 224 ++++++++++++++---------
 index.php                    |   8 +-
 mappings.php                 | 190 +++++++++++---------
 md.php                       |  10 +-
 navi.php                     |  51 ++++--
 newFolder-Migration-2021.php |  72 ++++----
 report-samm.php              |  74 ++++----
 report.php                   |  73 ++++----
 scutter.php                  |  67 ++++---
 spiderweb.php                |  13 +-
 spiderwebData.php            | 224 +++++++++++++----------
 test-yaml.php                |  28 ++-
 usefulnessHardness.php       | 317 +++++++++++++++++---------------
 18 files changed, 1421 insertions(+), 972 deletions(-)

diff --git a/bib.php b/bib.php
index dfbe16a62..be043462f 100644
--- a/bib.php
+++ b/bib.php
@@ -1,4 +1,13 @@
 <?php
+/**
+ * bib.php
+ *
+ * @package default
+ * @see head.php
+ * @see spiderwebData.php
+ */
+
+
 require __DIR__ . '/vendor/autoload.php';
 ini_set('display_errors', 1);
 ini_set('display_startup_errors', 1);
@@ -6,57 +15,82 @@
 define('NUMBER_LEVELS', 4);
 define('IS_SHOW_EVIDENCE_TODO', false);
 
-function readCSV($filename, $delimiter)
-{
-    if (!file_exists($filename) || !is_readable($filename))
-        return FALSE;
-
-    $header = NULL;
-    $data = array();
-    if (($handle = fopen($filename, 'r')) !== FALSE) {
-        while (($row = fgetcsv($handle, 1000, $delimiter)) !== FALSE) {
-            if (!$header)
-                $header = $row;
-            else
-                $data[] = array_combine($header, $row);
-        }
-        fclose($handle);
+
+/**
+ *
+ * @param unknown $filename
+ * @param unknown $delimiter
+ * @return unknown
+ */
+function readCSV($filename, $delimiter) {
+  if (!file_exists($filename) || !is_readable($filename))
+    return FALSE;
+
+  $header = NULL;
+  $data = array();
+  if (($handle = fopen($filename, 'r')) !== FALSE) {
+    while (($row = fgetcsv($handle, 1000, $delimiter)) !== FALSE) {
+      if (!$header)
+        $header = $row;
+      else
+        $data[] = array_combine($header, $row);
     }
-    return $data;
+    fclose($handle);
+  }
+  return $data;
 }
 
-function elementIsSelected($activityName)
-{
-    foreach (getCsv() as $element) {
-        if ($activityName == $element["element"]) {
-            return true;
-        }
+
+/**
+ *
+ * @param unknown $activityName
+ * @return unknown
+ */
+function elementIsSelected($activityName) {
+  foreach (getCsv() as $element) {
+    if ($activityName == $element["element"]) {
+      return true;
     }
-    return false;
+  }
+  return false;
 }
 
+
 $csvFile = 'selectedData.csv';
+
+
+/**
+ *
+ * @return unknown
+ */
 function getCsv() {
-    $csvFile = 'selectedData.csv';
-    $csv= readCSV($csvFile, ",");
-    return $csv;
+  $csvFile = 'selectedData.csv';
+  $csv= readCSV($csvFile, ",");
+  return $csv;
 }
 
+
+/**
+ *
+ * @param unknown $array
+ * @param unknown $index
+ * @return unknown
+ */
 function getFlattenedArray($array, $index) {
-    if(!array_key_exists($index, $array)) {
-        return "TODO";   
-    }
+  if (!array_key_exists($index, $array)) {
+    return "TODO";
+  }
 
-    $return = "";
-    $potentialArray = $array[$index];
-    if(is_array($potentialArray)) {
-        $return .= "<ul>";
-        foreach($potentialArray as $element => $content) {
-            $return .= "<li>$content</li>";
-        }
-        $return .= "</ul>";
-    }else {
-        $return .= $potentialArray;
+  $return = "";
+  $potentialArray = $array[$index];
+  if (is_array($potentialArray)) {
+    $return .= "<ul>";
+    foreach ($potentialArray as $element => $content) {
+      $return .= "<li>$content</li>";
     }
-    return $return;
-}
\ No newline at end of file
+    $return .= "</ul>";
+  }else {
+    $return .= $potentialArray;
+  }
+  return $return;
+}
diff --git a/data.php b/data.php
index e09c15234..8e5d255f6 100644
--- a/data.php
+++ b/data.php
@@ -1,5 +1,23 @@
 <?php
-require_once("functions.php");
+/**
+ * data.php
+ *
+ * @package default
+ * @see detail.php
+ * @see graph.php
+ * @see index.php
+ * @see mappings.php
+ * @see md.php
+ * @see report-samm.php
+ * @see report.php
+ * @see scutter.php
+ * @see spiderweb.php
+ * @see spiderwebData.php
+ * @see usefulnessHardness.php
+ */
+
+
+require_once "functions.php";
 
 // get form data
 $showPerformed = ($_GET['performed'] ?? false) == "true" ? "true" : false;
@@ -9,184 +27,231 @@
 
 // Create filteredDimensions
 $filteredDimensions = array();
-foreach(getActions($dimensions) as list($dimension, $subdimension, $activities)) {
-    foreach ($activities as $activityName => $activity) {
-        if (elementIsSelected($activityName) && !$showPerformed) {
-            continue;
-        }
+foreach (getActions($dimensions) as list($dimension, $subdimension, $activities)) {
+  foreach ($activities as $activityName => $activity) {
+    if (elementIsSelected($activityName) && !$showPerformed) {
+      continue;
+    }
 
-        if (!elementIsSelected($activityName) && !$showPlanned) {
-            continue;
-        }
-        $filteredDimensions[$dimension][$subdimension][$activityName] = $activity;
+    if (!elementIsSelected($activityName) && !$showPlanned) {
+      continue;
     }
+    $filteredDimensions[$dimension][$subdimension][$activityName] = $activity;
+  }
 }
 
 
-function getDifficultyOfImplementationWithDependencies($dimensions, $elementImplementation, &$allElements)
-{
-    $aggregated = ($_GET['aggregated'] ?? false) == "true" ? "true" : false;
-    if ($elementImplementation == null) {
-        return;
-    }
-    $knowledge = getKnowledge($elementImplementation);
+/**
+ *
+ * @param unknown $dimensions
+ * @param unknown $elementImplementation
+ * @param unknown $allElements           (reference)
+ */
+function getDifficultyOfImplementationWithDependencies($dimensions, $elementImplementation, &$allElements) {
+  $aggregated = ($_GET['aggregated'] ?? false) == "true" ? "true" : false;
+  if ($elementImplementation == null) {
+    return;
+  }
+  $knowledge = getKnowledge($elementImplementation);
 
-    $allElements[] = $knowledge;
-    $allElements[] = $elementImplementation['difficultyOfImplementation']["time"];
-    $allElements[] = $elementImplementation['difficultyOfImplementation']["time"];
-    $allElements[] = $elementImplementation['difficultyOfImplementation']["resources"];
+  $allElements[] = $knowledge;
+  $allElements[] = $elementImplementation['difficultyOfImplementation']["time"];
+  $allElements[] = $elementImplementation['difficultyOfImplementation']["time"];
+  $allElements[] = $elementImplementation['difficultyOfImplementation']["resources"];
 
-    if (array_key_exists('dependsOn', $elementImplementation) && $aggregated == "true") {
-        foreach ($elementImplementation['dependsOn'] as $dependency) {
-            $dependencyElement = getActivity($dimensions, $dependency);
-            getDifficultyOfImplementationWithDependencies($dimensions, $dependencyElement, $allElements);
+  if (array_key_exists('dependsOn', $elementImplementation) && $aggregated == "true") {
+    foreach ($elementImplementation['dependsOn'] as $dependency) {
+      $dependencyElement = getActivity($dimensions, $dependency);
+      getDifficultyOfImplementationWithDependencies($dimensions, $dependencyElement, $allElements);
 
 
-            $knowledge = getKnowledge($elementImplementation);
+      $knowledge = getKnowledge($elementImplementation);
 
-            $allElements[] = $knowledge;
-            $allElements[] = $elementImplementation['difficultyOfImplementation']["time"];
-            $allElements[] = $elementImplementation['difficultyOfImplementation']["time"];
-            $allElements[] = $elementImplementation['difficultyOfImplementation']["resources"];
-        }
+      $allElements[] = $knowledge;
+      $allElements[] = $elementImplementation['difficultyOfImplementation']["time"];
+      $allElements[] = $elementImplementation['difficultyOfImplementation']["time"];
+      $allElements[] = $elementImplementation['difficultyOfImplementation']["resources"];
     }
+  }
 }
 
-function getDifficultyOfImplementation($dimensions, $elementImplementation)
-{
-    $aggregated = ($_GET['aggregated'] ?? false) == "true" ? "true" : false;
-    if ($elementImplementation == null) {
-        return;
-    }
-    $knowledge = getKnowledge($elementImplementation);
 
+/**
+ *
+ * @param unknown $dimensions
+ * @param unknown $elementImplementation
+ * @return unknown
+ */
+function getDifficultyOfImplementation($dimensions, $elementImplementation) {
+  $aggregated = ($_GET['aggregated'] ?? false) == "true" ? "true" : false;
+  if ($elementImplementation == null) {
+    return;
+  }
+  $knowledge = getKnowledge($elementImplementation);
 
-    $value = $knowledge + $elementImplementation['difficultyOfImplementation']["time"] * 2 + $elementImplementation['difficultyOfImplementation']["resources"];
-    $value = $value / 4;
 
-    if (array_key_exists('dependsOn', $elementImplementation) && $aggregated == "true") {
-        foreach ($elementImplementation['dependsOn'] as $dependency) {
-            $dependencyElement = getActivity($dimensions, $dependency);
-            $value += getDifficultyOfImplementation($dimensions, $dependencyElement);
-        }
-    }
-    if ($value > 5) {
-        $value = 5;
+  $value = $knowledge + $elementImplementation['difficultyOfImplementation']["time"] * 2 + $elementImplementation['difficultyOfImplementation']["resources"];
+  $value = $value / 4;
+
+  if (array_key_exists('dependsOn', $elementImplementation) && $aggregated == "true") {
+    foreach ($elementImplementation['dependsOn'] as $dependency) {
+      $dependencyElement = getActivity($dimensions, $dependency);
+      $value += getDifficultyOfImplementation($dimensions, $dependencyElement);
     }
+  }
+  if ($value > 5) {
+    $value = 5;
+  }
 
-    return number_format((float)$value, 2, '.', '');
+  return number_format((float)$value, 2, '.', '');
 }
 
-function getKnowledge($elementImplementation)
-{
-    $knowledge = $elementImplementation['difficultyOfImplementation']["knowledge"];
-    if (is_array($knowledge)) {
-        $sum = 0;
-        // areas = operation, development, expertise, security
-        $areaCount = 4;
-        foreach ($knowledge as $knowledgeAttribute) {
-            $sum += $knowledgeAttribute;
-        }
-        $knowledge = $sum / $areaCount;
+
+/**
+ *
+ * @param unknown $elementImplementation
+ * @return unknown
+ */
+function getKnowledge($elementImplementation) {
+  $knowledge = $elementImplementation['difficultyOfImplementation']["knowledge"];
+  if (is_array($knowledge)) {
+    $sum = 0;
+    // areas = operation, development, expertise, security
+    $areaCount = 4;
+    foreach ($knowledge as $knowledgeAttribute) {
+      $sum += $knowledgeAttribute;
     }
-    return $knowledge;
+    $knowledge = $sum / $areaCount;
+  }
+  return $knowledge;
 }
 
-function getElementContentAndCheckExistence($parent, $name)
-{
-    if (array_key_exists($name, $parent)) {
-        return getElementContent($parent[$name]);
-    }
-    return "";
+
+/**
+ *
+ * @param unknown $parent
+ * @param unknown $name
+ * @return unknown
+ */
+function getElementContentAndCheckExistence($parent, $name) {
+  if (array_key_exists($name, $parent)) {
+    return getElementContent($parent[$name]);
+  }
+  return "";
 }
 
-function getElementContent($element)
-{
-    $Extra = new ParsedownExtra();
-    if (!is_array($element)){
-        return str_replace("\"", "'", $element);
-    }
-    if (isAssoc($element)) {
-        $contentString = "";
-        foreach ($element as $title => $elementContent) {
-            $titleWithSpace = preg_replace('/(?<=[a-z])[A-Z]|[A-Z](?=[a-z])/', ' $0', $title);
-            $contentString .= "<b>" . ucfirst($titleWithSpace) . "</b>";
-            $contentString .= "<ul>";
-            if (is_array($elementContent)) {
-                $contentString .= getElementContent($elementContent);
-            } else
-                $contentString .= "<li>" . $Extra->text($elementContent) . "</li>";
-            $contentString .= "</ul>";
-        }
-        return $contentString;
-
-    } 
-    
-    // default
-    $contentString = "<ul>";
-    foreach ($element as $content) {
-        $contentString .= "<li>" . $Extra->text($content) . "</li>";
-    }
-    $contentString .= "</ul>";
 
+/**
+ *
+ * @param unknown $element
+ * @return unknown
+ */
+function getElementContent($element) {
+  $Extra = new ParsedownExtra();
+  if (!is_array($element)) {
+    return str_replace("\"", "'", $element);
+  }
+  if (isAssoc($element)) {
+    $contentString = "";
+    foreach ($element as $title => $elementContent) {
+      $titleWithSpace = preg_replace('/(?<=[a-z])[A-Z]|[A-Z](?=[a-z])/', ' $0', $title);
+      $contentString .= "<b>" . ucfirst($titleWithSpace) . "</b>";
+      $contentString .= "<ul>";
+      if (is_array($elementContent)) {
+        $contentString .= getElementContent($elementContent);
+      } else
+        $contentString .= "<li>" . $Extra->text($elementContent) . "</li>";
+      $contentString .= "</ul>";
+    }
     return $contentString;
+
+  }
+
+  // default
+  $contentString = "<ul>";
+  foreach ($element as $content) {
+    $contentString .= "<li>" . $Extra->text($content) . "</li>";
+  }
+  $contentString .= "</ul>";
+
+  return $contentString;
 }
 
-function isAssoc(array $arr)
-{
-    if (array() === $arr) return false;
-    return array_keys($arr) !== range(0, count($arr) - 1);
+
+/**
+ *
+ * @param array   $arr
+ * @return unknown
+ */
+function isAssoc(array $arr) {
+  if (array() === $arr) return false;
+  return array_keys($arr) !== range(0, count($arr) - 1);
 }
 
 
+/**
+ *
+ * @param unknown $risk
+ * @return unknown
+ */
 function render_risk($risk) {
 
-    if (is_array($risk)) {
-        return implode("\ ", $risk);
-    }
-    return $risk;
+  if (is_array($risk)) {
+    return implode("\ ", $risk);
+  }
+  return $risk;
 }
+
+
 /**
  * Render an activity in a tooltip.
+ *
+ * @param unknown $array
+ * @param unknown $headerWeight (optional)
+ * @return unknown
  */
-function build_table_tooltip($array, $headerWeight = 2)
-{
-    $mapKnowLedge = array("Very Low (one discipline)", "Low (one discipline)", "Medium (two disciplines)", "High (two disciplines)", "Very High (three or more disciplines)");
-    $mapTime = array("Very Low", "Low", "Medium", "High", "Very High");
-    $mapResources = $mapTime;
-    $mapUsefulness = $mapTime;
-
-    getElementContentAndCheckExistence($array, "meta");
-    $evidenceContent = getElementContentAndCheckExistence($array, "evidence");
-    if ($evidenceContent == "") {
-        $evidenceContent = "TODO";
-    }
+function build_table_tooltip($array, $headerWeight = 2) {
+  $mapKnowLedge = array("Very Low (one discipline)", "Low (one discipline)", "Medium (two disciplines)", "High (two disciplines)", "Very High (three or more disciplines)");
+  $mapTime = array("Very Low", "Low", "Medium", "High", "Very High");
+  $mapResources = $mapTime;
+  $mapUsefulness = $mapTime;
+
+  getElementContentAndCheckExistence($array, "meta");
+  $evidenceContent = getElementContentAndCheckExistence($array, "evidence");
+  if ($evidenceContent == "") {
+    $evidenceContent = "TODO";
+  }
 
-    $html = "";
-    $html .= "<h" . $headerWeight . ">Risk and Opportunity</h$headerWeight>";
-    $html .= "<div><b>" . "Risk" . ":</b> " . render_risk($array['risk']) . "</div>";
-    $html .= "<div><b>" . "Opportunity" . ":</b> " . $array['measure'] . "</div>";
-    if (IS_SHOW_EVIDENCE_TODO || $evidenceContent != "TODO")
-        $html .= "<div><b>" . "Evidence" . ":</b> " . $evidenceContent . "</div>";
-    $html .= "<hr />";
-    $html .= "<h$headerWeight>Exploit details</h$headerWeight>";
-    $html .= "<div><b>Usefullness:</b> " . ucfirst($mapUsefulness[$array['usefulness'] - 1]) . "</div>";
-    $html .= "<div><b>Required knowledge:</b> " . ucfirst($mapKnowLedge[$array['difficultyOfImplementation']['knowledge'] - 1]) . "</div>";
-    $html .= "<div><b>Required time:</b> " . ucfirst($mapTime[$array['difficultyOfImplementation']['time'] - 1]) . "</div>";
-    $html .= "<div><b>Required resources (systems):</b> " . ucfirst($mapResources[$array['difficultyOfImplementation']['resources'] - 1]) . "</div>";
-    return $html;
+  $html = "";
+  $html .= "<h" . $headerWeight . ">Risk and Opportunity</h$headerWeight>";
+  $html .= "<div><b>" . "Risk" . ":</b> " . render_risk($array['risk']) . "</div>";
+  $html .= "<div><b>" . "Opportunity" . ":</b> " . $array['measure'] . "</div>";
+  if (IS_SHOW_EVIDENCE_TODO || $evidenceContent != "TODO")
+    $html .= "<div><b>" . "Evidence" . ":</b> " . $evidenceContent . "</div>";
+  $html .= "<hr />";
+  $html .= "<h$headerWeight>Exploit details</h$headerWeight>";
+  $html .= "<div><b>Usefullness:</b> " . ucfirst($mapUsefulness[$array['usefulness'] - 1]) . "</div>";
+  $html .= "<div><b>Required knowledge:</b> " . ucfirst($mapKnowLedge[$array['difficultyOfImplementation']['knowledge'] - 1]) . "</div>";
+  $html .= "<div><b>Required time:</b> " . ucfirst($mapTime[$array['difficultyOfImplementation']['time'] - 1]) . "</div>";
+  $html .= "<div><b>Required resources (systems):</b> " . ucfirst($mapResources[$array['difficultyOfImplementation']['resources'] - 1]) . "</div>";
+  return $html;
 }
 
 
-function getActivity($dimensions, $name)
-{
-    foreach ($dimensions as $dimensionName => $subDimension) {
-        foreach ($subDimension as $subDimensionName => $activities) {
-            foreach ($activities as $activityName => $activity) {
-                if ($activityName == $name) {
-                    return $activity;
-                }
-            }
+/**
+ *
+ * @param unknown $dimensions
+ * @param unknown $name
+ * @return unknown
+ */
+function getActivity($dimensions, $name) {
+  foreach ($dimensions as $dimensionName => $subDimension) {
+    foreach ($subDimension as $subDimensionName => $activities) {
+      foreach ($activities as $activityName => $activity) {
+        if ($activityName == $name) {
+          return $activity;
         }
+      }
     }
+  }
 }
diff --git a/detail.php b/detail.php
index ebfd15c0c..90ca0101e 100644
--- a/detail.php
+++ b/detail.php
@@ -1,7 +1,16 @@
 <?php
+/**
+ * detail.php
+ *
+ * @package default
+ * @see mappings.php
+ * @see report-samm.php
+ * @see report.php
+ */
+
 
 if (array_key_exists("element", $_GET)) {
-    $title = "Details for '" . htmlspecialchars($_GET['element']) . "'";
+  $title = "Details for '" . htmlspecialchars($_GET['element']) . "'";
 }
 include_once "head.php";
 ?>
@@ -14,93 +23,108 @@
 $subdimension = $_GET['subdimension'] ?? null;
 $activityName = $_GET['element'] ?? null;
 
-function printDetail($dimension, $subdimension, $activityName, $dimensions, $report = false)
-{
-    $element = $dimensions[$dimension][$subdimension][$activityName] ?? null;
 
-    if ($element == null) { //Whitelist approach for security reasons (deny XSS)
-        //echo "Sorry, we could not found the element";
-        return;
+/**
+ *
+ * @param unknown $dimension
+ * @param unknown $subdimension
+ * @param unknown $activityName
+ * @param unknown $dimensions
+ * @param unknown $report       (optional)
+ */
+function printDetail($dimension, $subdimension, $activityName, $dimensions, $report = false) {
+  $element = $dimensions[$dimension][$subdimension][$activityName] ?? null;
+
+  if ($element == null) { //Whitelist approach for security reasons (deny XSS)
+    //echo "Sorry, we could not found the element";
+    return;
+  }
+  if ($report) {
+    $headerWeight = 3;
+  } else {
+    $headerWeight = 1;
+  }
+
+  $pageH1 = "";
+  if (!$report) {
+    $pageH1 .= $dimension;
+
+    if ($dimension != $subdimension) {
+
+      $pageH1 .= " -> $subdimension";
+    }
+    $pageH1 .= ": $activityName";
+  } else {
+    $pageH1 .= "$activityName";
+  }
+
+  echo "<h$headerWeight>$pageH1</h$headerWeight>";
+  echo build_table_tooltip($element, $headerWeight + 1);
+  echo "<hr/>";
+
+  if (array_key_exists("dependsOn", $element) || array_key_exists("implementation", $element) || array_key_exists("comment", $element) || array_key_exists("meta", $element)) {
+    echo "<h" . ($headerWeight + 1) . ">Additional Information</h" . ($headerWeight + 1) . ">";
+    if (array_key_exists("dependsOn", $element)) {
+      $dependsOn = $element['dependsOn'];
+      $dependencies =  implode(", ", $dependsOn);
+      echo "<div><b>Dependencies:</b> $dependencies</div>";
     }
-    if ($report) {
-        $headerWeight = 3;
-    } else {
-        $headerWeight = 1;
+    echo getElementContentAndCheckExistence($element, "meta");
+  }
+
+
+  if (array_key_exists("md-description", $element) && !empty($element['md-description'])) {
+    echo "<div style=\"background: #F5F5F5\"";
+    echo $element['md-description'];
+    echo "</div>";
+  }
+  if (array_key_exists("implementation", $element) && !empty($element['implementation'])) {
+    $implementation = $element['implementation'];
+    echo "<div><b>Implementation hints:</b> ";
+    if (is_array($implementation)) {
+      echo "<ul>";
+      foreach ($implementation as $implementationElement) {
+        echo "<li>$implementationElement</li>";
+      }
+      echo "</ul>";
+    }else {
+      echo $implementation;
     }
+    echo "</div>";
+  }
 
-    $pageH1 = "";
-    if (!$report) {
-        $pageH1 .= $dimension;
+  if (array_key_exists("comment", $element) && !empty($element['comment'])) {
+    $comment = $element['comment'];
+    echo "<div><b>Comments:</b> $comment</div>";
+  }
 
-        if ($dimension != $subdimension) {
+  printReferences($element);
+}
 
-            $pageH1 .= " -> $subdimension";
-        }
-        $pageH1 .= ": $activityName";
-    } else {
-        $pageH1 .= "$activityName";
-    }
 
-    echo "<h$headerWeight>$pageH1</h$headerWeight>";
-    echo build_table_tooltip($element, $headerWeight + 1);
-    echo "<hr/>";
-
-    if (array_key_exists("dependsOn", $element) || array_key_exists("implementation", $element) || array_key_exists("comment", $element) || array_key_exists("meta", $element)) {
-        echo "<h" . ($headerWeight + 1) . ">Additional Information</h" . ($headerWeight + 1) . ">";
-        if (array_key_exists("dependsOn", $element)) {
-            $dependsOn = $element['dependsOn'];
-            $dependencies =  implode(", ", $dependsOn);
-            echo "<div><b>Dependencies:</b> $dependencies</div>";
-        }
-        echo getElementContentAndCheckExistence($element, "meta");
-    }
+/**
+ *
+ * @param unknown $element
+ */
+function printReferences($element) {
+  if (!array_key_exists("references", $element)) {
+    return;
+  }
+  $actionLabels = readYaml("data/strings.yml#/actionLabels");
 
+  $references = $element['references'];
+  foreach ($references as $r => $values) {
+    // if it's not an array, array-ze it. Remove after fixing all yamls.
+    $values = is_array($values) ? $values : array($values);
 
-    if (array_key_exists("md-description", $element) && !empty($element['md-description'])) {
-        echo "<div style=\"background: #F5F5F5\"";
-        echo $element['md-description'];
-        echo "</div>";
-    }
-    if (array_key_exists("implementation", $element) && !empty($element['implementation'])) {
-        $implementation = $element['implementation'];
-        echo "<div><b>Implementation hints:</b> ";
-        if(is_array($implementation)){
-            echo "<ul>";
-            foreach($implementation as $implementationElement) {
-                echo "<li>$implementationElement</li>";
-            }
-            echo "</ul>";
-        }else {
-            echo $implementation;
-        }
-        echo "</div>";
-    }
+    $label = getReferenceLabel($r);
+    echo "<div><h3>$label</h3></div>";
+    echo "<ul><li>".  implode("</li><li>", $values) ."</li></ul>";
+  }
 
-    if (array_key_exists("comment", $element) && !empty($element['comment'])) {
-        $comment = $element['comment'];
-        echo "<div><b>Comments:</b> $comment</div>";
-    }
 
-    printReferences($element);
 }
 
-function printReferences($element) {
-    if (!array_key_exists("references", $element)) {
-        return;
-    }
-    $actionLabels = readYaml("data/strings.yml#/actionLabels");
-
-    $references = $element['references'];
-    foreach ($references as $r => $values) {
-        // if it's not an array, array-ze it. Remove after fixing all yamls.
-        $values = is_array($values) ? $values : array($values);
 
-        $label = getReferenceLabel($r);
-        echo "<div><h3>$label</h3></div>";
-        echo "<ul><li>".  implode("</li><li>", $values) ."</li></ul>";
-    }
-    
-
-}
 // echo var_dump($dimensions);
-printDetail($dimension, $subdimension, $activityName, $dimensions);
\ No newline at end of file
+printDetail($dimension, $subdimension, $activityName, $dimensions);
diff --git a/functions.php b/functions.php
index a0a3079f7..de4a92a35 100644
--- a/functions.php
+++ b/functions.php
@@ -1,137 +1,218 @@
 <?php
+/**
+ * functions.php
+ *
+ * @package default
+ * @param unknown $file
+ * @return unknown
+ */
+
+
 function readYaml($file) {
-    $fragment = null;
-    if (strpos($file, "#") != false) {
-        list($file, $fragment) = explode("#", $file,  2);
-        $fragment = trim($fragment, "/ ");
+  $fragment = null;
+  if (strpos($file, "#") != false) {
+    list($file, $fragment) = explode("#", $file,  2);
+    $fragment = trim($fragment, "/ ");
+  }
+  $ret = yaml_parse(
+    file_get_contents($file)
+  );
+  if ($fragment) {
+    foreach (explode("/", $fragment) as $key) {
+      $ret = $ret[$key];
     }
-    $ret = yaml_parse(
-        file_get_contents($file)
-    );
-    if ($fragment) {
-        foreach (explode("/", $fragment) as $key) {
-          $ret = $ret[$key];
-        }
 
-    }
-    return $ret;
+  }
+  return $ret;
 }
 
+
 /**
  * Get dimensions from yaml file.
+ *
+ * @return unknown
  */
 function getDimensions() {
-    $dimensions = readYaml("data/dimensions.yaml");
-
-    // reorder in-place $dimensions. This should wrap readYaml(data/dimensions.yaml)
-    ksort($dimensions);
-    foreach ($dimensions as $dimensionName => $subDimension) {
-        ksort($subDimension);
-        foreach ($subDimension as $subDimensionName => $elements) {
-
-            // Q: should I retain this?
-            if (substr($subDimensionName, 0, 1) == "_")
-                continue;
-
-            // Upgrade old configuration to `references:`
-            //   this code can be modified to other models.
-            foreach ($elements as $activityName => $content) {
-                
-                if ($content["references"] ?? null) // ignore new lines
-                    continue;
-
-                $content["references"]["samm2"] = $content["samm2"] ?? array();
-                unset($content["samm2"]);
-                $content["references"]["iso27001-2017"] = $content["iso27001-2017"] ?? array();
-                unset($content["iso27001-2017"]);
-                //echo var_dump($elements[$activityName]);
-                //echo "<hr>";
-                $elements[$activityName] = $content;
-                
-            }
-            $newElements = $elements;
-            ksort($newElements);
-            $dimensions[$dimensionName][$subDimensionName] = $newElements;
-        }
+  $dimensions = readYaml("data/dimensions.yaml");
+
+  // reorder in-place $dimensions. This should wrap readYaml(data/dimensions.yaml)
+  ksort($dimensions);
+  foreach ($dimensions as $dimensionName => $subDimension) {
+    ksort($subDimension);
+    foreach ($subDimension as $subDimensionName => $elements) {
+
+      // Q: should I retain this?
+      if (substr($subDimensionName, 0, 1) == "_")
+        continue;
+
+      // Upgrade old configuration to `references:`
+      //   this code can be modified to other models.
+      foreach ($elements as $activityName => $content) {
+
+        if ($content["references"] ?? null) // ignore new lines
+          continue;
+
+        $content["references"]["samm2"] = $content["samm2"] ?? array();
+        unset($content["samm2"]);
+        $content["references"]["iso27001-2017"] = $content["iso27001-2017"] ?? array();
+        unset($content["iso27001-2017"]);
+        //echo var_dump($elements[$activityName]);
+        //echo "<hr>";
+        $elements[$activityName] = $content;
+
+      }
+      $newElements = $elements;
+      ksort($newElements);
+      $dimensions[$dimensionName][$subDimensionName] = $newElements;
     }
-    return $dimensions;
+  }
+  return $dimensions;
 }
 
-/** This function should be a sort of db wrapper. */
+
+/**
+ * This function should be a sort of db wrapper.
+ *
+ * @param unknown $dimensions
+ */
 function getActions($dimensions) {
-    ksort($dimensions);
-    foreach ($dimensions as $dimension => $subdimensions) {
-        ksort($subdimensions);
-
-        foreach ($subdimensions as $subdimension => $element) {
-            if (substr($subdimension, 0, 1) == "_")
-                continue;
-            yield array($dimension, $subdimension, $element);
-        }
+  ksort($dimensions);
+  foreach ($dimensions as $dimension => $subdimensions) {
+    ksort($subdimensions);
+
+    foreach ($subdimensions as $subdimension => $element) {
+      if (substr($subdimension, 0, 1) == "_")
+        continue;
+      yield array($dimension, $subdimension, $element);
     }
+  }
 }
 
-function getReferenceLabels(){
-    return readYaml("data/strings.yml#/strings/en/references");
+
+/**
+ *
+ * @return unknown
+ */
+function getReferenceLabels() {
+  return readYaml("data/strings.yml#/strings/en/references");
 }
+
+
+/**
+ *
+ * @param unknown $reference_id
+ * @return unknown
+ */
 function getReferenceLabel($reference_id) {
-    $referenceLabels = readYaml("data/strings.yml#/strings/en/references");
+  $referenceLabels = readYaml("data/strings.yml#/strings/en/references");
 
-    return $referenceLabels[$reference_id]["label"] ?? $reference_id;
+  return $referenceLabels[$reference_id]["label"] ?? $reference_id;
 }
 
-function thead($headings){
-    echo '<thead><tr><th scope="col">'
-        .implode('</th><th scope="col">', $headings)
-        .'</th></tr></thead>';
+
+/**
+ *
+ * @param unknown $headings
+ */
+function thead($headings) {
+  echo '<thead><tr><th scope="col">'
+    .implode('</th><th scope="col">', $headings)
+    .'</th></tr></thead>';
 }
 
+
+/**
+ *
+ * @param unknown $title
+ * @param unknown $html_content
+ * @param unknown $html_tooltip
+ * @return unknown
+ */
 function div_tooltip($title, $html_content, $html_tooltip) {
-    $tooltip =  "<div class='popoverdetails'>" .$html_tooltip . "</div>";
-    return "<div data-toggle=\"popover\" 
-        data-title=\"$title\" 
-        data-activity=\".$html_tooltip\" 
+  $tooltip =  "<div class='popoverdetails'>" .$html_tooltip . "</div>";
+  return "<div data-toggle=\"popover\"
+        data-title=\"$title\"
+        data-activity=\".$html_tooltip\"
         type=\"button\" data-html=\"true \">" . $html_content . "</div>";
 }
-function renderSamm($samm_reference){
-    return "$samm_reference";
+
+
+/**
+ *
+ * @param unknown $samm_reference
+ * @return unknown
+ */
+function renderSamm($samm_reference) {
+  return "$samm_reference";
 }
-function as_list($items){
-    if(is_array($items)){
-        yield from $items;
-    } else {
-        yield $items;
-    }
+
+
+/**
+ *
+ * @param unknown $items
+ */
+function as_list($items) {
+  if (is_array($items)) {
+    yield from $items;
+  } else {
+    yield $items;
+  }
 }
-function ul($samm_references, $callback='renderSamm') {
-    if( ! is_array($samm_references) ){
-        return ($callback)($samm_references);
-    }
 
-        $ret = "<ul><li>"
-            . implode("</li><li>", array_map($callback, $samm_references)) 
-            ."</li></ul>";
-    return $ret;
+
+/**
+ *
+ * @param unknown $samm_references
+ * @param unknown $callback        (optional)
+ * @return unknown
+ */
+function ul($samm_references, $callback='renderSamm') {
+  if ( ! is_array($samm_references) ) {
+    return ($callback)($samm_references);
+  }
+
+  $ret = "<ul><li>"
+    . implode("</li><li>", array_map($callback, $samm_references))
+    ."</li></ul>";
+  return $ret;
 }
+
+
+/**
+ *
+ * @param unknown $references
+ */
 function getReferences($references) {
-    foreach ($references as $r_name => $rlist) {
+  foreach ($references as $r_name => $rlist) {
 
-    }
+  }
 
 }
 
+
 // TODO create testcases
 
-function test_getActions(){
-    $dimensions = readYaml("data/dimensions.yaml");
-    echo var_dump(getActions($dimensions));
+
+/**
+ *
+ */
+function test_getActions() {
+  $dimensions = readYaml("data/dimensions.yaml");
+  echo var_dump(getActions($dimensions));
 }
+
+
+/**
+ *
+ */
 function test_readYaml() {
-    $ret = readYaml("data/strings.yml");
-    echo var_dump($ret);
-    echo "<hr>";
-    $ret = readYaml("data/strings.yml#/strings/en");
-    echo var_dump($ret);
-    echo "<hr>";
+  $ret = readYaml("data/strings.yml");
+  echo var_dump($ret);
+  echo "<hr>";
+  $ret = readYaml("data/strings.yml#/strings/en");
+  echo var_dump($ret);
+  echo "<hr>";
 }
-?>
\ No newline at end of file
+
+
+?>
diff --git a/graph.php b/graph.php
index 97ebc04a7..2b06f9758 100644
--- a/graph.php
+++ b/graph.php
@@ -1,4 +1,11 @@
 <?php
+/**
+ * graph.php
+ *
+ * @package default
+ */
+
+
 $title = "Dependencies";
 include_once "head.php";
 ?>
@@ -11,20 +18,27 @@
 <?php
 include_once "data.php";
 
-/** Return true if has dependsOn. */
+
+/**
+ * Return true if has dependsOn.
+ *
+ * @param unknown $activities
+ * @return unknown
+ */
 function hasElementChildren($activities) {
-    foreach ($activities as $activityName => $activity) {
-        if ($activity["dependsOn"] ?? null) 
-            return true;
-    }
-    return false;
+  foreach ($activities as $activityName => $activity) {
+    if ($activity["dependsOn"] ?? null)
+      return true;
+  }
+  return false;
 }
 
+
 foreach (getActions($dimensions) as list($dimension, $subdimension, $activities)) {
-    if (hasElementChildren($activities)) {
-        echo "<a href='#" . base64_encode($subdimension) 
-            . "'> $dimension - $subdimension </a><br />";
-    }
+  if (hasElementChildren($activities)) {
+    echo "<a href='#" . base64_encode($subdimension)
+      . "'> $dimension - $subdimension </a><br />";
+  }
 }
 ?>
     <style>
@@ -59,53 +73,59 @@ function hasElementChildren($activities) {
         }
     </style>
 <?php
-function getSourceAndParent($activityName, $subdimension, $parent = "")
-{
-    return "{source: \"$activityName\", target: \"$parent\", type: \"" . base64_encode($subdimension) . "\"}";
+/**
+ *
+ * @param unknown $activityName
+ * @param unknown $subdimension
+ * @param unknown $parent       (optional)
+ * @return unknown
+ */
+function getSourceAndParent($activityName, $subdimension, $parent = "") {
+  return "{source: \"$activityName\", target: \"$parent\", type: \"" . base64_encode($subdimension) . "\"}";
 }
 
 
 foreach (getActions($dimensions) as list($dimension, $subdimension, $element)) {
-        if(!hasElementChildren($element)) {
-            continue;
-        }
+  if (!hasElementChildren($element)) {
+    continue;
+  }
 
-        echo "<h2 id='" .urlencode( base64_encode($subdimension)) . "'>$dimension - $subdimension</h2>";
-        ?>
+  echo "<h2 id='" .urlencode( base64_encode($subdimension)) . "'>$dimension - $subdimension</h2>";
+?>
         <script>
             (function () {
                 var links = [
                     <?php
-                    $first = true;
-
-                    //if($subdimension != "Erzeugung") continue;
-                    foreach ($element as $activityName => $content) {
-                        if (!array_key_exists("dependsOn", $content)) {
-                            continue;
-                        }
-
-                        $parent = "Ohne";
-                        if (array_key_exists("dependsOn", $content)) {
-                            $parent = $content["dependsOn"][0];
-                        }
-                        if (array_key_exists("dependsOn", $content)) {
-                            foreach ($content["dependsOn"] as $dependsOn) {
-                                if (!$first) {
-                                    echo ",";
-                                }
-                                $first = false;
-                                echo getSourceAndParent($activityName, $subdimension, $dependsOn);
-                            }
-                        } else {
-                            if (!$first) {
-                                echo ",";
-                            }
-                            $first = false;
-                            echo getSourceAndParent($activityName, $subdimension, $parent);
-                        }
-
-                    }
-                    ?>
+  $first = true;
+
+  //if($subdimension != "Erzeugung") continue;
+  foreach ($element as $activityName => $content) {
+    if (!array_key_exists("dependsOn", $content)) {
+      continue;
+    }
+
+    $parent = "Ohne";
+    if (array_key_exists("dependsOn", $content)) {
+      $parent = $content["dependsOn"][0];
+    }
+    if (array_key_exists("dependsOn", $content)) {
+      foreach ($content["dependsOn"] as $dependsOn) {
+        if (!$first) {
+          echo ",";
+        }
+        $first = false;
+        echo getSourceAndParent($activityName, $subdimension, $dependsOn);
+      }
+    } else {
+      if (!$first) {
+        echo ",";
+      }
+      $first = false;
+      echo getSourceAndParent($activityName, $subdimension, $parent);
+    }
+
+  }
+?>
                 ]
                 var nodes = {};
 
@@ -135,17 +155,17 @@ function getSourceAndParent($activityName, $subdimension, $parent = "")
                 svg.append("defs").selectAll("marker")
                     .data([
                         <?php
-                        $isFirst = true;
-                        foreach ($dimensions as $dimension => $subdimensions) {
-                            foreach ($subdimensions as $subdimension => $element) {
-                                if (!$isFirst) {
-                                    echo ",";
-                                }
-                                $isFirst = false;
-                                echo "\"" .urlencode( base64_encode($subdimension) ). "\"";
-                            }
-                        }
-                        ?>
+  $isFirst = true;
+  foreach ($dimensions as $dimension => $subdimensions) {
+    foreach ($subdimensions as $subdimension => $element) {
+      if (!$isFirst) {
+        echo ",";
+      }
+      $isFirst = false;
+      echo "\"" .urlencode( base64_encode($subdimension) ). "\"";
+    }
+  }
+?>
                     ])
                     .enter().append("marker")
                     .attr("id", function (d) {
diff --git a/head.php b/head.php
index 4f8672eef..557518a42 100644
--- a/head.php
+++ b/head.php
@@ -1,3 +1,22 @@
+<?php
+/**
+ * head.php
+ *
+ * @package default
+ * @see detail.php
+ * @see graph.php
+ * @see index.php
+ * @see mappings.php
+ * @see md.php
+ * @see report-samm.php
+ * @see report.php
+ * @see scutter.php
+ * @see spiderweb.php
+ * @see usefulnessHardness.php
+ */
+
+
+?>
 <!DOCTYPE html >
 <html moznomarginboxes mozdisallowselectionprint>
 <head>
@@ -5,21 +24,21 @@
 
 <!-- Latest compiled and minified CSS -->
 <link rel="stylesheet"
-	href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap.min.css"
-	integrity="sha384-1q8mTJOASx8j1Au+a5WDVnPi2lkFfwwEAa8hDDdjZlpLegxhjVME1fgjWPGmkzs7"
-	crossorigin="anonymous">
+  href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap.min.css"
+  integrity="sha384-1q8mTJOASx8j1Au+a5WDVnPi2lkFfwwEAa8hDDdjZlpLegxhjVME1fgjWPGmkzs7"
+  crossorigin="anonymous">
 
 <!-- Optional theme -->
 <link rel="stylesheet"
-	href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap-theme.min.css"
-	integrity="sha384-fLW2N01lMqjakBkx3l/M9EahuwpSfeNvV63J5ezn3uZzapT0u7EYsXMjQV+0En5r"
-	crossorigin="anonymous">
+  href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap-theme.min.css"
+  integrity="sha384-fLW2N01lMqjakBkx3l/M9EahuwpSfeNvV63J5ezn3uZzapT0u7EYsXMjQV+0En5r"
+  crossorigin="anonymous">
 
 <!-- Latest compiled and minified JavaScript -->
 <script
-	src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/js/bootstrap.min.js"
-	integrity="sha384-0mSbJDEHialfmuBBQP6A4Qrprq5OVfW37PRR3j5ELqxss1yVqOtnepnHVP9aJ7xS"
-	crossorigin="anonymous"></script>
+  src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/js/bootstrap.min.js"
+  integrity="sha384-0mSbJDEHialfmuBBQP6A4Qrprq5OVfW37PRR3j5ELqxss1yVqOtnepnHVP9aJ7xS"
+  crossorigin="anonymous"></script>
 
 <link href="assets/css/common.css" rel="stylesheet">
 <link href="assets/css/nv.d3.css" rel="stylesheet">
@@ -30,7 +49,7 @@
 
     <!--https://yandex.st/highlightjs/7.3/styles/default.min.css-->
 <link rel="stylesheet"
-	href="assets/css/default.min.css">
+  href="assets/css/default.min.css">
 <link rel="stylesheet" href="spiderweb.css">
 
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
@@ -42,9 +61,9 @@
 
 <!-- Latest compiled and minified CSS -->
 <link rel="stylesheet"
-	href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap.min.css"
-	integrity="sha384-1q8mTJOASx8j1Au+a5WDVnPi2lkFfwwEAa8hDDdjZlpLegxhjVME1fgjWPGmkzs7"
-	crossorigin="anonymous" />
+  href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap.min.css"
+  integrity="sha384-1q8mTJOASx8j1Au+a5WDVnPi2lkFfwwEAa8hDDdjZlpLegxhjVME1fgjWPGmkzs7"
+  crossorigin="anonymous" />
 
 
 <link href="print.css" rel="spiderweb.css" />
@@ -52,9 +71,9 @@
 
 <meta name="keywords" content="DevSecOps, DevOps, security, hardening">
 <meta name="author" content="Timo Pagel">
-<?php 
-	$url = "https://dsomm.timo-pagel.de{$_SERVER['SCRIPT_NAME']}"; 
-	echo "<link rel='canonical' href=$url>";
+<?php
+$url = "https://dsomm.timo-pagel.de{$_SERVER['SCRIPT_NAME']}";
+echo "<link rel='canonical' href=$url>";
 ?>
 <script>
     $(function () {
@@ -69,86 +88,121 @@
 
 // I18N support information here
 $language = 'en';
-putenv ( "LANG=$language" );
-setlocale ( LC_ALL, $language );
+putenv( "LANG=$language" );
+setlocale( LC_ALL, $language );
 
 // Set the text domain as 'messages'
 $domain = 'messages';
-bindtextdomain ( $domain, "locale" );
-textdomain ( $domain );
+bindtextdomain( $domain, "locale" );
+textdomain( $domain );
+
+
+/**
+ *
+ * @return unknown
+ */
 function getTableHeader() {
-    $levels_labels = array_map(
-        function($item){
-            return "Level " . $item['level']. ": ". $item['label'];
-        },
-        readYaml("data/maturity-levels.yaml#/maturity-levels")
-    );
-    $headers = array_merge(
-        array ("Dimension", "Sub-Dimension"),
-        $levels_labels
-    );
-
-	return "<thead  class=\"thead-default\"><tr>"
-	    ."<th>" . implode("</th><th>", $headers) . "</th>"
-	    ."</tr></thead>";
+  $levels_labels = array_map(
+    function($item) {
+      return "Level " . $item['level']. ": ". $item['label'];
+    },
+    readYaml("data/maturity-levels.yaml#/maturity-levels")
+  );
+  $headers = array_merge(
+    array ("Dimension", "Sub-Dimension"),
+    $levels_labels
+  );
+
+  return "<thead  class=\"thead-default\"><tr>"
+    ."<th>" . implode("</th><th>", $headers) . "</th>"
+    ."</tr></thead>";
 }
+
+
+/**
+ *
+ * @param unknown $dimensions
+ * @return unknown
+ */
 function getInfos($dimensions) {
-	$text = "Activity Count: " . getElementCount ( $dimensions );
-	return $text;
+  $text = "Activity Count: " . getElementCount ( $dimensions );
+  return $text;
 }
+
+
+/**
+ *
+ * @param unknown $dimensions
+ * @return unknown
+ */
 function getElementCount($dimensions) {
-	$count = 0;
-    foreach ( getActions($dimensions) as list($dimension, $subdimension, $element) ) {
-        $count = $count + count ( $element );
-        echo "$subdimension: " . count ( $element ) . "<br>";
-	}
-	return $count;
+  $count = 0;
+  foreach ( getActions($dimensions) as list($dimension, $subdimension, $element) ) {
+    $count = $count + count( $element );
+    echo "$subdimension: " . count( $element ) . "<br>";
+  }
+  return $count;
 }
+
+
+/**
+ *
+ * @param unknown $dimensions
+ * @return unknown
+ */
 function getTable($dimensions) {
-	$tableContent = "";
-	$tableContent .= getTableHeader ();
-
-	foreach ( getActions($dimensions) as list($dimension, $subdimension, $element) ) {
-        $dimension_icon = isset($dimensions[$dimension]["_meta"]["icon"]) ? $dimensions[$dimension]["_meta"]["icon"] : "$dimension.png";
-        $dimension_label = isset($dimensions[$dimension]["_meta"]["label"]) ? $dimensions[$dimension]["_meta"]["label"] : "$dimension";
-
-        $tableContent .= "<tr>";
-        $tableContent .= "<td>";
-        $tableContent .= "<img height='40px' src=\"assets/images/$dimension_icon\"> $dimension_label";
-        $tableContent .= "</td>";
-
-        $tableContent .= "<td>";
-        $tableContent .= "$subdimension";
-        $tableContent .= "</td>";
-
-        for($i = 1; $i <= NUMBER_LEVELS; $i ++) {
-            $tableContent .= "<td><ul>";
-            foreach ( $element as $activityName => $content ) {
-                $content = getContentForLevelFromSubdimensions ( $i, $content, $activityName );
-                if ($content != "") {
-                    $activityLink = "detail.php?dimension=" . urlencode ( $dimension ) . "&subdimension=" . urlencode ( $subdimension ) . "&element=" . urlencode ( $activityName );
-                    $tableContent .= "<a href='$activityLink' data-dimension='$dimension' data-subdimension='$subdimension' data-element='$activityName'";
-                    if (elementIsSelected ( $activityName )) {
-                        $tableContent .= "class='selected'";
-                    }
-                    $tableContent .= "><li>" . $content . "</li></a>";
-                }
-            }
-            $tableContent .= "</ul></td>";
+  $tableContent = "";
+  $tableContent .= getTableHeader ();
+
+  foreach ( getActions($dimensions) as list($dimension, $subdimension, $element) ) {
+    $dimension_icon = isset($dimensions[$dimension]["_meta"]["icon"]) ? $dimensions[$dimension]["_meta"]["icon"] : "$dimension.png";
+    $dimension_label = isset($dimensions[$dimension]["_meta"]["label"]) ? $dimensions[$dimension]["_meta"]["label"] : "$dimension";
+
+    $tableContent .= "<tr>";
+    $tableContent .= "<td>";
+    $tableContent .= "<img height='40px' src=\"assets/images/$dimension_icon\"> $dimension_label";
+    $tableContent .= "</td>";
+
+    $tableContent .= "<td>";
+    $tableContent .= "$subdimension";
+    $tableContent .= "</td>";
+
+    for ($i = 1; $i <= NUMBER_LEVELS; $i ++) {
+      $tableContent .= "<td><ul>";
+      foreach ( $element as $activityName => $content ) {
+        $content = getContentForLevelFromSubdimensions ( $i, $content, $activityName );
+        if ($content != "") {
+          $activityLink = "detail.php?dimension=" . urlencode( $dimension ) . "&subdimension=" . urlencode( $subdimension ) . "&element=" . urlencode( $activityName );
+          $tableContent .= "<a href='$activityLink' data-dimension='$dimension' data-subdimension='$subdimension' data-element='$activityName'";
+          if (elementIsSelected ( $activityName )) {
+            $tableContent .= "class='selected'";
+          }
+          $tableContent .= "><li>" . $content . "</li></a>";
         }
-
-        $tableContent .= "</tr>";
-	}
-	$table = '<table class="table table-striped"><caption>OWASP DevSecOps Maturity Model</caption>';
-	$table .= $tableContent;
-	$table .= "</table>";
-	return $table;
+      }
+      $tableContent .= "</ul></td>";
+    }
+
+    $tableContent .= "</tr>";
+  }
+  $table = '<table class="table table-striped"><caption>OWASP DevSecOps Maturity Model</caption>';
+  $table .= $tableContent;
+  $table .= "</table>";
+  return $table;
 }
+
+
+/**
+ *
+ * @param unknown $level
+ * @param unknown $subdimension
+ * @param unknown $activityName
+ * @return unknown
+ */
 function getContentForLevelFromSubdimensions($level, $subdimension, $activityName) {
-	if ($level != $subdimension ["level"]) {
-		return "";
-	}
-	$tooltip = "<div class='popoverdetails'>" . build_table_tooltip ( $subdimension ) . "</div>";
-	return "<div data-toggle=\"popover\" data-title=\"$activityName\" data-content=\"$tooltip\" type=\"button\" data-html=\"true \">" . $activityName . "</div>";
+  if ($level != $subdimension ["level"]) {
+    return "";
+  }
+  $tooltip = "<div class='popoverdetails'>" . build_table_tooltip ( $subdimension ) . "</div>";
+  return "<div data-toggle=\"popover\" data-title=\"$activityName\" data-content=\"$tooltip\" type=\"button\" data-html=\"true \">" . $activityName . "</div>";
 }
-
diff --git a/index.php b/index.php
index a67fc2008..c421f1336 100644
--- a/index.php
+++ b/index.php
@@ -1,4 +1,11 @@
 <?php
+/**
+ * index.php
+ *
+ * @package default
+ */
+
+
 $title = gettext("Activities Overview");
 include_once "head.php";
 ?>
@@ -13,4 +20,3 @@
 echo "<h1>Activtities per Dimension</h1>";
 echo '<div class="extra">'.getInfos($dimensions) . '</div>';
 ?>
-
diff --git a/mappings.php b/mappings.php
index 17d3f4888..35499cc46 100644
--- a/mappings.php
+++ b/mappings.php
@@ -1,4 +1,11 @@
 <?php
+/**
+ * mappings.php
+ *
+ * @package default
+ */
+
+
 include_once "head.php";
 ?>
     <body>
@@ -19,13 +26,19 @@
 
 
 
+/**
+ *
+ * @param unknown $reference_id
+ * @param unknown $sort
+ * @return unknown
+ */
 function formCheck($reference_id, $sort) {
-        $checked = ($sort == $reference_id) ? "checked": "";
-        $reference_label = getReferenceLabel($reference_id);
-        return '
+  $checked = ($sort == $reference_id) ? "checked": "";
+  $reference_label = getReferenceLabel($reference_id);
+  return '
         <div class="form-radio">
         <input class="form-check-input" type="radio" name="sort"
-            id="radio'.$reference_id.'" 
+            id="radio'.$reference_id.'"
             value="'.$reference_id.'"
                 '. $checked. '
         <label class="form-check-label" for="exampleRadios2">'. ucwords($reference_label).'</label>
@@ -33,111 +46,112 @@ function formCheck($reference_id, $sort) {
         ';
 }
 
+
 ?>
 <form method="get">
     <div class="sort-by">
         Sort by:
         <?php
-        // Print form headers
-        echo formCheck("activity", $sort);
-        foreach ($referenceLabels as $r => $metadata) {
-            echo formCheck($r, $sort);
-        }
-        ?>
-    </div>  
+// Print form headers
+echo formCheck("activity", $sort);
+foreach ($referenceLabels as $r => $metadata) {
+  echo formCheck($r, $sort);
+}
+?>
+    </div>
     <div class="form-check">
         <input type="checkbox" class="form-check-input" name="performed" id="exampleCheck1" value="true"
-         <?php if($showPerformed) {echo " checked=checked";}?>>
+         <?php if ($showPerformed) {echo " checked=checked";}?>>
         <label class="form-check-label" for="exampleCheck1">Show performed activities</label>
   </div>
   <div class="form-check">
         <input type="checkbox" class="form-check-input" name="planned" id="exampleCheck2" value="true"
-         <?php if($showPlanned) {echo " checked=checked";} ?>>
+         <?php if ($showPlanned) {echo " checked=checked";} ?>>
         <label class="form-check-label" for="exampleCheck2">Show planned activities</label>
-  </div>  
+  </div>
   <button type="submit" class="btn btn-primary">Submit</button>
 </form>
 
 <?php
 
-if($sort == "activity") {
-
-    echo '<table class="table">';
-    $headings = array_merge($headings, array_keys(getReferenceLabels()));
-    thead($headings);
-
-    echo '<tbody>';
-    
-    foreach(getActions($filteredDimensions) as list($dimension, $subdimension, $activities)) {
-        foreach ($activities as $activityName => $activity) {
-            echo "<tr>";
-            echo "<td>$dimension</td>";
-            echo "<td>$subdimension</td>";
-            $activityLink = "detail.php?". 
-                http_build_query(array(
-                    "dimension" => $dimension,
-                    "subdimension"=> $subdimension,
-                    "element"=> $activityName 
-                ));
-            echo "<td><a href='$activityLink'>"
-                .div_tooltip($activityName, $activityName, build_table_tooltip ( $activity ))
-                ."</a></td>";
-
-            foreach($referenceLabels as $r => $rLabel){
-                $rlist = $activity["references"][$r] ?? array();
-                echo "<td>". ul($rlist) ."</td>";
-            }
-        }
+if ($sort == "activity") {
+
+  echo '<table class="table">';
+  $headings = array_merge($headings, array_keys(getReferenceLabels()));
+  thead($headings);
+
+  echo '<tbody>';
+
+  foreach (getActions($filteredDimensions) as list($dimension, $subdimension, $activities)) {
+    foreach ($activities as $activityName => $activity) {
+      echo "<tr>";
+      echo "<td>$dimension</td>";
+      echo "<td>$subdimension</td>";
+      $activityLink = "detail.php?".
+        http_build_query(array(
+          "dimension" => $dimension,
+          "subdimension"=> $subdimension,
+          "element"=> $activityName
+        ));
+      echo "<td><a href='$activityLink'>"
+        .div_tooltip($activityName, $activityName, build_table_tooltip ( $activity ))
+        ."</a></td>";
+
+      foreach ($referenceLabels as $r => $rLabel) {
+        $rlist = $activity["references"][$r] ?? array();
+        echo "<td>". ul($rlist) ."</td>";
+      }
     }
+  }
 } else { // sort by samm2, iso, samm
-    // populate mapping:
-    // mapping = value, activity, content
-    $mapping = array();
-    foreach(getActions($filteredDimensions) as list($dimension, $subdimension, $activities)) {
-        foreach ($activities as $activityName => $activity) {
-            $activity["dimension"] = $dimension;
-            $activity["subdimension"] = $subdimension;
-
-            $references = $activity["references"][$sort] ?? array();
-            foreach(as_list($references) as $mappingContent) {
-                $mapping[$mappingContent][$activityName] = $activity;
-            }
-        }
+  // populate mapping:
+  // mapping = value, activity, content
+  $mapping = array();
+  foreach (getActions($filteredDimensions) as list($dimension, $subdimension, $activities)) {
+    foreach ($activities as $activityName => $activity) {
+      $activity["dimension"] = $dimension;
+      $activity["subdimension"] = $subdimension;
+
+      $references = $activity["references"][$sort] ?? array();
+      foreach (as_list($references) as $mappingContent) {
+        $mapping[$mappingContent][$activityName] = $activity;
+      }
     }
-
-
-    // render table
-    echo '<table class="table">';
-    $headings = array_merge(array("$sort"), $headings, array_keys(getReferenceLabels()));
-    thead($headings);
-
-    echo '<tbody>';
-
-    // render mappings.
-    ksort($mapping, SORT_NUMERIC);
-    foreach($mapping as $mappingName => $mappingElement) {
-        foreach($mappingElement as $activityName => $activity) {
-            echo "<tr>";
-            echo "<td>" . $mappingName . "</td>";
-            echo "<td>" . $activity['dimension'] . "</td>";
-            echo "<td>" . $activity['subdimension'] . "</td>";
-            $activityLink = "detail.php?". 
-                http_build_query(array(
-                    "dimension" => $dimension,
-                    "subdimension"=> $subdimension,
-                    "element"=> $activityName 
-                ));
-            echo "<td><a href='$activityLink'>"
-                .div_tooltip($activityName, $activityName, build_table_tooltip ( $activity ))
-                ."</a></td>";
-
-            foreach($referenceLabels as $r => $rLabel){
-                $rlist = $activity["references"][$r] ?? array();
-                echo "<td>". ul($rlist) ."</td>";
-            }
-        }
+  }
+
+
+  // render table
+  echo '<table class="table">';
+  $headings = array_merge(array("$sort"), $headings, array_keys(getReferenceLabels()));
+  thead($headings);
+
+  echo '<tbody>';
+
+  // render mappings.
+  ksort($mapping, SORT_NUMERIC);
+  foreach ($mapping as $mappingName => $mappingElement) {
+    foreach ($mappingElement as $activityName => $activity) {
+      echo "<tr>";
+      echo "<td>" . $mappingName . "</td>";
+      echo "<td>" . $activity['dimension'] . "</td>";
+      echo "<td>" . $activity['subdimension'] . "</td>";
+      $activityLink = "detail.php?".
+        http_build_query(array(
+          "dimension" => $dimension,
+          "subdimension"=> $subdimension,
+          "element"=> $activityName
+        ));
+      echo "<td><a href='$activityLink'>"
+        .div_tooltip($activityName, $activityName, build_table_tooltip ( $activity ))
+        ."</a></td>";
+
+      foreach ($referenceLabels as $r => $rLabel) {
+        $rlist = $activity["references"][$r] ?? array();
+        echo "<td>". ul($rlist) ."</td>";
+      }
     }
+  }
 }
 
 echo "</table>";
-//var_dump($noMappingExists);
\ No newline at end of file
+//var_dump($noMappingExists);
diff --git a/md.php b/md.php
index ea64bba9a..5c5ef42a4 100644
--- a/md.php
+++ b/md.php
@@ -1,4 +1,10 @@
 <?php
+/**
+ * md.php
+ *
+ * @package default
+ */
+
 
 $title = "About this project";
 
@@ -10,8 +16,8 @@
 include_once "data.php";
 include_once "navi.php";
 
-if(!ctype_alnum($_GET['file'])){
-    exit; // make sure no path traversal or what ever happens
+if (!ctype_alnum($_GET['file'])) {
+  exit; // make sure no path traversal or what ever happens
 }
 $markdownContent = file_get_contents($_GET['file'] . ".md"); // only allow .md in this directory
 
diff --git a/navi.php b/navi.php
index 431a3607f..499e7cef9 100644
--- a/navi.php
+++ b/navi.php
@@ -1,16 +1,35 @@
+<?php
+/**
+ * navi.php
+ *
+ * @package default
+ * @see detail.php
+ * @see graph.php
+ * @see index.php
+ * @see mappings.php
+ * @see md.php
+ * @see report-samm.php
+ * @see report.php
+ * @see scutter.php
+ * @see spiderweb.php
+ * @see usefulnessHardness.php
+ */
+
+
+?>
 <a href="https://github.com/wurstbrot/generic-DevOps-Security-MaturityModel"><img style="position: absolute; top: 0; right: 0; border: 0;" src="https://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png" alt="Fork me on GitHub"></a>
 <?php
 
 $nav = array(
-    "index.php" => "Matrix",
-    "spiderweb.php" => "Implementation Levels",
-    "scutter.php" => "Ease and Value",
-    "mappings.php?performed=true&planned=true" => "Mappings",
-    "graph.php" => "Dependencies",
-    "report.php?performed=true&planned=true" => "Full Report",
-    //"usefulnessHardness.php" => "Heatmap",
-    "md.php?file=USAGE" => "Usage",
-    "md.php?file=README" => "About this project",
+  "index.php" => "Matrix",
+  "spiderweb.php" => "Implementation Levels",
+  "scutter.php" => "Ease and Value",
+  "mappings.php?performed=true&planned=true" => "Mappings",
+  "graph.php" => "Dependencies",
+  "report.php?performed=true&planned=true" => "Full Report",
+  //"usefulnessHardness.php" => "Heatmap",
+  "md.php?file=USAGE" => "Usage",
+  "md.php?file=README" => "About this project",
 
 );
 ?>
@@ -21,13 +40,13 @@
 </a>
 <?php
 foreach ($nav as $item => $value) {
-    echo "<li ";
-    //$item = preg_replace("/\?.*/", "", $item);
-    
-    if(strpos($_SERVER['REQUEST_URI'], $item)) {
-        echo "class=\"active\"";
-    }
-    echo "role=\"\"><a href=\"$item\">$value</a></li>";
+  echo "<li ";
+  //$item = preg_replace("/\?.*/", "", $item);
+
+  if (strpos($_SERVER['REQUEST_URI'], $item)) {
+    echo "class=\"active\"";
+  }
+  echo "role=\"\"><a href=\"$item\">$value</a></li>";
 }
 echo "</ul>";
 ?>
diff --git a/newFolder-Migration-2021.php b/newFolder-Migration-2021.php
index 6905fa581..8f0fa994a 100644
--- a/newFolder-Migration-2021.php
+++ b/newFolder-Migration-2021.php
@@ -1,42 +1,48 @@
 <?php
+/**
+ * newFolder-Migration-2021.php
+ *
+ * @package default
+ */
+
+
 include "functions.php";
 
 $dimensions = array(
-    "Culture and Organization" => readYaml("data/CultureandOrg.yml"),
-    "Build and Deployment" => readYaml("data/BuildandDeployment.yml"),
-    "Information Gathering" => readYaml("data/Informationgathering.yml"),
-    "Implementation" => readYaml("data/Implementation.yml"),
-    "Test and Verification" => readYaml("data/TestandVerification.yml")
+  "Culture and Organization" => readYaml("data/CultureandOrg.yml"),
+  "Build and Deployment" => readYaml("data/BuildandDeployment.yml"),
+  "Information Gathering" => readYaml("data/Informationgathering.yml"),
+  "Implementation" => readYaml("data/Implementation.yml"),
+  "Test and Verification" => readYaml("data/TestandVerification.yml")
 );
 
 foreach ($dimensions as $dimensionName => $subDimension) {
-    foreach ($subDimension as $subDimensionName => $elements) {
-
-        $newElements = $elements;
-        ksort($newElements);
-        $dimensions[$dimensionName][$subDimensionName] = $newElements;
-
-        foreach($elements as $elementName => $element) {
-            //unset($element['level']); // level from folder
-            $idWithSpace=mb_convert_case($elementName, MB_CASE_TITLE);
-            $idSanitized =  str_replace("/", "Or", $idWithSpace);
-
-            $id =  str_replace(" ", "", $idSanitized);
-            $element = array('id' => $id) + array('title' => $elementName) +  $element; // Add properties to the top
-            $element['id'] = $id;
-        }
-        $dimensionIdWithSpace = mb_convert_case($dimensionName, MB_CASE_TITLE);
-        $dimensionId = str_replace(" ", "", $dimensionIdWithSpace);
-        $subDimensionId = str_replace(" ", "",mb_convert_case($subDimensionName, MB_CASE_TITLE));
-        $folder = "data-new/$dimensionId/";
-        //echo $folder;
-        mkdir($folder, 755, true);
-
-        $filePath = $folder . $subDimensionId . ".yaml";
-        echo $filePath;
-        $yamlContent = yaml_emit(array($subDimensionName => $elements));
-
-        file_put_contents($filePath, $yamlContent);
+  foreach ($subDimension as $subDimensionName => $elements) {
+
+    $newElements = $elements;
+    ksort($newElements);
+    $dimensions[$dimensionName][$subDimensionName] = $newElements;
+
+    foreach ($elements as $elementName => $element) {
+      //unset($element['level']); // level from folder
+      $idWithSpace=mb_convert_case($elementName, MB_CASE_TITLE);
+      $idSanitized =  str_replace("/", "Or", $idWithSpace);
+
+      $id =  str_replace(" ", "", $idSanitized);
+      $element = array('id' => $id) + array('title' => $elementName) +  $element; // Add properties to the top
+      $element['id'] = $id;
     }
+    $dimensionIdWithSpace = mb_convert_case($dimensionName, MB_CASE_TITLE);
+    $dimensionId = str_replace(" ", "", $dimensionIdWithSpace);
+    $subDimensionId = str_replace(" ", "", mb_convert_case($subDimensionName, MB_CASE_TITLE));
+    $folder = "data-new/$dimensionId/";
+    //echo $folder;
+    mkdir($folder, 755, true);
+
+    $filePath = $folder . $subDimensionId . ".yaml";
+    echo $filePath;
+    $yamlContent = yaml_emit(array($subDimensionName => $elements));
+
+    file_put_contents($filePath, $yamlContent);
+  }
 }
-
diff --git a/report-samm.php b/report-samm.php
index 9714589e9..a7bc673b8 100644
--- a/report-samm.php
+++ b/report-samm.php
@@ -1,4 +1,11 @@
 <?php
+/**
+ * report-samm.php
+ *
+ * @package default
+ */
+
+
 include_once "head.php";
 ?>
     <body>
@@ -16,8 +23,8 @@
 
 foreach (getActions($dimensions) as list($dimension, $subdimensions, $element) {
     if ($dimension != $old_dimension) {
-        echo "<h1>Dimension $dimension</h1>";
-        $old_dimension = $dimension;
+      echo "<h1>Dimension $dimension</h1>";
+      $old_dimension = $dimension;
     }
 
     $mappingExists[$subdimension] = array();
@@ -26,45 +33,48 @@
 
     echo "<h3 style='color:green;'>With SAMM2 Mapping</h3>";
     for ($i = 1; $i <= 4; $i++) {
-        $tableContent .= "<td><ul>";
-        foreach ($element as $activityName => $content) {
-            if(array_key_exists("samm2", $content) && !preg_match("/TODO/i", $content["samm2"])) {
-                $content2 = getContentForLevelFromSubdimensions($i, $content, $activityName);
+      $tableContent .= "<td><ul>";
+      foreach ($element as $activityName => $content) {
+        if (array_key_exists("samm2", $content) && !preg_match("/TODO/i", $content["samm2"])) {
+          $content2 = getContentForLevelFromSubdimensions($i, $content, $activityName);
 
-                if ($content2 != "") {
-                    printDetail($dimension, $subdimension, $activityName, $dimensions, true);
-                    $mappingExists[$subdimension][$content["samm2"]][$activityName] = $content;
-                }
-            }
+          if ($content2 != "") {
+            printDetail($dimension, $subdimension, $activityName, $dimensions, true);
+            $mappingExists[$subdimension][$content["samm2"]][$activityName] = $content;
+          }
         }
+      }
     }
 
     echo "<h3 style='color:red;'>Without SAMM2 Mapping</h3>";
     for ($i = 1; $i <= 4; $i++) {
-        $tableContent .= "<td><ul>";
-        foreach ($element as $activityName => $content) {
-            if(!array_key_exists("samm2", $content) || preg_match("/TODO/i", $content["samm2"])) {
-                $content2 = getContentForLevelFromSubdimensions($i, $content, $activityName);
+      $tableContent .= "<td><ul>";
+      foreach ($element as $activityName => $content) {
+        if (!array_key_exists("samm2", $content) || preg_match("/TODO/i", $content["samm2"])) {
+          $content2 = getContentForLevelFromSubdimensions($i, $content, $activityName);
 
-                if ($content2 != "") {
-                    printDetail($dimension, $subdimension, $activityName, $dimensions, true);
-                    $content["name"] = $activityName;
-                    $noMappingExists[$subdimension][$content["samm2"]][$activityName] = $content;
-                }
-            }
+          if ($content2 != "") {
+            printDetail($dimension, $subdimension, $activityName, $dimensions, true);
+            $content["name"] = $activityName;
+            $noMappingExists[$subdimension][$content["samm2"]][$activityName] = $content;
+          }
         }
+      }
     }
-}
-foreach ($mappingExists as $dimension => $category) {
-//var_dump($mappingExists);
+  }
+  foreach ($mappingExists as $dimension => $category) {
+    //var_dump($mappingExists);
     echo "<h1>".$dimension ."</h1>";
-    foreach($category as $category => $content) {
-        //var_dump($content);exit;
-        echo $category . " ".count($content) . " ";
-        foreach($content as $activityName => $content2){ 
-            echo "$activityName" . " /";   }  
-        echo   "<br>";
+    foreach ($category as $category => $content) {
+      //var_dump($content);exit;
+      echo $category . " ".count($content) . " ";
+      foreach ($content as $activityName => $content2) {
+        echo "$activityName" . " /";   }
+      echo   "<br>";
     }
-}
+  }
+
+  //var_dump($noMappingExists);
+
 
-//var_dump($noMappingExists);
\ No newline at end of file
+  
diff --git a/report.php b/report.php
index 7c39ad202..1b3516c10 100644
--- a/report.php
+++ b/report.php
@@ -1,37 +1,44 @@
 <?php
+/**
+ * report.php
+ *
+ * @package default
+ */
+
+
 include_once "head.php";
 ?>
     <body>
 <?php
 include_once "navi.php";
 
-if(array_key_exists("performed", $_GET)) {
-    $showPerformed = $_GET['performed'];
- 
-    if($showPerformed != "true") $showPerformed = false;
+if (array_key_exists("performed", $_GET)) {
+  $showPerformed = $_GET['performed'];
+
+  if ($showPerformed != "true") $showPerformed = false;
 }else {
-    $showPerformed = false;
+  $showPerformed = false;
 }
 
-if(array_key_exists("planned", $_GET)) {
-    $showPlanned = $_GET['planned'];
+if (array_key_exists("planned", $_GET)) {
+  $showPlanned = $_GET['planned'];
 
-    if($showPlanned != "true") $showPlanned = false;
+  if ($showPlanned != "true") $showPlanned = false;
 }else {
-    $showPlanned = false;
+  $showPlanned = false;
 }
 
 ?>
 
 <form method="get">
     <div class="form-check">
-        <input type="checkbox" class="form-check-input" name="performed" id="exampleCheck1" value="true" <?php if($showPerformed) {echo " checked=checked";}?>>
+        <input type="checkbox" class="form-check-input" name="performed" id="exampleCheck1" value="true" <?php if ($showPerformed) {echo " checked=checked";}?>>
         <label class="form-check-label" for="exampleCheck1">Show performed activities</label>
   </div>
   <div class="form-check">
-        <input type="checkbox" class="form-check-input" name="planned" id="exampleCheck2" value="true" <?php if($showPlanned) {echo " checked=checked";} ?>>
+        <input type="checkbox" class="form-check-input" name="planned" id="exampleCheck2" value="true" <?php if ($showPlanned) {echo " checked=checked";} ?>>
         <label class="form-check-label" for="exampleCheck2">Show planned activities</label>
-  </div>  
+  </div>
   <button type="submit" class="btn btn-primary">Submit</button>
 </form>
 
@@ -42,27 +49,27 @@
 
 
 foreach ($dimensions as $dimension => $subdimensions) {
-    echo "<h1>Dimension $dimension</h1>";
-    foreach ($subdimensions as $subdimension => $activity) {
-        echo "<h2>Sub-Dimension $subdimension</h2>";
-
-        for ($i = 1; $i <= 4; $i++) {
-            $tableContent .= "<td><ul>";
-            foreach ($activity as $activityName => $content) {
-                if(elementIsSelected($activityName) && !$showPerformed) {
-                    continue;
-                }
-
-                if(!elementIsSelected($activityName) && !$showPlanned) {
-                    continue;
-                }                
-                $content = getContentForLevelFromSubdimensions($i, $content, $activityName);
-
-                if ($content != "") {
-                    printDetail($dimension, $subdimension, $activityName, $dimensions, true);
-                }
-            }
+  echo "<h1>Dimension $dimension</h1>";
+  foreach ($subdimensions as $subdimension => $activity) {
+    echo "<h2>Sub-Dimension $subdimension</h2>";
+
+    for ($i = 1; $i <= 4; $i++) {
+      $tableContent .= "<td><ul>";
+      foreach ($activity as $activityName => $content) {
+        if (elementIsSelected($activityName) && !$showPerformed) {
+          continue;
         }
 
+        if (!elementIsSelected($activityName) && !$showPlanned) {
+          continue;
+        }
+        $content = getContentForLevelFromSubdimensions($i, $content, $activityName);
+
+        if ($content != "") {
+          printDetail($dimension, $subdimension, $activityName, $dimensions, true);
+        }
+      }
     }
-}
\ No newline at end of file
+
+  }
+}
diff --git a/scutter.php b/scutter.php
index 58cdca212..30e475136 100644
--- a/scutter.php
+++ b/scutter.php
@@ -1,4 +1,11 @@
 <?php
+/**
+ * scutter.php
+ *
+ * @package default
+ */
+
+
 include_once "head.php";
 ?>
 <body>
@@ -14,31 +21,37 @@
 $aggregated = ($_GET['aggregated'] ?? false) == "true" ? "true" : false;
 
 
-function getJson($dimensions)
-{
-    $json = array();
-    $shapes = array('circle', 'cross', 'triangle-up', 'triangle-down', 'diamond', 'square');
-    $shape = 0;
-    foreach(getActions($dimensions) as list($dimension, $subdimension, $element)) {
-            $values = array();
-            foreach ($element as $activityName => $content) {
-                $values[] = array(
-                    "series" => 0,
-                    "shape" => $shapes[$shape] ?? "square",
-                    "size" => 3000,
-                    "x" => getDifficultyOfImplementation($dimensions, $content),
-                    "y" => $content["usefulness"],
-                    "key" => $activityName
-                );
-            }
-            $json[] = array(
-                "key" => "$dimension - " . $subdimension,
-                "values" => $values
-            );
-            $shape++;
+/**
+ *
+ * @param unknown $dimensions
+ * @return unknown
+ */
+function getJson($dimensions) {
+  $json = array();
+  $shapes = array('circle', 'cross', 'triangle-up', 'triangle-down', 'diamond', 'square');
+  $shape = 0;
+  foreach (getActions($dimensions) as list($dimension, $subdimension, $element)) {
+    $values = array();
+    foreach ($element as $activityName => $content) {
+      $values[] = array(
+        "series" => 0,
+        "shape" => $shapes[$shape] ?? "square",
+        "size" => 3000,
+        "x" => getDifficultyOfImplementation($dimensions, $content),
+        "y" => $content["usefulness"],
+        "key" => $activityName
+      );
     }
-    return json_encode($json);
+    $json[] = array(
+      "key" => "$dimension - " . $subdimension,
+      "values" => $values
+    );
+    $shape++;
+  }
+  return json_encode($json);
 }
+
+
 ?>
 <script>
     /**************************************
@@ -56,10 +69,10 @@ function getData() { //# groups,# points per group
 <form action="?" method="get">
 <?php
 $aggregated = $_GET['aggregated'] ?? null;
-if($aggregated == "true") {
-    echo "value='false'";
+if ($aggregated == "true") {
+  echo "value='false'";
 }else {
-    echo "value='true'";
+  echo "value='true'";
 }
 ?>">
     <button id="">
@@ -70,4 +83,4 @@ function getData() { //# groups,# points per group
 </form>
 <div id='chart'>
     <svg style='height:500px'></svg>
-</div>
\ No newline at end of file
+</div>
diff --git a/spiderweb.php b/spiderweb.php
index d684bb293..b54b5552d 100644
--- a/spiderweb.php
+++ b/spiderweb.php
@@ -1,4 +1,11 @@
 <?php
+/**
+ * spiderweb.php
+ *
+ * @package default
+ */
+
+
 $title = "Identification of the degree of the implementation";
 include_once "head.php";
 ?>
@@ -12,8 +19,8 @@
 <div class="spiderweb">
     <div class="chart" id="energychart"></div>
     <?php
-    echo getTable($dimensions);
-    ?>
+echo getTable($dimensions);
+?>
 </div>
 <script src="https://d3js.org/d3.v3.min.js"></script>
 <script src="js/circularHeatChart.js"></script>
@@ -34,4 +41,4 @@
     });
 </script>
 </body>
-</html>
\ No newline at end of file
+</html>
diff --git a/spiderwebData.php b/spiderwebData.php
index a8776ec47..095decfdb 100644
--- a/spiderwebData.php
+++ b/spiderwebData.php
@@ -1,130 +1,170 @@
 <?php
+/**
+ * spiderwebData.php
+ *
+ * @package default
+ */
+
 
 $elementParam = $_REQUEST['element'] ?? null;
 
 include_once "bib.php";
 include_once "data.php";
-function getSpiderWebData($dimensions)
-{
-    $data = array();
-    foreach(getActions($dimensions) as list($dimension, $subdimension, $activities)) {
-        for ($level = 1; $level <= 4; $level++) {
-            // initialize $data cells
-            if (! ($data[$level][$dimension][$subdimension] ?? null)) {
-                $data[$level][$dimension][$subdimension]['count'] = 0;
-                $data[$level][$dimension][$subdimension]['selected'] = 0;
-            }
-            foreach ($activities as $activityName => $activity) {
-                if ($level == $activity["level"]) {
-                    $data[$level][$dimension][$subdimension]['count']++;
-                    if (elementIsSelected($activityName)) {
-                        $data[$level][$dimension][$subdimension]['selected']++;
-                    }
-                }
-
-            }
+
+
+/**
+ *
+ * @param unknown $dimensions
+ * @return unknown
+ */
+function getSpiderWebData($dimensions) {
+  $data = array();
+  foreach (getActions($dimensions) as list($dimension, $subdimension, $activities)) {
+    for ($level = 1; $level <= 4; $level++) {
+      // initialize $data cells
+      if (! ($data[$level][$dimension][$subdimension] ?? null)) {
+        $data[$level][$dimension][$subdimension]['count'] = 0;
+        $data[$level][$dimension][$subdimension]['selected'] = 0;
+      }
+      foreach ($activities as $activityName => $activity) {
+        if ($level == $activity["level"]) {
+          $data[$level][$dimension][$subdimension]['count']++;
+          if (elementIsSelected($activityName)) {
+            $data[$level][$dimension][$subdimension]['selected']++;
+          }
         }
+
+      }
     }
-    return $data;
+  }
+  return $data;
 }
 
+
+/**
+ *
+ * @param unknown $haystack
+ * @param unknown $needle
+ * @return unknown
+ */
 function startsWith($haystack, $needle) {
-    // search backwards starting from haystack length characters from the end
-    return $needle === "" || strrpos($haystack, $needle, -strlen($haystack)) !== false;
+  // search backwards starting from haystack length characters from the end
+  return $needle === "" || strrpos($haystack, $needle, -strlen($haystack)) !== false;
 }
-function fwritecsv2($filePointer, $dataArray, $delimiter = ",", $enclosure = "\"")
-{
-    // Write a line to a file
-    // $filePointer = the file resource to write to
-    // $dataArray = the data to write out
-    // $delimeter = the field separator
 
-    // Build the string
-    $string = "";
 
-    // for each array element, which represents a line in the csv file...
-    foreach ($dataArray as $line) {
+/**
+ *
+ * @param unknown $filePointer
+ * @param unknown $dataArray
+ * @param unknown $delimiter   (optional)
+ * @param unknown $enclosure   (optional)
+ */
+function fwritecsv2($filePointer, $dataArray, $delimiter = ",", $enclosure = "\"") {
+  // Write a line to a file
+  // $filePointer = the file resource to write to
+  // $dataArray = the data to write out
+  // $delimeter = the field separator
 
-        // No leading delimiter
-        $writeDelimiter = FALSE;
+  // Build the string
+  $string = "";
 
-        foreach ($line as $dataElement) {
-            // Replaces a double quote with two double quotes
-            $dataElement = str_replace("\"", "\"\"", $dataElement);
+  // for each array element, which represents a line in the csv file...
+  foreach ($dataArray as $line) {
 
-            // Adds a delimiter before each field (except the first)
-            if ($writeDelimiter) $string .= $delimiter;
+    // No leading delimiter
+    $writeDelimiter = FALSE;
 
-            // Encloses each field with $enclosure and adds it to the string
-            $string .= $enclosure . $dataElement . $enclosure;
+    foreach ($line as $dataElement) {
+      // Replaces a double quote with two double quotes
+      $dataElement = str_replace("\"", "\"\"", $dataElement);
 
-            // Delimiters are used every time except the first.
-            $writeDelimiter = TRUE;
-        }
-        // Append new line
-        $string .= "\n";
+      // Adds a delimiter before each field (except the first)
+      if ($writeDelimiter) $string .= $delimiter;
 
-    } // end foreach($dataArray as $line)
+      // Encloses each field with $enclosure and adds it to the string
+      $string .= $enclosure . $dataElement . $enclosure;
 
-    $string = str_replace('""', '"element"', $string);
-    if (!startsWith($string, "element") && !startsWith($string, '"element"')) {
-        $string = "element" . $string;
+      // Delimiters are used every time except the first.
+      $writeDelimiter = TRUE;
     }
-    // Write the string to the file
-    fwrite($filePointer, $string);
+    // Append new line
+    $string .= "\n";
+
+  } // end foreach($dataArray as $line)
+
+  $string = str_replace('""', '"element"', $string);
+  if (!startsWith($string, "element") && !startsWith($string, '"element"')) {
+    $string = "element" . $string;
+  }
+  // Write the string to the file
+  fwrite($filePointer, $string);
 }
 
+
 //var_dump( getSpiderWebData($dimensions));exit;
 
-function deleteElement(&$data, $activityName)
-{
-    $count = 0;
-    foreach ($data as $element) {
-        if ($activityName == $element["element"]) {
-            unset($data[$count]);
-        }
-        $count++;
+
+/**
+ *
+ * @param unknown $data         (reference)
+ * @param unknown $activityName
+ */
+function deleteElement(&$data, $activityName) {
+  $count = 0;
+  foreach ($data as $element) {
+    if ($activityName == $element["element"]) {
+      unset($data[$count]);
     }
+    $count++;
+  }
 }
 
-function isElementExisting($dimensions, $givenElementName)
-{
-    foreach ($dimensions as $dimension => $subdimensions) {
-        foreach ($subdimensions as $subdimension => $element) {
-            foreach ($element as $activityName => $content) {
-                if ($activityName == $givenElementName) {
-                    return true;
-                }
-            }
+
+/**
+ *
+ * @param unknown $dimensions
+ * @param unknown $givenElementName
+ * @return unknown
+ */
+function isElementExisting($dimensions, $givenElementName) {
+  foreach ($dimensions as $dimension => $subdimensions) {
+    foreach ($subdimensions as $subdimension => $element) {
+      foreach ($element as $activityName => $content) {
+        if ($activityName == $givenElementName) {
+          return true;
         }
+      }
     }
-    return false;
+  }
+  return false;
 }
 
+
 if ($elementParam == null) {
-    echo json_encode(getSpiderWebData($dimensions));
-    return;
-} 
+  echo json_encode(getSpiderWebData($dimensions));
+  return;
+}
 
 {
-    $csvFile = 'selectedData.csv';
-    $csv = getCsv();
-    $element = $elementParam;
-
-    if (elementIsSelected($element)) {
-        deleteElement($csv, $element);
-    } else {
-        if (!isElementExisting($dimensions, $element)) {
-            echo "Could not find element";
-            exit;
-        }
-        $newEntry['element'] = $element;
-        $csv[] = $newEntry;
+  $csvFile = 'selectedData.csv';
+  $csv = getCsv();
+  $element = $elementParam;
+
+  if (elementIsSelected($element)) {
+    deleteElement($csv, $element);
+  } else {
+    if (!isElementExisting($dimensions, $element)) {
+      echo "Could not find element";
+      exit;
     }
-
-    $keys = array_keys($csv[0]);
-    $csv = array_merge(array($keys), $csv);
-    $fp = fopen($csvFile, 'w');
-    fwritecsv2($fp, $csv, ",");
-    fclose($fp);
+    $newEntry['element'] = $element;
+    $csv[] = $newEntry;
+  }
+
+  $keys = array_keys($csv[0]);
+  $csv = array_merge(array($keys), $csv);
+  $fp = fopen($csvFile, 'w');
+  fwritecsv2($fp, $csv, ",");
+  fclose($fp);
 }
diff --git a/test-yaml.php b/test-yaml.php
index 7373c2ac0..4bbe4f9ff 100644
--- a/test-yaml.php
+++ b/test-yaml.php
@@ -1,13 +1,27 @@
-<?php declare(strict_types=1);
+<?php
+/**
+ * test-yaml.php
+ *
+ * @package default
+ */
+
+
+declare(strict_types=1);
 use PHPUnit\Framework\TestCase;
 
-require_once('functions.php');
+require_once 'functions.php';
 
 final class EmailTest extends TestCase
 {
-    public function testCanBeCreatedFromValidEmailAddress(): void
-    {
-        var_dump(readYaml("data/strings.yml#strings/labels"));
 
-    }
-}
\ No newline at end of file
+  /**
+   *
+   */
+  public function testCanBeCreatedFromValidEmailAddress(): void
+  {
+    var_dump(readYaml("data/strings.yml#strings/labels"));
+
+  }
+
+
+}
diff --git a/usefulnessHardness.php b/usefulnessHardness.php
index e78312dde..335e909e6 100644
--- a/usefulnessHardness.php
+++ b/usefulnessHardness.php
@@ -1,172 +1,201 @@
 <?php
+/**
+ * usefulnessHardness.php
+ *
+ * @package default
+ */
+
+
 include_once "head.php";
 ?>
 <body>
 <div class="usefullness">
     <?php
-    include_once "navi.php";
-    ?>
+include_once "navi.php";
+?>
 
     <?php
-    include_once "data.php";
-    function printDimensionUsefull($dimensions, $colors)
-    {
-    $all = array();
-    foreach ($dimensions as $dimension => $subdimensions) {
-        foreach ($subdimensions as $subdimension => $element) {
-
-            for ($i = 1; $i < 5; $i++) {
-                if (!array_key_exists($i, $all)) {
-                    $all[$i] = array();
-                }
-                if (array_key_exists($subdimension, $all[$i])) {
-                    $all[$subdimension][$i] = array();
-                    $all[$subdimension][$i]['usefulness'] = array();
-                    $all[$subdimension][$i]['difficultyOfImplementation'] = array();
-                }
-                foreach ($element as $activityName => $elementImplementation) {
-                    if ($elementImplementation['level'] != $i) continue;
-                    $all[$subdimension][$i]['usefulness'][] = $elementImplementation['usefulness'];
-
-                    $knowledge = getKnowledge($elementImplementation);
-
-                    $all[$subdimension][$i]['difficultyOfImplementation'][] = $knowledge;
-                    $all[$subdimension][$i]['difficultyOfImplementation'][] = $elementImplementation['difficultyOfImplementation']["time"];
-                    $all[$subdimension][$i]['difficultyOfImplementation'][] = $elementImplementation['difficultyOfImplementation']["time"];
-                    $all[$subdimension][$i]['difficultyOfImplementation'][] = $elementImplementation['difficultyOfImplementation']["resources"];
-                }
-
-            }
+include_once "data.php";
+
+
+/**
+ *
+ * @param unknown $dimensions
+ * @param unknown $colors
+ */
+function printDimensionUsefull($dimensions, $colors) {
+  $all = array();
+  foreach ($dimensions as $dimension => $subdimensions) {
+    foreach ($subdimensions as $subdimension => $element) {
+
+      for ($i = 1; $i < 5; $i++) {
+        if (!array_key_exists($i, $all)) {
+          $all[$i] = array();
+        }
+        if (array_key_exists($subdimension, $all[$i])) {
+          $all[$subdimension][$i] = array();
+          $all[$subdimension][$i]['usefulness'] = array();
+          $all[$subdimension][$i]['difficultyOfImplementation'] = array();
+        }
+        foreach ($element as $activityName => $elementImplementation) {
+          if ($elementImplementation['level'] != $i) continue;
+          $all[$subdimension][$i]['usefulness'][] = $elementImplementation['usefulness'];
+
+          $knowledge = getKnowledge($elementImplementation);
+
+          $all[$subdimension][$i]['difficultyOfImplementation'][] = $knowledge;
+          $all[$subdimension][$i]['difficultyOfImplementation'][] = $elementImplementation['difficultyOfImplementation']["time"];
+          $all[$subdimension][$i]['difficultyOfImplementation'][] = $elementImplementation['difficultyOfImplementation']["time"];
+          $all[$subdimension][$i]['difficultyOfImplementation'][] = $elementImplementation['difficultyOfImplementation']["resources"];
         }
+
+      }
     }
-    ?>
+  }
+?>
 
     <table class="table table-nonfluid">
         <tr>
             <th></th>
             <?php
-            foreach (reset($all) as $level => $levelElements) {
-                echo "<th colspan='2'>Level $level</th>";
-            }
-            exit;
-            echo "</tr><tr><th>Dimension</th>";
-
-            foreach (reset($all) as $level => $levelElements) {
-                echo "<th>Nutzen</th>";
-                echo "<th>Schwere</th>";
-            }
-            echo "</tr>";
-            foreach ($all as $level => $levelElements) {
-                echo "<tr>";
-                echo "<td>$level</td>";
-                foreach ($levelElements as $subdimension => $elements) {
-                    $std = stats_standard_deviation($elements["usefulness"]);
-
-                    $avg = 0;
-                    foreach ($elements['usefulness'] as $element) {
-                        $avg += $element;
-                    }
-                    $avg = $avg / count($elements['usefulness']);
-
-                    $stdImp = stats_standard_deviation($elements['difficultyOfImplementation']);
-
-                    $avgImp = 0;
-                    foreach ($elements['difficultyOfImplementation'] as $element) {
-                        $avgImp += $element;
-                    }
-
-                    $avgImp = $avgImp / count($elements['difficultyOfImplementation']);
-
-
-                    echo "<td style='background-color: " . getColor($avg, $colors) . "'>" . number_format((float)$avg, 2, '.', '') . "<br />&sigma;=" . number_format((float)$std, 2, '.', '') . "</td><td style='background-color: " . getColorFordifficultyOfImplementation($avgImp, $colors) . "'>" . number_format((float)$avgImp, 2, '.', '') . "<br />&sigma;=" . number_format((float)$stdImp, 2, '.', '') . "</td>";
-                }
-                echo "</tr>";
-            }
-            echo '</table>';
-            }
-
-            function getColor($val, $colors)
-            {
-
-                return getColorFordifficultyOfImplementation($val, array_reverse($colors));
-            }
-
-            function getColorFordifficultyOfImplementation($val, $colors)
-            {
-                if ($val < 1.49) {
-                    return $colors[0];
-                }
-                if ($val < 2.49) {
-                    return $colors[1];
-                }
-                if ($val < 3.49) {
-                    return $colors[2];
-                }
-                if ($val < 4.49) {
-                    return $colors[3];
-                }
-                return $colors[4];
-            }
-
-            if (!function_exists('stats_standard_deviation')) {
-                /**
-                 * This user-land implementation follows the implementation quite strictly;
-                 * it does not attempt to improve the code or algorithm in any way. It will
-                 * raise a warning if you have fewer than 2 values in your array, just like
-                 * the extension does (although as an E_USER_WARNING, not E_WARNING).
-                 *
-                 * @param array $a
-                 * @param bool $sample [optional] Defaults to false
-                 * @return float|bool The standard deviation or false on error.
-                 */
-                function stats_standard_deviation(array $a, $sample = false)
-                {
-                    $n = count($a);
-                    if ($n === 0) {
-                        trigger_error("The array has zero elements", E_USER_WARNING);
-                        return false;
-                    }
-                    if ($sample && $n === 1) {
-                        trigger_error("The array has only 1 element", E_USER_WARNING);
-                        return false;
-                    }
-                    $mean = array_sum($a) / $n;
-                    $carry = 0.0;
-                    foreach ($a as $val) {
-                        $d = ((double)$val) - $mean;
-                        $carry += $d * $d;
-                    };
-                    if ($sample) {
-                        --$n;
-                    }
-                    return sqrt($carry / $n);
-                }
-            }
-
-            $usefulnessMap= array("Sehr gering", "Gering", "Mittel", "Hoch", "Sehr hoch");
-            $usefulnessMap = array_reverse($usefulnessMap);
-            $hardnessMap =array("Sehr einfach", "Einfach", "Mittel", "Schwer", "Sehr Schwer");
-            $colors = array("#81F781", "#BEF781", "#F3F781", "#F7BE81", "#FA5858");
-            printDimensionUsefull($dimensions, $colors);
-
-            ?>
+  foreach (reset($all) as $level => $levelElements) {
+    echo "<th colspan='2'>Level $level</th>";
+  }
+  exit;
+  echo "</tr><tr><th>Dimension</th>";
+
+  foreach (reset($all) as $level => $levelElements) {
+    echo "<th>Nutzen</th>";
+    echo "<th>Schwere</th>";
+  }
+  echo "</tr>";
+  foreach ($all as $level => $levelElements) {
+    echo "<tr>";
+    echo "<td>$level</td>";
+    foreach ($levelElements as $subdimension => $elements) {
+      $std = stats_standard_deviation($elements["usefulness"]);
+
+      $avg = 0;
+      foreach ($elements['usefulness'] as $element) {
+        $avg += $element;
+      }
+      $avg = $avg / count($elements['usefulness']);
+
+      $stdImp = stats_standard_deviation($elements['difficultyOfImplementation']);
+
+      $avgImp = 0;
+      foreach ($elements['difficultyOfImplementation'] as $element) {
+        $avgImp += $element;
+      }
+
+      $avgImp = $avgImp / count($elements['difficultyOfImplementation']);
+
+
+      echo "<td style='background-color: " . getColor($avg, $colors) . "'>" . number_format((float)$avg, 2, '.', '') . "<br />&sigma;=" . number_format((float)$std, 2, '.', '') . "</td><td style='background-color: " . getColorFordifficultyOfImplementation($avgImp, $colors) . "'>" . number_format((float)$avgImp, 2, '.', '') . "<br />&sigma;=" . number_format((float)$stdImp, 2, '.', '') . "</td>";
+    }
+    echo "</tr>";
+  }
+  echo '</table>';
+}
+
+
+/**
+ *
+ * @param unknown $val
+ * @param unknown $colors
+ * @return unknown
+ */
+function getColor($val, $colors) {
+
+  return getColorFordifficultyOfImplementation($val, array_reverse($colors));
+}
+
+
+/**
+ *
+ * @param unknown $val
+ * @param unknown $colors
+ * @return unknown
+ */
+function getColorFordifficultyOfImplementation($val, $colors) {
+  if ($val < 1.49) {
+    return $colors[0];
+  }
+  if ($val < 2.49) {
+    return $colors[1];
+  }
+  if ($val < 3.49) {
+    return $colors[2];
+  }
+  if ($val < 4.49) {
+    return $colors[3];
+  }
+  return $colors[4];
+}
+
+
+if (!function_exists('stats_standard_deviation')) {
+
+
+  /**
+   * This user-land implementation follows the implementation quite strictly;
+   * it does not attempt to improve the code or algorithm in any way. It will
+   * raise a warning if you have fewer than 2 values in your array, just like
+   * the extension does (although as an E_USER_WARNING, not E_WARNING).
+   *
+   * @param array   $a
+   * @param bool    $sample (optional) [optional] Defaults to false
+   * @return float|bool The standard deviation or false on error.
+   */
+  function stats_standard_deviation(array $a, $sample = false) {
+    $n = count($a);
+    if ($n === 0) {
+      trigger_error("The array has zero elements", E_USER_WARNING);
+      return false;
+    }
+    if ($sample && $n === 1) {
+      trigger_error("The array has only 1 element", E_USER_WARNING);
+      return false;
+    }
+    $mean = array_sum($a) / $n;
+    $carry = 0.0;
+    foreach ($a as $val) {
+      $d = ((double)$val) - $mean;
+      $carry += $d * $d;
+    };
+    if ($sample) {
+      --$n;
+    }
+    return sqrt($carry / $n);
+  }
+
+
+}
+
+$usefulnessMap= array("Sehr gering", "Gering", "Mittel", "Hoch", "Sehr hoch");
+$usefulnessMap = array_reverse($usefulnessMap);
+$hardnessMap =array("Sehr einfach", "Einfach", "Mittel", "Schwer", "Sehr Schwer");
+$colors = array("#81F781", "#BEF781", "#F3F781", "#F7BE81", "#FA5858");
+printDimensionUsefull($dimensions, $colors);
+
+?>
             <div style="width:190px;margin-left:3px;">
                 <strong>Legende</strong>
                 <table class="table">
                     <th>Nutzen</th><th>Schwere</th>
                 <div style="text-align: center">
                     <?php
-                    for ($i = 0; $i < count($usefulnessMap); $i++) {
-                        echo "<tr>";
-                        echo "<td style='background-color: " . $colors[$i] . "'>" . $usefulnessMap[$i] . "</td><td style='background-color: " . $colors[$i] . "'>".$hardnessMap[$i]."</td>";
-                        echo "</tr>";
-                    }
+for ($i = 0; $i < count($usefulnessMap); $i++) {
+  echo "<tr>";
+  echo "<td style='background-color: " . $colors[$i] . "'>" . $usefulnessMap[$i] . "</td><td style='background-color: " . $colors[$i] . "'>".$hardnessMap[$i]."</td>";
+  echo "</tr>";
+}
 
-                    ?>
+?>
                 </div>
                 </table>
             </div>
 </div>
 
 </div>
-</body>
\ No newline at end of file
+</body>