diff --git a/.changeset/unlucky-rabbits-appear.md b/.changeset/unlucky-rabbits-appear.md
new file mode 100644
index 0000000000..089abc5ea6
--- /dev/null
+++ b/.changeset/unlucky-rabbits-appear.md
@@ -0,0 +1,5 @@
+---
+'providence-analytics': patch
+---
+
+improve docs
diff --git a/docs/fundamentals/node-tools/providence-analytics/LocalConfiguration.md b/docs/fundamentals/node-tools/providence-analytics/LocalConfiguration.md
deleted file mode 100644
index c271edc1bb..0000000000
--- a/docs/fundamentals/node-tools/providence-analytics/LocalConfiguration.md
+++ /dev/null
@@ -1,68 +0,0 @@
-# Node Tools >> Providence Analytics >> Local configuration ||40
-
-The Providence configuration file is read by providence cli (optional) and by the dashboard (required).
-It has a few requirements:
-
-- it must be called `providence.conf.js` or `providence.conf.mjs`
-- it must be in ESM format
-- it must be located in the root of a repository (under `process.cwd()`)
-
-## Meta data
-
-### Category info
-
-Based on the filePath of a result, a category can be added.
-For example:
-
-```js
-export default {
-  metaConfig: {
-    categoryConfig: [
-      {
-        // This is the name found in package.json
-        project: '@lion/ui/root.js',
-        // These conditions will be run on overy filePath
-        categories: {
-          core: p => p.startsWith('./packages/core'),
-          utils: p => p.startsWith('./packages/ajax') || p.startsWith('./packages/localize'),
-          overlays: p =>
-            p.startsWith('./packages/overlays') ||
-            p.startsWith('./packages/dialog') ||
-            p.startsWith('./packages/tooltip'),
-          ...
-        },
-      },
-    ],
-  },
-}
-```
-
-> N.B. category info is regarded as subjective, therefore it's advised to move this away from
-> Analyzers (and thus file-system cache). Categories can be added realtime in the dashboard.
-
-## Project paths
-
-### referenceCollections
-
-A list of file system paths. They can be defined relative from the current project root or they can be full paths.
-When a [MatchAnalyzer](../../../fundamentals/node-tools/providence-analytics/analyzer.md) like `match-imports` or `match-subclasses` is used, the default reference(s) can be configured here. For instance: ['/path/to/@lion/ui/form.js']
-
-An example:
-
-```js
-  referenceCollections: {
-    // Our products
-    'lion-based-ui': [
-      './providence-input-data/references/lion-based-ui',
-      './providence-input-data/references/lion-based-ui-labs',
-    ],
-    ...
-  }
-```
-
-### searchTargetCollections
-
-A list of file system paths. They can be defined relative from the current project root
-or they can be full paths.
-When not defined, the current project will be the search target (this is most common when
-providence is used as a dev dependency).
diff --git a/docs/fundamentals/node-tools/providence-analytics/QueryResult.md b/docs/fundamentals/node-tools/providence-analytics/QueryResult.md
deleted file mode 100644
index 664f150ee8..0000000000
--- a/docs/fundamentals/node-tools/providence-analytics/QueryResult.md
+++ /dev/null
@@ -1,111 +0,0 @@
-# Node Tools >> Providence Analytics >> QueryResult ||50
-
-When an Analyzer has run, it returns a QueryResult. This is a json object that contains all
-meta info (mainly configuration parameters) and the query output.
-A QueryResult always contains the analysis of one project (a target project). Optionally,
-it can contain a reference project as well.
-
-## Anatomy
-
-A QueryResult starts with a meta section, followed by the actual results
-
-### Meta
-
-The meta section lists all configuration options the analyzer was run with. Here, you see an
-example of a `find-imports` QueryResult:
-
-```js
-  "meta": {
-    "searchType": "ast-analyzer",
-    "analyzerMeta": {
-      "name": "find-imports",
-      "requiredAst": "babel",
-      "identifier": "importing-target-project_0.0.2-target-mock__1970011674",
-      "targetProject": {
-        "name": "importing-target-project",
-        "commitHash": "3e5014d6ecdff1fc71138cdb29aaf7bf367588f5",
-        "version": "0.0.2-target-mock"
-      },
-      "configuration": {
-        "keepInternalSources": false
-      }
-    }
-  },
-```
-
-### Output
-
-The output is usually more specifically tied to the Analyzer. What most regular Analyzers
-(not being MatchAnalyzers that require a referenceProjectPath) have in common, is that their
-results are being shown per "entry" (an entry corresponds with an AST generated by Babel, which in
-turn corresponds to a file found in a target or reference project).
-
-Below an example is shown of `find-imports` QueryOutput:
-
-```js
-  "queryOutput": [
-    {
-      "project": {
-        "name": "importing-target-project",
-        "mainEntry": "./target-src/match-imports/root-level-imports.js",
-        "version": "0.0.2-target-mock",
-        "commitHash": "3e5014d6ecdff1fc71138cdb29aaf7bf367588f5"
-      },
-      "entries": [
-        {
-          "file": "./target-src/find-imports/all-notations.js",
-          "result": [
-            {
-              "importSpecifiers": [
-                "[file]"
-              ],
-              "source": "imported/source",
-              "normalizedSource": "imported/source",
-              "fullSource": "imported/source"
-            },
-            {
-              "importSpecifiers": [
-                "[default]"
-              ],
-              "source": "imported/source-a",
-              "normalizedSource": "imported/source-a",
-              "fullSource": "imported/source-a"
-            },
-            ...
-```
-
-MatchAnalyzers usually do post processing on the entries. The output below (for the `match-imports`
-Analyzer) shows an ordering by matched specifier.
-
-```js
- "queryOutput": [
-    {
-      "exportSpecifier": {
-        "name": "[default]",
-        "project": "exporting-ref-project",
-        "filePath": "./index.js",
-        "id": "[default]::./index.js::exporting-ref-project"
-      },
-      "matchesPerProject": [
-        {
-          "project": "importing-target-project",
-          "files": [
-            "./target-src/match-imports/root-level-imports.js",
-            "./target-src/match-subclasses/internalProxy.js"
-          ]
-        }
-      ]
-    },
-    ...
-```
-
-Due to some legacy decisions, the QueryOutput allows for multiple target- and reference projects.
-Aggregation of data now takes place in the dashboard.
-QueryOutputs always contain one or a combination of two projects. This means that the
-QueryOutput structure could be simplified in the future.
-
-## Environment agnosticism
-
-The output files stored in the file system always need to be machine independent:
-this means that all machine specific information, like a complete filepath, needs to be removed from a QueryOutput (paths relative from project root are still allowed).
-In that way, the caching mechanism (based on hash comparisons) as described in [Analyzer](../../../fundamentals/node-tools/providence-analytics/analyzer.md) is guaranteed to work across different machines.
diff --git a/docs/fundamentals/node-tools/providence-analytics/analyzer.md b/docs/fundamentals/node-tools/providence-analytics/analyzer.md
deleted file mode 100644
index 1ba42dccd9..0000000000
--- a/docs/fundamentals/node-tools/providence-analytics/analyzer.md
+++ /dev/null
@@ -1,69 +0,0 @@
-# Node Tools >> Providence Analytics >> Analyzer ||20
-
-Analyzers form the core of Providence. They contain predefined queries based on AST traversal/analysis.
-A few examples are:
-
-- find-imports
-- find-exports
-- match-imports
-
-An analyzer will give back a [QueryResult](../../../fundamentals/node-tools/providence-analytics/QueryResult.md) that will be written to the file system by Providence.
-All analyzers need to extend from the `Analyzer` base class, found in `src/program/analyzers/helpers`.
-
-## Public api
-
-Providence has the following configuration api:
-
-- name (string)
-- requiresReference (boolean)
-  An analyzer will always need a targetProjectPath and can optionally have a referenceProjectPath.
-  In the latter case, it needs to have `requiresReference: true` configured.
-
-During AST traversal, the following api can be consulted
-
-- `.targetData`
-- `.referenceData`
-- `.identifier`
-
-## Phases
-
-### Prepare phase
-
-In this phase, all preparations will be done to run the analysis. Providence is designed to be performant and therefore will first look if it finds an already existing, cached result for the current setup.
-
-### Traverse phase
-
-The ASTs are created for all projects involved and the data are extracted into a QueryOutput. This output can optionally be post processed.
-
-### Finalize phase
-
-The data are normalized and written to the filesystem in JSON format.
-
-## Targets and references
-
-Every Analyzer needs a targetProjectPath. A targetProjectPath is a file path String that.
-
-## Types
-
-We can roughly distinguish two types of analyzers: those that require a reference and those that don't require a reference.
-
-## Database
-
-In order to share data across multiple machines, results are written to the filesystem in a
-"machine agnostic" way. They can be shared through git and serve as a local database.
-
-### Caching
-
-In order to make caching possible, Providence creates an "identifier": a hash from the combination of project versions + Analyzer configuration. When an identifier already exists in the filesystem, the result can be read from cache. This increases performance and helps mitigate memory problems that can occur when handling large amounts of data in a batch.
-
-## Analyzer helpers
-
-Inside the folder './src/program/analyzers', a folder 'helpers' is found.
-Helpers are created specifically for use within analyzers and have knowledge about
-the context of the analyzer (knowledge about an AST and/or QueryResult structure).
-
-Generic functionality (that can be applied in any context) can be found in './src/program/utils'.
-
-## Post processors
-
-Post processors are imported by analyzers and act on their outputs. They can be enabled via the configuration of an analyzer. They can be found in './src/program/analyzers/post-processors'. For instance: transform the output of analyzer 'find-imports' by sorting on specifier instead of the default (entry). Other than most configurations of analyzers, post processors act on the total result of all analyzed files instead of just one file/ ast entry.
diff --git a/docs/fundamentals/node-tools/providence-analytics/assets/_mermaid.svg.js b/docs/fundamentals/node-tools/providence-analytics/assets/_mermaid.svg.js
deleted file mode 100644
index 4a6d15d554..0000000000
--- a/docs/fundamentals/node-tools/providence-analytics/assets/_mermaid.svg.js
+++ /dev/null
@@ -1,1226 +0,0 @@
-import { html } from 'lit-html';
-
-/*
-
-```mermaid
-graph TD;
-    queryConfig-->providence;
-    ProvidenceConfig-->providence;
-    providence-->QueryResult;
-```
-
-*/
-export const providenceFlowSvg = html` <svg
-  id="mermaid-1592918098747"
-  width="100%"
-  xmlns="http://www.w3.org/2000/svg"
-  style="max-width: 316.46875px; max-height: 400px;"
-  viewBox="0 0 316.46875 233"
->
-  <style>
-    #mermaid-1592918098747 .label {
-      font-family:
-        trebuchet ms,
-        verdana,
-        arial;
-      color: #333;
-    }
-    #mermaid-1592918098747 .node circle,
-    #mermaid-1592918098747 .node ellipse,
-    #mermaid-1592918098747 .node polygon,
-    #mermaid-1592918098747 .node rect {
-      fill: #ececff;
-      stroke: #9370db;
-      stroke-width: 1px;
-    }
-    #mermaid-1592918098747 .node.clickable {
-      cursor: pointer;
-    }
-    #mermaid-1592918098747 .arrowheadPath {
-      fill: #333;
-    }
-    #mermaid-1592918098747 .edgePath .path {
-      stroke: #333;
-      stroke-width: 1.5px;
-    }
-    #mermaid-1592918098747 .edgeLabel {
-      background-color: #e8e8e8;
-    }
-    #mermaid-1592918098747 .cluster rect {
-      fill: #ffffde !important;
-      stroke: #aa3 !important;
-      stroke-width: 1px !important;
-    }
-    #mermaid-1592918098747 .cluster text {
-      fill: #333;
-    }
-    #mermaid-1592918098747 div.mermaidTooltip {
-      position: absolute;
-      text-align: center;
-      max-width: 200px;
-      max-height: 400px;
-      padding: 2px;
-      font-family:
-        trebuchet ms,
-        verdana,
-        arial;
-      font-size: 12px;
-      background: #ffffde;
-      border: 1px solid #aa3;
-      border-radius: 2px;
-      pointer-events: none;
-      z-index: 100;
-    }
-    #mermaid-1592918098747 .actor {
-      stroke: #ccf;
-      fill: #ececff;
-    }
-    #mermaid-1592918098747 text.actor {
-      fill: #000;
-      stroke: none;
-    }
-    #mermaid-1592918098747 .actor-line {
-      stroke: grey;
-    }
-    #mermaid-1592918098747 .messageLine0 {
-      marker-end: 'url(#arrowhead)';
-    }
-    #mermaid-1592918098747 .messageLine0,
-    #mermaid-1592918098747 .messageLine1 {
-      stroke-width: 1.5;
-      stroke-dasharray: '2 2';
-      stroke: #333;
-    }
-    #mermaid-1592918098747 #arrowhead {
-      fill: #333;
-    }
-    #mermaid-1592918098747 #crosshead path {
-      fill: #333 !important;
-      stroke: #333 !important;
-    }
-    #mermaid-1592918098747 .messageText {
-      fill: #333;
-      stroke: none;
-    }
-    #mermaid-1592918098747 .labelBox {
-      stroke: #ccf;
-      fill: #ececff;
-    }
-    #mermaid-1592918098747 .labelText,
-    #mermaid-1592918098747 .loopText {
-      fill: #000;
-      stroke: none;
-    }
-    #mermaid-1592918098747 .loopLine {
-      stroke-width: 2;
-      stroke-dasharray: '2 2';
-      marker-end: 'url(#arrowhead)';
-      stroke: #ccf;
-    }
-    #mermaid-1592918098747 .note {
-      stroke: #aa3;
-      fill: #fff5ad;
-    }
-    #mermaid-1592918098747 .noteText {
-      fill: #000;
-      stroke: none;
-      font-family:
-        trebuchet ms,
-        verdana,
-        arial;
-      font-size: 14px;
-    }
-    #mermaid-1592918098747 .section {
-      stroke: none;
-      opacity: 0.2;
-    }
-    #mermaid-1592918098747 .section0 {
-      fill: rgba(102, 102, 255, 0.49);
-    }
-    #mermaid-1592918098747 .section2 {
-      fill: #fff400;
-    }
-    #mermaid-1592918098747 .section1,
-    #mermaid-1592918098747 .section3 {
-      fill: #fff;
-      opacity: 0.2;
-    }
-    #mermaid-1592918098747 .sectionTitle0,
-    #mermaid-1592918098747 .sectionTitle1,
-    #mermaid-1592918098747 .sectionTitle2,
-    #mermaid-1592918098747 .sectionTitle3 {
-      fill: #333;
-    }
-    #mermaid-1592918098747 .sectionTitle {
-      text-anchor: start;
-      font-size: 11px;
-      text-height: 14px;
-    }
-    #mermaid-1592918098747 .grid .tick {
-      stroke: #d3d3d3;
-      opacity: 0.3;
-      shape-rendering: crispEdges;
-    }
-    #mermaid-1592918098747 .grid path {
-      stroke-width: 0;
-    }
-    #mermaid-1592918098747 .today {
-      fill: none;
-      stroke: red;
-      stroke-width: 2px;
-    }
-    #mermaid-1592918098747 .task {
-      stroke-width: 2;
-    }
-    #mermaid-1592918098747 .taskText {
-      text-anchor: middle;
-      font-size: 11px;
-    }
-    #mermaid-1592918098747 .taskTextOutsideRight {
-      fill: #000;
-      text-anchor: start;
-      font-size: 11px;
-    }
-    #mermaid-1592918098747 .taskTextOutsideLeft {
-      fill: #000;
-      text-anchor: end;
-      font-size: 11px;
-    }
-    #mermaid-1592918098747 .taskText0,
-    #mermaid-1592918098747 .taskText1,
-    #mermaid-1592918098747 .taskText2,
-    #mermaid-1592918098747 .taskText3 {
-      fill: #fff;
-    }
-    #mermaid-1592918098747 .task0,
-    #mermaid-1592918098747 .task1,
-    #mermaid-1592918098747 .task2,
-    #mermaid-1592918098747 .task3 {
-      fill: #8a90dd;
-      stroke: #534fbc;
-    }
-    #mermaid-1592918098747 .taskTextOutside0,
-    #mermaid-1592918098747 .taskTextOutside1,
-    #mermaid-1592918098747 .taskTextOutside2,
-    #mermaid-1592918098747 .taskTextOutside3 {
-      fill: #000;
-    }
-    #mermaid-1592918098747 .active0,
-    #mermaid-1592918098747 .active1,
-    #mermaid-1592918098747 .active2,
-    #mermaid-1592918098747 .active3 {
-      fill: #bfc7ff;
-      stroke: #534fbc;
-    }
-    #mermaid-1592918098747 .activeText0,
-    #mermaid-1592918098747 .activeText1,
-    #mermaid-1592918098747 .activeText2,
-    #mermaid-1592918098747 .activeText3 {
-      fill: #000 !important;
-    }
-    #mermaid-1592918098747 .done0,
-    #mermaid-1592918098747 .done1,
-    #mermaid-1592918098747 .done2,
-    #mermaid-1592918098747 .done3 {
-      stroke: grey;
-      fill: #d3d3d3;
-      stroke-width: 2;
-    }
-    #mermaid-1592918098747 .doneText0,
-    #mermaid-1592918098747 .doneText1,
-    #mermaid-1592918098747 .doneText2,
-    #mermaid-1592918098747 .doneText3 {
-      fill: #000 !important;
-    }
-    #mermaid-1592918098747 .crit0,
-    #mermaid-1592918098747 .crit1,
-    #mermaid-1592918098747 .crit2,
-    #mermaid-1592918098747 .crit3 {
-      stroke: #f88;
-      fill: red;
-      stroke-width: 2;
-    }
-    #mermaid-1592918098747 .activeCrit0,
-    #mermaid-1592918098747 .activeCrit1,
-    #mermaid-1592918098747 .activeCrit2,
-    #mermaid-1592918098747 .activeCrit3 {
-      stroke: #f88;
-      fill: #bfc7ff;
-      stroke-width: 2;
-    }
-    #mermaid-1592918098747 .doneCrit0,
-    #mermaid-1592918098747 .doneCrit1,
-    #mermaid-1592918098747 .doneCrit2,
-    #mermaid-1592918098747 .doneCrit3 {
-      stroke: #f88;
-      fill: #d3d3d3;
-      stroke-width: 2;
-      cursor: pointer;
-      shape-rendering: crispEdges;
-    }
-    #mermaid-1592918098747 .activeCritText0,
-    #mermaid-1592918098747 .activeCritText1,
-    #mermaid-1592918098747 .activeCritText2,
-    #mermaid-1592918098747 .activeCritText3,
-    #mermaid-1592918098747 .doneCritText0,
-    #mermaid-1592918098747 .doneCritText1,
-    #mermaid-1592918098747 .doneCritText2,
-    #mermaid-1592918098747 .doneCritText3 {
-      fill: #000 !important;
-    }
-    #mermaid-1592918098747 .titleText {
-      text-anchor: middle;
-      font-size: 18px;
-      fill: #000;
-    }
-    #mermaid-1592918098747 g.classGroup text {
-      fill: #9370db;
-      stroke: none;
-      font-family:
-        trebuchet ms,
-        verdana,
-        arial;
-      font-size: 10px;
-    }
-    #mermaid-1592918098747 g.classGroup rect {
-      fill: #ececff;
-      stroke: #9370db;
-    }
-    #mermaid-1592918098747 g.classGroup line {
-      stroke: #9370db;
-      stroke-width: 1;
-    }
-    #mermaid-1592918098747 .classLabel .box {
-      stroke: none;
-      stroke-width: 0;
-      fill: #ececff;
-      opacity: 0.5;
-    }
-    #mermaid-1592918098747 .classLabel .label {
-      fill: #9370db;
-      font-size: 10px;
-    }
-    #mermaid-1592918098747 .relation {
-      stroke: #9370db;
-      stroke-width: 1;
-      fill: none;
-    }
-    #mermaid-1592918098747 #compositionEnd,
-    #mermaid-1592918098747 #compositionStart {
-      fill: #9370db;
-      stroke: #9370db;
-      stroke-width: 1;
-    }
-    #mermaid-1592918098747 #aggregationEnd,
-    #mermaid-1592918098747 #aggregationStart {
-      fill: #ececff;
-      stroke: #9370db;
-      stroke-width: 1;
-    }
-    #mermaid-1592918098747 #dependencyEnd,
-    #mermaid-1592918098747 #dependencyStart,
-    #mermaid-1592918098747 #extensionEnd,
-    #mermaid-1592918098747 #extensionStart {
-      fill: #9370db;
-      stroke: #9370db;
-      stroke-width: 1;
-    }
-    #mermaid-1592918098747 .branch-label,
-    #mermaid-1592918098747 .commit-id,
-    #mermaid-1592918098747 .commit-msg {
-      fill: #d3d3d3;
-      color: #d3d3d3;
-    }
-  </style>
-  <style>
-    #mermaid-1592918098747 {
-      color: rgb(0, 0, 0);
-      font: normal normal 400 normal 16px / normal 'Times New Roman';
-    }
-  </style>
-  <g transform="translate(-12, -12)">
-    <g class="output">
-      <g class="clusters"></g>
-      <g class="edgePaths">
-        <g class="edgePath" style="opacity: 1;">
-          <path
-            class="path"
-            d="M72.953125,59L72.953125,84L122.17626404494382,109"
-            marker-end="url(#arrowhead13)"
-            style="fill:none"
-          ></path>
-          <defs>
-            <marker
-              id="arrowhead13"
-              viewBox="0 0 10 10"
-              refX="9"
-              refY="5"
-              markerUnits="strokeWidth"
-              markerWidth="8"
-              markerHeight="6"
-              orient="auto"
-            >
-              <path
-                d="M 0 0 L 10 5 L 0 10 z"
-                class="arrowheadPath"
-                style="stroke-width: 1; stroke-dasharray: 1, 0;"
-              ></path>
-            </marker>
-          </defs>
-        </g>
-        <g class="edgePath" style="opacity: 1;">
-          <path
-            class="path"
-            d="M248.1875,59L248.1875,84L198.96436095505618,109"
-            marker-end="url(#arrowhead14)"
-            style="fill:none"
-          ></path>
-          <defs>
-            <marker
-              id="arrowhead14"
-              viewBox="0 0 10 10"
-              refX="9"
-              refY="5"
-              markerUnits="strokeWidth"
-              markerWidth="8"
-              markerHeight="6"
-              orient="auto"
-            >
-              <path
-                d="M 0 0 L 10 5 L 0 10 z"
-                class="arrowheadPath"
-                style="stroke-width: 1; stroke-dasharray: 1, 0;"
-              ></path>
-            </marker>
-          </defs>
-        </g>
-        <g class="edgePath" style="opacity: 1;">
-          <path
-            class="path"
-            d="M160.5703125,148L160.5703125,173L160.5703125,198"
-            marker-end="url(#arrowhead15)"
-            style="fill:none"
-          ></path>
-          <defs>
-            <marker
-              id="arrowhead15"
-              viewBox="0 0 10 10"
-              refX="9"
-              refY="5"
-              markerUnits="strokeWidth"
-              markerWidth="8"
-              markerHeight="6"
-              orient="auto"
-            >
-              <path
-                d="M 0 0 L 10 5 L 0 10 z"
-                class="arrowheadPath"
-                style="stroke-width: 1; stroke-dasharray: 1, 0;"
-              ></path>
-            </marker>
-          </defs>
-        </g>
-      </g>
-      <g class="edgeLabels">
-        <g class="edgeLabel" style="opacity: 1;" transform="">
-          <g transform="translate(0,0)" class="label">
-            <foreignObject width="0" height="0"
-              ><div
-                xmlns="http://www.w3.org/1999/xhtml"
-                style="display: inline-block; white-space: nowrap;"
-              >
-                <span class="edgeLabel"></span></div
-            ></foreignObject>
-          </g>
-        </g>
-        <g class="edgeLabel" style="opacity: 1;" transform="">
-          <g transform="translate(0,0)" class="label">
-            <foreignObject width="0" height="0"
-              ><div
-                xmlns="http://www.w3.org/1999/xhtml"
-                style="display: inline-block; white-space: nowrap;"
-              >
-                <span class="edgeLabel"></span></div
-            ></foreignObject>
-          </g>
-        </g>
-        <g class="edgeLabel" style="opacity: 1;" transform="">
-          <g transform="translate(0,0)" class="label">
-            <foreignObject width="0" height="0"
-              ><div
-                xmlns="http://www.w3.org/1999/xhtml"
-                style="display: inline-block; white-space: nowrap;"
-              >
-                <span class="edgeLabel"></span></div
-            ></foreignObject>
-          </g>
-        </g>
-      </g>
-      <g class="nodes">
-        <g class="node" id="queryConfig" transform="translate(72.953125,39.5)" style="opacity: 1;">
-          <rect rx="0" ry="0" x="-52.953125" y="-19.5" width="105.90625" height="39"></rect>
-          <g class="label" transform="translate(0,0)">
-            <g transform="translate(-42.953125,-9.5)">
-              <foreignObject width="85.90625" height="19"
-                ><div
-                  xmlns="http://www.w3.org/1999/xhtml"
-                  style="display: inline-block; white-space: nowrap;"
-                >
-                  queryConfig
-                </div></foreignObject
-              >
-            </g>
-          </g>
-        </g>
-        <g
-          class="node"
-          id="providence"
-          transform="translate(160.5703125,128.5)"
-          style="opacity: 1;"
-        >
-          <rect rx="0" ry="0" x="-49.578125" y="-19.5" width="99.15625" height="39"></rect>
-          <g class="label" transform="translate(0,0)">
-            <g transform="translate(-39.578125,-9.5)">
-              <foreignObject width="79.15625" height="19"
-                ><div
-                  xmlns="http://www.w3.org/1999/xhtml"
-                  style="display: inline-block; white-space: nowrap;"
-                >
-                  providence
-                </div></foreignObject
-              >
-            </g>
-          </g>
-        </g>
-        <g
-          class="node"
-          id="ProvidenceConfig"
-          transform="translate(248.1875,39.5)"
-          style="opacity: 1;"
-        >
-          <rect rx="0" ry="0" x="-72.28125" y="-19.5" width="144.5625" height="39"></rect>
-          <g class="label" transform="translate(0,0)">
-            <g transform="translate(-62.28125,-9.5)">
-              <foreignObject width="124.5625" height="19"
-                ><div
-                  xmlns="http://www.w3.org/1999/xhtml"
-                  style="display: inline-block; white-space: nowrap;"
-                >
-                  ProvidenceConfig
-                </div></foreignObject
-              >
-            </g>
-          </g>
-        </g>
-        <g
-          class="node"
-          id="QueryResult"
-          transform="translate(160.5703125,217.5)"
-          style="opacity: 1;"
-        >
-          <rect rx="0" ry="0" x="-53.359375" y="-19.5" width="106.71875" height="39"></rect>
-          <g class="label" transform="translate(0,0)">
-            <g transform="translate(-43.359375,-9.5)">
-              <foreignObject width="86.71875" height="19"
-                ><div
-                  xmlns="http://www.w3.org/1999/xhtml"
-                  style="display: inline-block; white-space: nowrap;"
-                >
-                  QueryResult
-                </div></foreignObject
-              >
-            </g>
-          </g>
-        </g>
-      </g>
-    </g>
-  </g>
-</svg>`;
-
-/*
-
-```mermaid
-sequenceDiagram
-    participant providence
-    participant InputDataService
-    participant QueryService
-    participant ReportService
-    providence->>InputDataService: Give all search targets, based on 'queryConfig'
-    InputDataService->>providence: 'InputData'
-    providence->>QueryService: Run query, based on 'queryConfig'
-    QueryService->>providence: 'QueryResult'
-    providence->>ReportService: Give a report, based on 'QueryResult' and 'ProvidenceConfig'
-    ReportService->>providence: Done...
-```
-
-*/
-export const providenceInternalFlowSvg = html`
-  <svg
-    id="mermaid-1592918099462"
-    xmlns="http://www.w3.org/2000/svg"
-    width="100%"
-    height="100%"
-    style="max-width:850px; max-height: 400px;"
-    viewBox="-50 -10 850 371"
-  >
-    <style>
-      #mermaid-1592918099462 .label {
-        font-family:
-          trebuchet ms,
-          verdana,
-          arial;
-        color: #333;
-      }
-      #mermaid-1592918099462 .node circle,
-      #mermaid-1592918099462 .node ellipse,
-      #mermaid-1592918099462 .node polygon,
-      #mermaid-1592918099462 .node rect {
-        fill: #ececff;
-        stroke: #9370db;
-        stroke-width: 1px;
-      }
-      #mermaid-1592918099462 .node.clickable {
-        cursor: pointer;
-      }
-      #mermaid-1592918099462 .arrowheadPath {
-        fill: #333;
-      }
-      #mermaid-1592918099462 .edgePath .path {
-        stroke: #333;
-        stroke-width: 1.5px;
-      }
-      #mermaid-1592918099462 .edgeLabel {
-        background-color: #e8e8e8;
-      }
-      #mermaid-1592918099462 .cluster rect {
-        fill: #ffffde !important;
-        stroke: #aa3 !important;
-        stroke-width: 1px !important;
-      }
-      #mermaid-1592918099462 .cluster text {
-        fill: #333;
-      }
-      #mermaid-1592918099462 div.mermaidTooltip {
-        position: absolute;
-        text-align: center;
-        max-width: 200px;
-        max-height: 400px;
-        padding: 2px;
-        font-family:
-          trebuchet ms,
-          verdana,
-          arial;
-        font-size: 12px;
-        background: #ffffde;
-        border: 1px solid #aa3;
-        border-radius: 2px;
-        pointer-events: none;
-        z-index: 100;
-      }
-      #mermaid-1592918099462 .actor {
-        stroke: #ccf;
-        fill: #ececff;
-      }
-      #mermaid-1592918099462 text.actor {
-        fill: #000;
-        stroke: none;
-      }
-      #mermaid-1592918099462 .actor-line {
-        stroke: grey;
-      }
-      #mermaid-1592918099462 .messageLine0 {
-        marker-end: 'url(#arrowhead)';
-      }
-      #mermaid-1592918099462 .messageLine0,
-      #mermaid-1592918099462 .messageLine1 {
-        stroke-width: 1.5;
-        stroke-dasharray: '2 2';
-        stroke: #333;
-      }
-      #mermaid-1592918099462 #arrowhead {
-        fill: #333;
-      }
-      #mermaid-1592918099462 #crosshead path {
-        fill: #333 !important;
-        stroke: #333 !important;
-      }
-      #mermaid-1592918099462 .messageText {
-        fill: #333;
-        stroke: none;
-      }
-      #mermaid-1592918099462 .labelBox {
-        stroke: #ccf;
-        fill: #ececff;
-      }
-      #mermaid-1592918099462 .labelText,
-      #mermaid-1592918099462 .loopText {
-        fill: #000;
-        stroke: none;
-      }
-      #mermaid-1592918099462 .loopLine {
-        stroke-width: 2;
-        stroke-dasharray: '2 2';
-        marker-end: 'url(#arrowhead)';
-        stroke: #ccf;
-      }
-      #mermaid-1592918099462 .note {
-        stroke: #aa3;
-        fill: #fff5ad;
-      }
-      #mermaid-1592918099462 .noteText {
-        fill: #000;
-        stroke: none;
-        font-family:
-          trebuchet ms,
-          verdana,
-          arial;
-        font-size: 14px;
-      }
-      #mermaid-1592918099462 .section {
-        stroke: none;
-        opacity: 0.2;
-      }
-      #mermaid-1592918099462 .section0 {
-        fill: rgba(102, 102, 255, 0.49);
-      }
-      #mermaid-1592918099462 .section2 {
-        fill: #fff400;
-      }
-      #mermaid-1592918099462 .section1,
-      #mermaid-1592918099462 .section3 {
-        fill: #fff;
-        opacity: 0.2;
-      }
-      #mermaid-1592918099462 .sectionTitle0,
-      #mermaid-1592918099462 .sectionTitle1,
-      #mermaid-1592918099462 .sectionTitle2,
-      #mermaid-1592918099462 .sectionTitle3 {
-        fill: #333;
-      }
-      #mermaid-1592918099462 .sectionTitle {
-        text-anchor: start;
-        font-size: 11px;
-        text-height: 14px;
-      }
-      #mermaid-1592918099462 .grid .tick {
-        stroke: #d3d3d3;
-        opacity: 0.3;
-        shape-rendering: crispEdges;
-      }
-      #mermaid-1592918099462 .grid path {
-        stroke-width: 0;
-      }
-      #mermaid-1592918099462 .today {
-        fill: none;
-        stroke: red;
-        stroke-width: 2px;
-      }
-      #mermaid-1592918099462 .task {
-        stroke-width: 2;
-      }
-      #mermaid-1592918099462 .taskText {
-        text-anchor: middle;
-        font-size: 11px;
-      }
-      #mermaid-1592918099462 .taskTextOutsideRight {
-        fill: #000;
-        text-anchor: start;
-        font-size: 11px;
-      }
-      #mermaid-1592918099462 .taskTextOutsideLeft {
-        fill: #000;
-        text-anchor: end;
-        font-size: 11px;
-      }
-      #mermaid-1592918099462 .taskText0,
-      #mermaid-1592918099462 .taskText1,
-      #mermaid-1592918099462 .taskText2,
-      #mermaid-1592918099462 .taskText3 {
-        fill: #fff;
-      }
-      #mermaid-1592918099462 .task0,
-      #mermaid-1592918099462 .task1,
-      #mermaid-1592918099462 .task2,
-      #mermaid-1592918099462 .task3 {
-        fill: #8a90dd;
-        stroke: #534fbc;
-      }
-      #mermaid-1592918099462 .taskTextOutside0,
-      #mermaid-1592918099462 .taskTextOutside1,
-      #mermaid-1592918099462 .taskTextOutside2,
-      #mermaid-1592918099462 .taskTextOutside3 {
-        fill: #000;
-      }
-      #mermaid-1592918099462 .active0,
-      #mermaid-1592918099462 .active1,
-      #mermaid-1592918099462 .active2,
-      #mermaid-1592918099462 .active3 {
-        fill: #bfc7ff;
-        stroke: #534fbc;
-      }
-      #mermaid-1592918099462 .activeText0,
-      #mermaid-1592918099462 .activeText1,
-      #mermaid-1592918099462 .activeText2,
-      #mermaid-1592918099462 .activeText3 {
-        fill: #000 !important;
-      }
-      #mermaid-1592918099462 .done0,
-      #mermaid-1592918099462 .done1,
-      #mermaid-1592918099462 .done2,
-      #mermaid-1592918099462 .done3 {
-        stroke: grey;
-        fill: #d3d3d3;
-        stroke-width: 2;
-      }
-      #mermaid-1592918099462 .doneText0,
-      #mermaid-1592918099462 .doneText1,
-      #mermaid-1592918099462 .doneText2,
-      #mermaid-1592918099462 .doneText3 {
-        fill: #000 !important;
-      }
-      #mermaid-1592918099462 .crit0,
-      #mermaid-1592918099462 .crit1,
-      #mermaid-1592918099462 .crit2,
-      #mermaid-1592918099462 .crit3 {
-        stroke: #f88;
-        fill: red;
-        stroke-width: 2;
-      }
-      #mermaid-1592918099462 .activeCrit0,
-      #mermaid-1592918099462 .activeCrit1,
-      #mermaid-1592918099462 .activeCrit2,
-      #mermaid-1592918099462 .activeCrit3 {
-        stroke: #f88;
-        fill: #bfc7ff;
-        stroke-width: 2;
-      }
-      #mermaid-1592918099462 .doneCrit0,
-      #mermaid-1592918099462 .doneCrit1,
-      #mermaid-1592918099462 .doneCrit2,
-      #mermaid-1592918099462 .doneCrit3 {
-        stroke: #f88;
-        fill: #d3d3d3;
-        stroke-width: 2;
-        cursor: pointer;
-        shape-rendering: crispEdges;
-      }
-      #mermaid-1592918099462 .activeCritText0,
-      #mermaid-1592918099462 .activeCritText1,
-      #mermaid-1592918099462 .activeCritText2,
-      #mermaid-1592918099462 .activeCritText3,
-      #mermaid-1592918099462 .doneCritText0,
-      #mermaid-1592918099462 .doneCritText1,
-      #mermaid-1592918099462 .doneCritText2,
-      #mermaid-1592918099462 .doneCritText3 {
-        fill: #000 !important;
-      }
-      #mermaid-1592918099462 .titleText {
-        text-anchor: middle;
-        font-size: 18px;
-        fill: #000;
-      }
-      #mermaid-1592918099462 g.classGroup text {
-        fill: #9370db;
-        stroke: none;
-        font-family:
-          trebuchet ms,
-          verdana,
-          arial;
-        font-size: 10px;
-      }
-      #mermaid-1592918099462 g.classGroup rect {
-        fill: #ececff;
-        stroke: #9370db;
-      }
-      #mermaid-1592918099462 g.classGroup line {
-        stroke: #9370db;
-        stroke-width: 1;
-      }
-      #mermaid-1592918099462 .classLabel .box {
-        stroke: none;
-        stroke-width: 0;
-        fill: #ececff;
-        opacity: 0.5;
-      }
-      #mermaid-1592918099462 .classLabel .label {
-        fill: #9370db;
-        font-size: 10px;
-      }
-      #mermaid-1592918099462 .relation {
-        stroke: #9370db;
-        stroke-width: 1;
-        fill: none;
-      }
-      #mermaid-1592918099462 #compositionEnd,
-      #mermaid-1592918099462 #compositionStart {
-        fill: #9370db;
-        stroke: #9370db;
-        stroke-width: 1;
-      }
-      #mermaid-1592918099462 #aggregationEnd,
-      #mermaid-1592918099462 #aggregationStart {
-        fill: #ececff;
-        stroke: #9370db;
-        stroke-width: 1;
-      }
-      #mermaid-1592918099462 #dependencyEnd,
-      #mermaid-1592918099462 #dependencyStart,
-      #mermaid-1592918099462 #extensionEnd,
-      #mermaid-1592918099462 #extensionStart {
-        fill: #9370db;
-        stroke: #9370db;
-        stroke-width: 1;
-      }
-      #mermaid-1592918099462 .branch-label,
-      #mermaid-1592918099462 .commit-id,
-      #mermaid-1592918099462 .commit-msg {
-        fill: #d3d3d3;
-        color: #d3d3d3;
-      }
-    </style>
-    <style>
-      #mermaid-1592918099462 {
-        color: rgb(0, 0, 0);
-        font: normal normal 400 normal 16px / normal 'Times New Roman';
-      }
-    </style>
-    <g></g>
-    <g>
-      <line
-        id="actor0"
-        x1="75"
-        y1="5"
-        x2="75"
-        y2="360"
-        class="actor-line"
-        stroke-width="0.5px"
-        stroke="#999"
-      ></line>
-      <rect
-        x="0"
-        y="0"
-        fill="#eaeaea"
-        stroke="#666"
-        width="150"
-        height="65"
-        rx="3"
-        ry="3"
-        class="actor"
-      ></rect>
-      <text
-        x="75"
-        y="32.5"
-        dominant-baseline="central"
-        alignment-baseline="central"
-        class="actor"
-        style="text-anchor: middle;"
-      >
-        <tspan x="75" dy="0">providence</tspan>
-      </text>
-    </g>
-    <g>
-      <line
-        id="actor1"
-        x1="275"
-        y1="5"
-        x2="275"
-        y2="360"
-        class="actor-line"
-        stroke-width="0.5px"
-        stroke="#999"
-      ></line>
-      <rect
-        x="200"
-        y="0"
-        fill="#eaeaea"
-        stroke="#666"
-        width="150"
-        height="65"
-        rx="3"
-        ry="3"
-        class="actor"
-      ></rect>
-      <text
-        x="275"
-        y="32.5"
-        dominant-baseline="central"
-        alignment-baseline="central"
-        class="actor"
-        style="text-anchor: middle;"
-      >
-        <tspan x="275" dy="0">InputDataService</tspan>
-      </text>
-    </g>
-    <g>
-      <line
-        id="actor2"
-        x1="475"
-        y1="5"
-        x2="475"
-        y2="360"
-        class="actor-line"
-        stroke-width="0.5px"
-        stroke="#999"
-      ></line>
-      <rect
-        x="400"
-        y="0"
-        fill="#eaeaea"
-        stroke="#666"
-        width="150"
-        height="65"
-        rx="3"
-        ry="3"
-        class="actor"
-      ></rect>
-      <text
-        x="475"
-        y="32.5"
-        dominant-baseline="central"
-        alignment-baseline="central"
-        class="actor"
-        style="text-anchor: middle;"
-      >
-        <tspan x="475" dy="0">QueryService</tspan>
-      </text>
-    </g>
-    <g>
-      <line
-        id="actor3"
-        x1="675"
-        y1="5"
-        x2="675"
-        y2="360"
-        class="actor-line"
-        stroke-width="0.5px"
-        stroke="#999"
-      ></line>
-      <rect
-        x="600"
-        y="0"
-        fill="#eaeaea"
-        stroke="#666"
-        width="150"
-        height="65"
-        rx="3"
-        ry="3"
-        class="actor"
-      ></rect>
-      <text
-        x="675"
-        y="32.5"
-        dominant-baseline="central"
-        alignment-baseline="central"
-        class="actor"
-        style="text-anchor: middle;"
-      >
-        <tspan x="675" dy="0">ReportService</tspan>
-      </text>
-    </g>
-    <defs>
-      <marker id="arrowhead" refX="5" refY="2" markerWidth="6" markerHeight="4" orient="auto">
-        <path d="M 0,0 V 4 L6,2 Z"></path>
-      </marker>
-    </defs>
-    <defs>
-      <marker id="crosshead" markerWidth="15" markerHeight="8" orient="auto" refX="16" refY="4">
-        <path
-          fill="black"
-          stroke="#000000"
-          stroke-width="1px"
-          d="M 9,2 V 6 L16,4 Z"
-          style="stroke-dasharray: 0, 0;"
-        ></path>
-        <path
-          fill="none"
-          stroke="#000000"
-          stroke-width="1px"
-          d="M 0,1 L 6,7 M 6,1 L 0,7"
-          style="stroke-dasharray: 0, 0;"
-        ></path>
-      </marker>
-    </defs>
-    <g>
-      <text x="175" y="93" class="messageText" style="text-anchor: middle;">
-        Give all search targets, based on 'queryConfig'
-      </text>
-      <line
-        x1="75"
-        y1="100"
-        x2="275"
-        y2="100"
-        class="messageLine0"
-        stroke-width="2"
-        stroke="black"
-        marker-end="url(#arrowhead)"
-        style="fill: none;"
-      ></line>
-    </g>
-    <g>
-      <text x="175" y="128" class="messageText" style="text-anchor: middle;">'InputData'</text>
-      <line
-        x1="275"
-        y1="135"
-        x2="75"
-        y2="135"
-        class="messageLine0"
-        stroke-width="2"
-        stroke="black"
-        marker-end="url(#arrowhead)"
-        style="fill: none;"
-      ></line>
-    </g>
-    <g>
-      <text x="275" y="163" class="messageText" style="text-anchor: middle;">
-        Run query, based on 'queryConfig'
-      </text>
-      <line
-        x1="75"
-        y1="170"
-        x2="475"
-        y2="170"
-        class="messageLine0"
-        stroke-width="2"
-        stroke="black"
-        marker-end="url(#arrowhead)"
-        style="fill: none;"
-      ></line>
-    </g>
-    <g>
-      <text x="275" y="198" class="messageText" style="text-anchor: middle;">'QueryResult'</text>
-      <line
-        x1="475"
-        y1="205"
-        x2="75"
-        y2="205"
-        class="messageLine0"
-        stroke-width="2"
-        stroke="black"
-        marker-end="url(#arrowhead)"
-        style="fill: none;"
-      ></line>
-    </g>
-    <g>
-      <text x="375" y="233" class="messageText" style="text-anchor: middle;">
-        Give a report, based on 'QueryResult' and 'ProvidenceConfig'
-      </text>
-      <line
-        x1="75"
-        y1="240"
-        x2="675"
-        y2="240"
-        class="messageLine0"
-        stroke-width="2"
-        stroke="black"
-        marker-end="url(#arrowhead)"
-        style="fill: none;"
-      ></line>
-    </g>
-    <g>
-      <text x="375" y="268" class="messageText" style="text-anchor: middle;">Done...</text>
-      <line
-        x1="675"
-        y1="275"
-        x2="75"
-        y2="275"
-        class="messageLine0"
-        stroke-width="2"
-        stroke="black"
-        marker-end="url(#arrowhead)"
-        style="fill: none;"
-      ></line>
-    </g>
-    <g>
-      <rect
-        x="0"
-        y="295"
-        fill="#eaeaea"
-        stroke="#666"
-        width="150"
-        height="65"
-        rx="3"
-        ry="3"
-        class="actor"
-      ></rect>
-      <text
-        x="75"
-        y="327.5"
-        dominant-baseline="central"
-        alignment-baseline="central"
-        class="actor"
-        style="text-anchor: middle;"
-      >
-        <tspan x="75" dy="0">providence</tspan>
-      </text>
-    </g>
-    <g>
-      <rect
-        x="200"
-        y="295"
-        fill="#eaeaea"
-        stroke="#666"
-        width="150"
-        height="65"
-        rx="3"
-        ry="3"
-        class="actor"
-      ></rect>
-      <text
-        x="275"
-        y="327.5"
-        dominant-baseline="central"
-        alignment-baseline="central"
-        class="actor"
-        style="text-anchor: middle;"
-      >
-        <tspan x="275" dy="0">InputDataService</tspan>
-      </text>
-    </g>
-    <g>
-      <rect
-        x="400"
-        y="295"
-        fill="#eaeaea"
-        stroke="#666"
-        width="150"
-        height="65"
-        rx="3"
-        ry="3"
-        class="actor"
-      ></rect>
-      <text
-        x="475"
-        y="327.5"
-        dominant-baseline="central"
-        alignment-baseline="central"
-        class="actor"
-        style="text-anchor: middle;"
-      >
-        <tspan x="475" dy="0">QueryService</tspan>
-      </text>
-    </g>
-    <g>
-      <rect
-        x="600"
-        y="295"
-        fill="#eaeaea"
-        stroke="#666"
-        width="150"
-        height="65"
-        rx="3"
-        ry="3"
-        class="actor"
-      ></rect>
-      <text
-        x="675"
-        y="327.5"
-        dominant-baseline="central"
-        alignment-baseline="central"
-        class="actor"
-        style="text-anchor: middle;"
-      >
-        <tspan x="675" dy="0">ReportService</tspan>
-      </text>
-    </g>
-  </svg>
-`;
diff --git a/docs/fundamentals/node-tools/providence-analytics/assets/analyzer-query.gif b/docs/fundamentals/node-tools/providence-analytics/assets/analyzer-query.gif
deleted file mode 100644
index 167be4e174..0000000000
Binary files a/docs/fundamentals/node-tools/providence-analytics/assets/analyzer-query.gif and /dev/null differ
diff --git a/docs/fundamentals/node-tools/providence-analytics/assets/feature-query.gif b/docs/fundamentals/node-tools/providence-analytics/assets/feature-query.gif
deleted file mode 100644
index cfe9aebb7f..0000000000
Binary files a/docs/fundamentals/node-tools/providence-analytics/assets/feature-query.gif and /dev/null differ
diff --git a/docs/fundamentals/node-tools/providence-analytics/assets/provicli.gif b/docs/fundamentals/node-tools/providence-analytics/assets/provicli.gif
deleted file mode 100644
index 72ca8657e5..0000000000
Binary files a/docs/fundamentals/node-tools/providence-analytics/assets/provicli.gif and /dev/null differ
diff --git a/docs/fundamentals/node-tools/providence-analytics/assets/providash.gif b/docs/fundamentals/node-tools/providence-analytics/assets/providash.gif
deleted file mode 100644
index 92c314905f..0000000000
Binary files a/docs/fundamentals/node-tools/providence-analytics/assets/providash.gif and /dev/null differ
diff --git a/docs/fundamentals/node-tools/providence-analytics/dashboard.md b/docs/fundamentals/node-tools/providence-analytics/dashboard.md
deleted file mode 100644
index 73468d885a..0000000000
--- a/docs/fundamentals/node-tools/providence-analytics/dashboard.md
+++ /dev/null
@@ -1,22 +0,0 @@
-# Node Tools >> Providence Analytics >> Dashboard ||30
-
-An interactive overview of all aggregated [QueryResults](../../../fundamentals/node-tools/providence-analytics/QueryResult.md) can be found in the dashboard.
-The dashboard is a small nodejs server (based on es-dev-server + middleware) and a frontend
-application.
-
-## Run
-
-Start the dashboard via `providence dashboard` to automatically open the browser and start the dashboard.
-
-## Interface
-
-- Select all reference projects
-- Select all target projects
-
-### Generate csv
-
-When `get csv` is pressed, a `.csv` will be downloaded that can be loaded into Excel.
-
-## Analyzer support
-
-Currently, `match-imports` and `match-subclasses` are supported, more analyzers will be added in the future.
diff --git a/docs/fundamentals/node-tools/providence-analytics/overview.md b/docs/fundamentals/node-tools/providence-analytics/overview.md
index b91bc281c8..2f48cd1c7e 100644
--- a/docs/fundamentals/node-tools/providence-analytics/overview.md
+++ b/docs/fundamentals/node-tools/providence-analytics/overview.md
@@ -2,7 +2,6 @@
 
 ```js script
 import { html } from '@mdjs/mdjs-preview';
-import { providenceFlowSvg, providenceInternalFlowSvg } from './assets/_mermaid.svg.js';
 ```
 
 Providence is the 'All Seeing Eye' that generates usage statistics by analyzing code.
@@ -10,8 +9,6 @@ It measures the effectivity and popularity of your software.
 With just a few commands you can measure the impact for (breaking) changes, making
 your release process more stable and predictable.
 
-Providence can be used as a dev dependency in a project for which metrics
-can be generated via analyzers (see below).
 For instance for a repo "lion-based-ui" that extends @lion/\* we can answer questions like:
 
 - **Which subsets of my product are popular?**
@@ -23,170 +20,76 @@ For instance for a repo "lion-based-ui" that extends @lion/\* we can answer ques
 
 - etc...
 
-All the above results can be shown in a dashboard (see below), which allows to sort exports from reference project (@lion) based on popularity, category, consumer etc.
-The dashboard allows to aggregate data from many target projects as well and will show you on a detailed (file) level how those components are being consumed by which projects.
+Providence uses abstract syntax trees (ASTs) to have the most advanced analysis possible.
+It does this via the [oxc parser](https://oxc.rs/docs/guide/usage/parser.html), the quickest parser available today!
 
-## Setup
+## Run
 
-### Install providence
+Providence expects an analyzer name that tells it what type of analysis to run:
 
 ```bash
-npm i --save-dev providence-analytics
+npx providence analyze <analyzer-name>
 ```
 
-### Add a providence script to package.json
+By default Providence ships these analyzers:
 
-```json
-"scripts": {
-  "providence:match-imports": "providence analyze match-imports -r 'node_modules/@lion/ui/*.js'",
-}
-```
-
-> The example above illustrates how to run the "match-imports" analyzer for reference project 'lion-based-ui'. Note that it is possible to run other analyzers and configurations supported by providence as well. For a full overview of cli options, run `npx providence --help`. All supported analyzers will be viewed when running `npx providence analyze`
-
-You are now ready to use providence in your project. All
-data will be stored in json files in the folder `./providence-output`
-
-![CLI](./assets/provicli.gif 'CLI')
-
-## Setup: Dashboard
-
-### Add "providence:dashboard" script to package.json
-
-```js
-...
-"scripts": {
-    ...
-    "providence:dashboard": "providence dashboard"
-}
-```
-
-### Add providence.conf.js
-
-```js
-export default {
-  referenceCollections: {
-    'lion-based-ui-collection': [
-      './node_modules/lion-based-ui/packages/x',
-      './node_modules/lion-based-ui/packages/y',
-    ],
-  },
-};
-```
-
-Run `npm run providence:dashboard`
-
-![dashboard](./assets/providash.gif 'dashboard')
-
-## Setup: about result output
-
-All output files will be stored in `./providence-output`.
-This means they will be committed to git, so your colleagues don't have to
-rerun the analysis (for large projects with many dependencies this can be time consuming)
-and can directly start the dashboard usage metrics.
-Also, note that the files serve as cache (they are stored with hashes based on project version and analyzer configuration). This means that an interrupted analysis can be
-resumed later on.
-
-## Conceptual overview
-
-Providence performs queries on one or more search targets.
-These search targets consist of one or more software projects (javascript/html repositories)
-
-The diagram below shows how `providenceMain` function can be used from an external context.
-
-```js story
-export const providenceFlow = () => providenceFlowSvg;
-```
-
-## Flow inside providence
-
-The diagram below depicts the flow inside the `providenceMain` function.
-It uses:
-
-- InputDataService
-  Used to create a data structure based on a folder (for instance the search target or
-  the references root). The structure creates entries for every file, which get enriched with code,
-  ast results, query results etc. Returns `InputData` object.
-- QueryService
-  Requires a `queryConfig` and `InputData` object. It will perform a query (grep search or ast analysis)
-  and returns a `QueryResult`.
-  It also contains helpers for the creation of a `queryConfig`
-- ReportService
-  The result gets outputted to the user. Currently, a log to the console and/or a dump to a json file
-  are available as output formats.
-
-```js story
-export const providenceInternalFlow = () => providenceInternalFlowSvg;
-```
-
-## Queries
-
-Providence requires a queries as input.
-Queries are defined as objects and can be of two types:
-
-- feature-query
-- ast-analyzer
-
-A `QueryConfig` is required as input to run the `providenceMain` function.
-This object specifies the type of query and contains the relevant meta
-information that will later be outputted in the `QueryResult` (the JSON object that
-the `providenceMain` function returns.)
-
-## Analyzer Query
-
-Analyzer queries are also created via `QueryConfig`s.
-
-Analyzers can be described as predefined queries that use AST traversal.
+- find-imports
+- find-exports
+- find-classes
+- match-imports
+- match-subclasses
 
-Run:
+Let's say we run `find-imports`:
 
 ```bash
-providence analyze
+npx providence analyze find-imports
 ```
 
-Now you will get a list of all predefined analyzers:
+Now it retrieves all relevant data about es module imports.
+There are plenty of edge cases that it needs to take into account here;
+you can have a look at the tests to get an idea about all different cases Providence handles for you.
 
-- find-imports
-- find-exports
-- find-classes
-- match-imports
-- match-subclasses
-- etc...
+## Projects
+
+Providence uses the concept of projects. A project is a piece of software to analyze:
+usually an npm artifact or a git (mono-)repository. What all projects have in common,
+is a package.json. From it, the following project data is derived:
 
-![Analyzer query](./assets/analyzer-query.gif 'Analyzer query')
+- the name
+- the version
+- the files it uses for scanning. One of the following strategies is usually followed:
+  - exportmap entrypoints (by 'expanding' package.json "exports" on file system)
+  - npm files (it reads package.json "files" | .npmignore)
+  - the git files (it reads .gitignore)
+  - a custom defined list
 
-<!--
-## Running providence from its own repo
+For a "find" analyzer, there is one project involved (the target project).
 
-### How to add a new search target project
+We can specify it like this (we override the default current working directory):
 
 ```bash
-git submodule add <git-url> ./providence-input-data/search-targets/<project-name>
+npx providence analyze find-imports -t /importing/project
 ```
 
-### How to add a reference project
-
-By adding a reference project, you can automatically see how code in your reference project is
-used across the search target projects.
-Under the hood, this automatically creates a set of queries for you.
+For a "match" analyzer, there is also a reference project.
+Here we match the exports of the reference project (-r) against the imports of the target project (-t).
 
 ```bash
-git submodule add <git-url> ./providence-input-data/references/<project-name>
+npx providence analyze match-imports -t /importing/project -r /exporting/project
 ```
 
-### Updating submodules
+## Utils
 
-Please run:
+Providence comes with many tools for deep traversal of identifiers,
+the (babel like) traversal of ast trees in oxc and swc and more.
+Also more generic utils for caching and performant globbing come delivered with Providence.
 
-```bash
-git submodule update --init --recursive
-```
+For a better understanding, check out the utils folders (tests and code).
 
-### Removing submodules
+## More
 
-Please run:
+For more options, see:
 
 ```bash
-sh ./rm-submodule.sh <path/to/submodule>
+npx providence --help
 ```
--->