From 890298457a8f28b21d98cb776c9c3fdbb4a28fcf Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Sat, 29 Feb 2020 00:03:42 -0800
Subject: [PATCH 01/34] Update README.md

---
 docs/README.md | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/docs/README.md b/docs/README.md
index 4fb40e62b..a52ae5b36 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -6,13 +6,14 @@
 
 ![banner](./img/header.png)
 
-Generation of diagrams and flowcharts from text in a similar manner as markdown.
+mermaid offers the capacity to generate diagrams and charts from markdown inspired text.
 
-Ever wanted to simplify documentation and avoid heavy tools like Visio when explaining your code?
+The reasoning behind it's inception was a need for simplified documentation and frustration with heavy and time consuming tools like Visio, for explaining code?
 
-This is why mermaid was born, a simple markdown-like script language for generating charts from text via javascript.
+Thus a simple markdown-inspired, script language for diagramming and charting, via javascript was made.
 
 Check out the list of [Integrations and Usages of Mermaid](./integrations.md)
+For the uninitiated, you can also  try out our [live editor](https://mermaid-js.github.io/mermaid-live-editor/) and look at our [documentation](https://mermaid-js.github.io/mermaid/#/n00b-overview) for a deeper understanding of the tool itself, more importantly don't forget to have fun. 
 
 **Mermaid was nominated and won the JS Open Source Awards (2019) in the category "The most exciting use of technology"!!! Thanks to all involved, people committing pull requests, people answering questions and special thanks to Tyler Long who is helping me maintain the project.**
 
@@ -41,9 +42,9 @@ mermaidAPI.initialize({
 });
 ```
 
-**🖖 Keep a steady pulse: mermaid needs more Collaborators [#866](https://github.com/knsv/mermaid/issues/866)**
+**🖖 Keep a steady pulse: mermaid needs more Collaborators [#866](https://github.com/k3nsv/mermaid/issues/866)**
 
-## Diagrams
+## The following are examples of Diagrams that mermaid can make.
 
 ### Flowchart
 

From cda41a15061d79536466444d2458957f22b751ee Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Sat, 29 Feb 2020 00:04:38 -0800
Subject: [PATCH 02/34] Update README.md

---
 docs/README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/README.md b/docs/README.md
index a52ae5b36..e1c400b9f 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -5,7 +5,7 @@
 [![Join the chat at https://gitter.im/knsv/mermaid](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/knsv/mermaid?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
 ![banner](./img/header.png)
-
+# What is mermaid?
 mermaid offers the capacity to generate diagrams and charts from markdown inspired text.
 
 The reasoning behind it's inception was a need for simplified documentation and frustration with heavy and time consuming tools like Visio, for explaining code?
@@ -44,7 +44,7 @@ mermaidAPI.initialize({
 
 **🖖 Keep a steady pulse: mermaid needs more Collaborators [#866](https://github.com/k3nsv/mermaid/issues/866)**
 
-## The following are examples of Diagrams that mermaid can make.
+## The following are examples of Diagrams that mermaid can make:
 
 ### Flowchart
 

From 5693c694578dab6ade5a6214543946543eeecf76 Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Sat, 29 Feb 2020 00:07:47 -0800
Subject: [PATCH 03/34] Update README.md

---
 docs/README.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/README.md b/docs/README.md
index e1c400b9f..22151a6f2 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -6,11 +6,12 @@
 
 ![banner](./img/header.png)
 # What is mermaid?
-mermaid offers the capacity to generate diagrams and charts from markdown inspired text.
 
-The reasoning behind it's inception was a need for simplified documentation and frustration with heavy and time consuming tools like Visio, for explaining code?
+It is a simple markdown-inspired, script language for diagramming and charting that can be deployed via Javascipt.
 
-Thus a simple markdown-inspired, script language for diagramming and charting, via javascript was made.
+The reasoning behind it's inception was a need for simplified documentation and frustration with heavy and time consuming tools like Visio, for explaining code. 
+
+Thus mermaid was created to make the process of diagramming and charting, as simple and as close to markdown, as possible.
 
 Check out the list of [Integrations and Usages of Mermaid](./integrations.md)
 For the uninitiated, you can also  try out our [live editor](https://mermaid-js.github.io/mermaid-live-editor/) and look at our [documentation](https://mermaid-js.github.io/mermaid/#/n00b-overview) for a deeper understanding of the tool itself, more importantly don't forget to have fun. 

From a0b1d16e79c345fce0ba0d243ed803d03358f778 Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Mon, 2 Mar 2020 16:47:08 -0800
Subject: [PATCH 04/34] Update SUMMARY.md

---
 docs/SUMMARY.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md
index e4be903f9..f40657a49 100644
--- a/docs/SUMMARY.md
+++ b/docs/SUMMARY.md
@@ -1,6 +1,6 @@
 # Summary
 
-- [mermaid](README.md)
+- [mermaid-README](README.md)
 - [FAQ](faq.md)
 - [Breaking changes](breakingChanges.md)
 - [Usage](usage.md)

From 25e2d78311cd8bfb83a247609162cd5315e278f4 Mon Sep 17 00:00:00 2001
From: Knut Sveidqvist <knut.sveidqvist@ipiccolo.com>
Date: Wed, 4 Mar 2020 20:35:59 +0100
Subject: [PATCH 05/34] #1295 Start renderer

---
 .gitignore                                    |   3 +-
 cypress/platform/current.html                 |   7 +-
 src/diagrams/flowchart-v2/flowChartShapes.js  | 261 +++++++
 .../flowchart-v2/flowChartShapes.spec.js      | 131 ++++
 src/diagrams/flowchart-v2/flowDb.js           | 644 ++++++++++++++++++
 src/diagrams/flowchart-v2/flowRenderer.js     | 488 +++++++++++++
 src/diagrams/flowchart/parser/flow.jison      |   3 +-
 src/experimental.js                           |  42 ++
 src/mermaid.js                                |   1 -
 src/mermaidAPI.js                             |  11 +
 src/utils.js                                  |   3 +
 11 files changed, 1586 insertions(+), 8 deletions(-)
 create mode 100644 src/diagrams/flowchart-v2/flowChartShapes.js
 create mode 100644 src/diagrams/flowchart-v2/flowChartShapes.spec.js
 create mode 100644 src/diagrams/flowchart-v2/flowDb.js
 create mode 100644 src/diagrams/flowchart-v2/flowRenderer.js
 create mode 100644 src/experimental.js

diff --git a/.gitignore b/.gitignore
index 69f442484..58579d79b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -18,4 +18,5 @@ dist/classTest.html
 dist/sequenceTest.html
 
 .vscode/
-cypress/platform/current.html
\ No newline at end of file
+cypress/platform/current.html
+cypress/platform/experimental.html
\ No newline at end of file
diff --git a/cypress/platform/current.html b/cypress/platform/current.html
index 3ed964921..2f5ec32b4 100644
--- a/cypress/platform/current.html
+++ b/cypress/platform/current.html
@@ -20,11 +20,8 @@
     <h1>info below</h1>
     <div style="display: flex;width: 100%; height: 100%">
       <div class="mermaid" style="width: 100%; height: 100%">
-        stateDiagram
-          O --> A : ong line using<br/>should work<br/>should work<br/>should work
-          A --> B : ong line using<br/>should work
-          B --> C : Sing line
-
+        flowchart LR
+          A --> B
       </div>
 </div>
   <script src="./mermaid.js"></script>
diff --git a/src/diagrams/flowchart-v2/flowChartShapes.js b/src/diagrams/flowchart-v2/flowChartShapes.js
new file mode 100644
index 000000000..23cb53049
--- /dev/null
+++ b/src/diagrams/flowchart-v2/flowChartShapes.js
@@ -0,0 +1,261 @@
+import dagreD3 from 'dagre-d3';
+
+function question(parent, bbox, node) {
+  const w = bbox.width;
+  const h = bbox.height;
+  const s = (w + h) * 0.9;
+  const points = [
+    { x: s / 2, y: 0 },
+    { x: s, y: -s / 2 },
+    { x: s / 2, y: -s },
+    { x: 0, y: -s / 2 }
+  ];
+  const shapeSvg = insertPolygonShape(parent, s, s, points);
+  node.intersect = function(point) {
+    return dagreD3.intersect.polygon(node, points, point);
+  };
+  return shapeSvg;
+}
+
+function hexagon(parent, bbox, node) {
+  const f = 4;
+  const h = bbox.height;
+  const m = h / f;
+  const w = bbox.width + 2 * m;
+  const points = [
+    { x: m, y: 0 },
+    { x: w - m, y: 0 },
+    { x: w, y: -h / 2 },
+    { x: w - m, y: -h },
+    { x: m, y: -h },
+    { x: 0, y: -h / 2 }
+  ];
+  const shapeSvg = insertPolygonShape(parent, w, h, points);
+  node.intersect = function(point) {
+    return dagreD3.intersect.polygon(node, points, point);
+  };
+  return shapeSvg;
+}
+
+function rect_left_inv_arrow(parent, bbox, node) {
+  const w = bbox.width;
+  const h = bbox.height;
+  const points = [
+    { x: -h / 2, y: 0 },
+    { x: w, y: 0 },
+    { x: w, y: -h },
+    { x: -h / 2, y: -h },
+    { x: 0, y: -h / 2 }
+  ];
+  const shapeSvg = insertPolygonShape(parent, w, h, points);
+  node.intersect = function(point) {
+    return dagreD3.intersect.polygon(node, points, point);
+  };
+  return shapeSvg;
+}
+
+function lean_right(parent, bbox, node) {
+  const w = bbox.width;
+  const h = bbox.height;
+  const points = [
+    { x: (-2 * h) / 6, y: 0 },
+    { x: w - h / 6, y: 0 },
+    { x: w + (2 * h) / 6, y: -h },
+    { x: h / 6, y: -h }
+  ];
+  const shapeSvg = insertPolygonShape(parent, w, h, points);
+  node.intersect = function(point) {
+    return dagreD3.intersect.polygon(node, points, point);
+  };
+  return shapeSvg;
+}
+
+function lean_left(parent, bbox, node) {
+  const w = bbox.width;
+  const h = bbox.height;
+  const points = [
+    { x: (2 * h) / 6, y: 0 },
+    { x: w + h / 6, y: 0 },
+    { x: w - (2 * h) / 6, y: -h },
+    { x: -h / 6, y: -h }
+  ];
+  const shapeSvg = insertPolygonShape(parent, w, h, points);
+  node.intersect = function(point) {
+    return dagreD3.intersect.polygon(node, points, point);
+  };
+  return shapeSvg;
+}
+
+function trapezoid(parent, bbox, node) {
+  const w = bbox.width;
+  const h = bbox.height;
+  const points = [
+    { x: (-2 * h) / 6, y: 0 },
+    { x: w + (2 * h) / 6, y: 0 },
+    { x: w - h / 6, y: -h },
+    { x: h / 6, y: -h }
+  ];
+  const shapeSvg = insertPolygonShape(parent, w, h, points);
+  node.intersect = function(point) {
+    return dagreD3.intersect.polygon(node, points, point);
+  };
+  return shapeSvg;
+}
+
+function inv_trapezoid(parent, bbox, node) {
+  const w = bbox.width;
+  const h = bbox.height;
+  const points = [
+    { x: h / 6, y: 0 },
+    { x: w - h / 6, y: 0 },
+    { x: w + (2 * h) / 6, y: -h },
+    { x: (-2 * h) / 6, y: -h }
+  ];
+  const shapeSvg = insertPolygonShape(parent, w, h, points);
+  node.intersect = function(point) {
+    return dagreD3.intersect.polygon(node, points, point);
+  };
+  return shapeSvg;
+}
+
+function rect_right_inv_arrow(parent, bbox, node) {
+  const w = bbox.width;
+  const h = bbox.height;
+  const points = [
+    { x: 0, y: 0 },
+    { x: w + h / 2, y: 0 },
+    { x: w, y: -h / 2 },
+    { x: w + h / 2, y: -h },
+    { x: 0, y: -h }
+  ];
+  const shapeSvg = insertPolygonShape(parent, w, h, points);
+  node.intersect = function(point) {
+    return dagreD3.intersect.polygon(node, points, point);
+  };
+  return shapeSvg;
+}
+
+function stadium(parent, bbox, node) {
+  const h = bbox.height;
+  const w = bbox.width + h / 4;
+
+  const shapeSvg = parent
+    .insert('rect', ':first-child')
+    .attr('rx', h / 2)
+    .attr('ry', h / 2)
+    .attr('x', -w / 2)
+    .attr('y', -h / 2)
+    .attr('width', w)
+    .attr('height', h);
+
+  node.intersect = function(point) {
+    return dagreD3.intersect.rect(node, point);
+  };
+  return shapeSvg;
+}
+
+function cylinder(parent, bbox, node) {
+  const w = bbox.width;
+  const rx = w / 2;
+  const ry = rx / (2.5 + w / 50);
+  const h = bbox.height + ry;
+
+  const shape =
+    'M 0,' +
+    ry +
+    ' a ' +
+    rx +
+    ',' +
+    ry +
+    ' 0,0,0 ' +
+    w +
+    ' 0 a ' +
+    rx +
+    ',' +
+    ry +
+    ' 0,0,0 ' +
+    -w +
+    ' 0 l 0,' +
+    h +
+    ' a ' +
+    rx +
+    ',' +
+    ry +
+    ' 0,0,0 ' +
+    w +
+    ' 0 l 0,' +
+    -h;
+
+  const shapeSvg = parent
+    .attr('label-offset-y', ry)
+    .insert('path', ':first-child')
+    .attr('d', shape)
+    .attr('transform', 'translate(' + -w / 2 + ',' + -(h / 2 + ry) + ')');
+
+  node.intersect = function(point) {
+    const pos = dagreD3.intersect.rect(node, point);
+    const x = pos.x - node.x;
+
+    if (
+      rx != 0 &&
+      (Math.abs(x) < node.width / 2 ||
+        (Math.abs(x) == node.width / 2 && Math.abs(pos.y - node.y) > node.height / 2 - ry))
+    ) {
+      // ellipsis equation: x*x / a*a + y*y / b*b = 1
+      // solve for y to get adjustion value for pos.y
+      let y = ry * ry * (1 - (x * x) / (rx * rx));
+      if (y != 0) y = Math.sqrt(y);
+      y = ry - y;
+      if (point.y - node.y > 0) y = -y;
+
+      pos.y += y;
+    }
+
+    return pos;
+  };
+
+  return shapeSvg;
+}
+
+export function addToRender(render) {
+  render.shapes().question = question;
+  render.shapes().hexagon = hexagon;
+  render.shapes().stadium = stadium;
+  render.shapes().cylinder = cylinder;
+
+  // Add custom shape for box with inverted arrow on left side
+  render.shapes().rect_left_inv_arrow = rect_left_inv_arrow;
+
+  // Add custom shape for box with inverted arrow on left side
+  render.shapes().lean_right = lean_right;
+
+  // Add custom shape for box with inverted arrow on left side
+  render.shapes().lean_left = lean_left;
+
+  // Add custom shape for box with inverted arrow on left side
+  render.shapes().trapezoid = trapezoid;
+
+  // Add custom shape for box with inverted arrow on left side
+  render.shapes().inv_trapezoid = inv_trapezoid;
+
+  // Add custom shape for box with inverted arrow on right side
+  render.shapes().rect_right_inv_arrow = rect_right_inv_arrow;
+}
+
+function insertPolygonShape(parent, w, h, points) {
+  return parent
+    .insert('polygon', ':first-child')
+    .attr(
+      'points',
+      points
+        .map(function(d) {
+          return d.x + ',' + d.y;
+        })
+        .join(' ')
+    )
+    .attr('transform', 'translate(' + -w / 2 + ',' + h / 2 + ')');
+}
+
+export default {
+  addToRender
+};
diff --git a/src/diagrams/flowchart-v2/flowChartShapes.spec.js b/src/diagrams/flowchart-v2/flowChartShapes.spec.js
new file mode 100644
index 000000000..61e876d4b
--- /dev/null
+++ b/src/diagrams/flowchart-v2/flowChartShapes.spec.js
@@ -0,0 +1,131 @@
+import { addToRender } from './flowChartShapes';
+
+describe('flowchart shapes', function() {
+  // rect-based shapes
+  [
+    ['stadium', useWidth, useHeight]
+  ].forEach(function([shapeType, getW, getH]) {
+    it(`should add a ${shapeType} shape that renders a properly positioned rect element`, function() {
+      const mockRender = MockRender();
+      const mockSvg = MockSvg();
+      addToRender(mockRender);
+
+      [[100, 100], [123, 45], [71, 300]].forEach(function([width, height]) {
+        const shape = mockRender.shapes()[shapeType](mockSvg, { width, height }, {});
+        const w = width + height / 4;
+        const h = height;
+        const dx = -getW(w, h) / 2;
+        const dy = -getH(w, h) / 2;
+        expect(shape.__tag).toEqual('rect');
+        expect(shape.__attrs).toHaveProperty('x', dx);
+        expect(shape.__attrs).toHaveProperty('y', dy);
+      });
+    });
+  });
+
+  // path-based shapes
+  [
+    ['cylinder', useWidth, useHeight]
+  ].forEach(function([shapeType, getW, getH]) {
+    it(`should add a ${shapeType} shape that renders a properly positioned path element`, function() {
+      const mockRender = MockRender();
+      const mockSvg = MockSvg();
+      addToRender(mockRender);
+
+      [[100, 100], [123, 45], [71, 300]].forEach(function([width, height]) {
+        const shape = mockRender.shapes()[shapeType](mockSvg, { width, height }, {});
+        expect(shape.__tag).toEqual('path');
+        expect(shape.__attrs).toHaveProperty('d');
+      });
+    });
+  });
+
+  // polygon-based shapes
+  [
+    [
+      'question',
+      4,
+      function(w, h) {
+        return (w + h) * 0.9;
+      },
+      function(w, h) {
+        return (w + h) * 0.9;
+      }
+    ],
+    [
+      'hexagon',
+      6,
+      function(w, h) {
+        return w + h / 2;
+      },
+      useHeight
+    ],
+    ['rect_left_inv_arrow', 5, useWidth, useHeight],
+    ['rect_right_inv_arrow', 5, useWidth, useHeight],
+    ['lean_right', 4, useWidth, useHeight],
+    ['lean_left', 4, useWidth, useHeight],
+    ['trapezoid', 4, useWidth, useHeight],
+    ['inv_trapezoid', 4, useWidth, useHeight]
+  ].forEach(function([shapeType, expectedPointCount, getW, getH]) {
+    it(`should add a ${shapeType} shape that renders a properly translated polygon element`, function() {
+      const mockRender = MockRender();
+      const mockSvg = MockSvg();
+      addToRender(mockRender);
+
+      [[100, 100], [123, 45], [71, 300]].forEach(function([width, height]) {
+        const shape = mockRender.shapes()[shapeType](mockSvg, { width, height }, {});
+        const dx = -getW(width, height) / 2;
+        const dy = getH(width, height) / 2;
+        const points = shape.__attrs.points.split(' ');
+        expect(shape.__tag).toEqual('polygon');
+        expect(shape.__attrs).toHaveProperty('transform', `translate(${dx},${dy})`);
+        expect(points).toHaveLength(expectedPointCount);
+      });
+    });
+  });
+});
+
+function MockRender() {
+  const shapes = {};
+  return {
+    shapes() {
+      return shapes;
+    }
+  };
+}
+
+function MockSvg(tag, ...args) {
+  const children = [];
+  const attributes = {};
+  return {
+    get __args() {
+      return args;
+    },
+    get __tag() {
+      return tag;
+    },
+    get __children() {
+      return children;
+    },
+    get __attrs() {
+      return attributes;
+    },
+    insert: function(tag, ...args) {
+      const child = MockSvg(tag, ...args);
+      children.push(child);
+      return child;
+    },
+    attr(name, value) {
+      this.__attrs[name] = value;
+      return this;
+    }
+  };
+}
+
+function useWidth(w, h) {
+  return w;
+}
+
+function useHeight(w, h) {
+  return h;
+}
diff --git a/src/diagrams/flowchart-v2/flowDb.js b/src/diagrams/flowchart-v2/flowDb.js
new file mode 100644
index 000000000..4917a54a7
--- /dev/null
+++ b/src/diagrams/flowchart-v2/flowDb.js
@@ -0,0 +1,644 @@
+import * as d3 from 'd3';
+import { logger } from '../../logger';
+import utils from '../../utils';
+import { getConfig } from '../../config';
+import common from '../common/common';
+
+// const MERMAID_DOM_ID_PREFIX = 'mermaid-dom-id-';
+const MERMAID_DOM_ID_PREFIX = '';
+
+const config = getConfig();
+let vertices = {};
+let edges = [];
+let classes = [];
+let subGraphs = [];
+let subGraphLookup = {};
+let tooltips = {};
+let subCount = 0;
+let firstGraphFlag = true;
+let direction;
+// Functions to be run after graph rendering
+let funs = [];
+
+/**
+ * Function called by parser when a node definition has been found
+ * @param id
+ * @param text
+ * @param type
+ * @param style
+ * @param classes
+ */
+export const addVertex = function(_id, text, type, style, classes) {
+  let txt;
+  let id = _id;
+  if (typeof id === 'undefined') {
+    return;
+  }
+  if (id.trim().length === 0) {
+    return;
+  }
+
+  if (id[0].match(/\d/)) id = MERMAID_DOM_ID_PREFIX + id;
+
+  if (typeof vertices[id] === 'undefined') {
+    vertices[id] = { id: id, styles: [], classes: [] };
+  }
+  if (typeof text !== 'undefined') {
+    txt = common.sanitizeText(text.trim(), config);
+
+    // strip quotes if string starts and ends with a quote
+    if (txt[0] === '"' && txt[txt.length - 1] === '"') {
+      txt = txt.substring(1, txt.length - 1);
+    }
+
+    vertices[id].text = txt;
+  } else {
+    if (typeof vertices[id].text === 'undefined') {
+      vertices[id].text = _id;
+    }
+  }
+  if (typeof type !== 'undefined') {
+    vertices[id].type = type;
+  }
+  if (typeof style !== 'undefined') {
+    if (style !== null) {
+      style.forEach(function(s) {
+        vertices[id].styles.push(s);
+      });
+    }
+  }
+  if (typeof classes !== 'undefined') {
+    if (classes !== null) {
+      classes.forEach(function(s) {
+        vertices[id].classes.push(s);
+      });
+    }
+  }
+};
+
+/**
+ * Function called by parser when a link/edge definition has been found
+ * @param start
+ * @param end
+ * @param type
+ * @param linktext
+ */
+export const addSingleLink = function(_start, _end, type, linktext) {
+  let start = _start;
+  let end = _end;
+  if (start[0].match(/\d/)) start = MERMAID_DOM_ID_PREFIX + start;
+  if (end[0].match(/\d/)) end = MERMAID_DOM_ID_PREFIX + end;
+  logger.info('Got edge...', start, end);
+
+  const edge = { start: start, end: end, type: undefined, text: '' };
+  linktext = type.text;
+
+  if (typeof linktext !== 'undefined') {
+    edge.text = common.sanitizeText(linktext.trim(), config);
+
+    // strip quotes if string starts and exnds with a quote
+    if (edge.text[0] === '"' && edge.text[edge.text.length - 1] === '"') {
+      edge.text = edge.text.substring(1, edge.text.length - 1);
+    }
+  }
+
+  if (typeof type !== 'undefined') {
+    edge.type = type.type;
+    edge.stroke = type.stroke;
+  }
+  edges.push(edge);
+};
+export const addLink = function(_start, _end, type, linktext) {
+  let i, j;
+  for (i = 0; i < _start.length; i++) {
+    for (j = 0; j < _end.length; j++) {
+      addSingleLink(_start[i], _end[j], type, linktext);
+    }
+  }
+};
+
+/**
+ * Updates a link's line interpolation algorithm
+ * @param pos
+ * @param interpolate
+ */
+export const updateLinkInterpolate = function(positions, interp) {
+  positions.forEach(function(pos) {
+    if (pos === 'default') {
+      edges.defaultInterpolate = interp;
+    } else {
+      edges[pos].interpolate = interp;
+    }
+  });
+};
+
+/**
+ * Updates a link with a style
+ * @param pos
+ * @param style
+ */
+export const updateLink = function(positions, style) {
+  positions.forEach(function(pos) {
+    if (pos === 'default') {
+      edges.defaultStyle = style;
+    } else {
+      if (utils.isSubstringInArray('fill', style) === -1) {
+        style.push('fill:none');
+      }
+      edges[pos].style = style;
+    }
+  });
+};
+
+export const addClass = function(id, style) {
+  if (typeof classes[id] === 'undefined') {
+    classes[id] = { id: id, styles: [], textStyles: [] };
+  }
+
+  if (typeof style !== 'undefined') {
+    if (style !== null) {
+      style.forEach(function(s) {
+        if (s.match('color')) {
+          const newStyle1 = s.replace('fill', 'bgFill');
+          const newStyle2 = newStyle1.replace('color', 'fill');
+          classes[id].textStyles.push(newStyle2);
+        }
+        classes[id].styles.push(s);
+      });
+    }
+  }
+};
+
+/**
+ * Called by parser when a graph definition is found, stores the direction of the chart.
+ * @param dir
+ */
+export const setDirection = function(dir) {
+  direction = dir;
+  if (direction.match(/.*</)) {
+    direction = 'RL';
+  }
+  if (direction.match(/.*\^/)) {
+    direction = 'BT';
+  }
+  if (direction.match(/.*>/)) {
+    direction = 'LR';
+  }
+  if (direction.match(/.*v/)) {
+    direction = 'TB';
+  }
+};
+
+/**
+ * Called by parser when a special node is found, e.g. a clickable element.
+ * @param ids Comma separated list of ids
+ * @param className Class to add
+ */
+export const setClass = function(ids, className) {
+  ids.split(',').forEach(function(_id) {
+    let id = _id;
+    if (_id[0].match(/\d/)) id = MERMAID_DOM_ID_PREFIX + id;
+    if (typeof vertices[id] !== 'undefined') {
+      vertices[id].classes.push(className);
+    }
+
+    if (typeof subGraphLookup[id] !== 'undefined') {
+      subGraphLookup[id].classes.push(className);
+    }
+  });
+};
+
+const setTooltip = function(ids, tooltip) {
+  ids.split(',').forEach(function(id) {
+    if (typeof tooltip !== 'undefined') {
+      tooltips[id] = common.sanitizeText(tooltip, config);
+    }
+  });
+};
+
+const setClickFun = function(_id, functionName) {
+  let id = _id;
+  if (_id[0].match(/\d/)) id = MERMAID_DOM_ID_PREFIX + id;
+  if (config.securityLevel !== 'loose') {
+    return;
+  }
+  if (typeof functionName === 'undefined') {
+    return;
+  }
+  if (typeof vertices[id] !== 'undefined') {
+    funs.push(function() {
+      const elem = document.querySelector(`[id="${id}"]`);
+      if (elem !== null) {
+        elem.addEventListener(
+          'click',
+          function() {
+            window[functionName](id);
+          },
+          false
+        );
+      }
+    });
+  }
+};
+
+/**
+ * Called by parser when a link is found. Adds the URL to the vertex data.
+ * @param ids Comma separated list of ids
+ * @param linkStr URL to create a link for
+ * @param tooltip Tooltip for the clickable element
+ */
+export const setLink = function(ids, linkStr, tooltip) {
+  ids.split(',').forEach(function(_id) {
+    let id = _id;
+    if (_id[0].match(/\d/)) id = MERMAID_DOM_ID_PREFIX + id;
+    if (typeof vertices[id] !== 'undefined') {
+      vertices[id].link = utils.formatUrl(linkStr, config);
+    }
+  });
+  setTooltip(ids, tooltip);
+  setClass(ids, 'clickable');
+};
+export const getTooltip = function(id) {
+  return tooltips[id];
+};
+
+/**
+ * Called by parser when a click definition is found. Registers an event handler.
+ * @param ids Comma separated list of ids
+ * @param functionName Function to be called on click
+ * @param tooltip Tooltip for the clickable element
+ */
+export const setClickEvent = function(ids, functionName, tooltip) {
+  ids.split(',').forEach(function(id) {
+    setClickFun(id, functionName);
+  });
+  setTooltip(ids, tooltip);
+  setClass(ids, 'clickable');
+};
+
+export const bindFunctions = function(element) {
+  funs.forEach(function(fun) {
+    fun(element);
+  });
+};
+export const getDirection = function() {
+  return direction.trim();
+};
+/**
+ * Retrieval function for fetching the found nodes after parsing has completed.
+ * @returns {{}|*|vertices}
+ */
+export const getVertices = function() {
+  return vertices;
+};
+
+/**
+ * Retrieval function for fetching the found links after parsing has completed.
+ * @returns {{}|*|edges}
+ */
+export const getEdges = function() {
+  return edges;
+};
+
+/**
+ * Retrieval function for fetching the found class definitions after parsing has completed.
+ * @returns {{}|*|classes}
+ */
+export const getClasses = function() {
+  return classes;
+};
+
+const setupToolTips = function(element) {
+  let tooltipElem = d3.select('.mermaidTooltip');
+  if ((tooltipElem._groups || tooltipElem)[0][0] === null) {
+    tooltipElem = d3
+      .select('body')
+      .append('div')
+      .attr('class', 'mermaidTooltip')
+      .style('opacity', 0);
+  }
+
+  const svg = d3.select(element).select('svg');
+
+  const nodes = svg.selectAll('g.node');
+  nodes
+    .on('mouseover', function() {
+      const el = d3.select(this);
+      const title = el.attr('title');
+      // Dont try to draw a tooltip if no data is provided
+      if (title === null) {
+        return;
+      }
+      const rect = this.getBoundingClientRect();
+
+      tooltipElem
+        .transition()
+        .duration(200)
+        .style('opacity', '.9');
+      tooltipElem
+        .html(el.attr('title'))
+        .style('left', rect.left + (rect.right - rect.left) / 2 + 'px')
+        .style('top', rect.top - 14 + document.body.scrollTop + 'px');
+      el.classed('hover', true);
+    })
+    .on('mouseout', function() {
+      tooltipElem
+        .transition()
+        .duration(500)
+        .style('opacity', 0);
+      const el = d3.select(this);
+      el.classed('hover', false);
+    });
+};
+funs.push(setupToolTips);
+
+/**
+ * Clears the internal graph db so that a new graph can be parsed.
+ */
+export const clear = function() {
+  vertices = {};
+  classes = {};
+  edges = [];
+  funs = [];
+  funs.push(setupToolTips);
+  subGraphs = [];
+  subGraphLookup = {};
+  subCount = 0;
+  tooltips = [];
+  firstGraphFlag = true;
+};
+/**
+ *
+ * @returns {string}
+ */
+export const defaultStyle = function() {
+  return 'fill:#ffa;stroke: #f66; stroke-width: 3px; stroke-dasharray: 5, 5;fill:#ffa;stroke: #666;';
+};
+
+/**
+ * Clears the internal graph db so that a new graph can be parsed.
+ */
+export const addSubGraph = function(_id, list, _title) {
+  let id = _id.trim();
+  let title = _title;
+  if (_id === _title && _title.match(/\s/)) {
+    id = undefined;
+  }
+  function uniq(a) {
+    const prims = { boolean: {}, number: {}, string: {} };
+    const objs = [];
+
+    return a.filter(function(item) {
+      const type = typeof item;
+      if (item.trim() === '') {
+        return false;
+      }
+      if (type in prims) {
+        return prims[type].hasOwnProperty(item) ? false : (prims[type][item] = true); // eslint-disable-line
+      } else {
+        return objs.indexOf(item) >= 0 ? false : objs.push(item);
+      }
+    });
+  }
+
+  let nodeList = [];
+
+  nodeList = uniq(nodeList.concat.apply(nodeList, list));
+  for (let i = 0; i < nodeList.length; i++) {
+    if (nodeList[i][0].match(/\d/)) nodeList[i] = MERMAID_DOM_ID_PREFIX + nodeList[i];
+  }
+
+  id = id || 'subGraph' + subCount;
+  if (id[0].match(/\d/)) id = MERMAID_DOM_ID_PREFIX + id;
+  title = title || '';
+  title = common.sanitizeText(title, config);
+  subCount = subCount + 1;
+  const subGraph = { id: id, nodes: nodeList, title: title.trim(), classes: [] };
+  subGraphs.push(subGraph);
+  subGraphLookup[id] = subGraph;
+  return id;
+};
+
+const getPosForId = function(id) {
+  for (let i = 0; i < subGraphs.length; i++) {
+    if (subGraphs[i].id === id) {
+      return i;
+    }
+  }
+  return -1;
+};
+let secCount = -1;
+const posCrossRef = [];
+const indexNodes2 = function(id, pos) {
+  const nodes = subGraphs[pos].nodes;
+  secCount = secCount + 1;
+  if (secCount > 2000) {
+    return;
+  }
+  posCrossRef[secCount] = pos;
+  // Check if match
+  if (subGraphs[pos].id === id) {
+    return {
+      result: true,
+      count: 0
+    };
+  }
+
+  let count = 0;
+  let posCount = 1;
+  while (count < nodes.length) {
+    const childPos = getPosForId(nodes[count]);
+    // Ignore regular nodes (pos will be -1)
+    if (childPos >= 0) {
+      const res = indexNodes2(id, childPos);
+      if (res.result) {
+        return {
+          result: true,
+          count: posCount + res.count
+        };
+      } else {
+        posCount = posCount + res.count;
+      }
+    }
+    count = count + 1;
+  }
+
+  return {
+    result: false,
+    count: posCount
+  };
+};
+
+export const getDepthFirstPos = function(pos) {
+  return posCrossRef[pos];
+};
+export const indexNodes = function() {
+  secCount = -1;
+  if (subGraphs.length > 0) {
+    indexNodes2('none', subGraphs.length - 1, 0);
+  }
+};
+
+export const getSubGraphs = function() {
+  return subGraphs;
+};
+
+export const firstGraph = () => {
+  if (firstGraphFlag) {
+    firstGraphFlag = false;
+    return true;
+  }
+  return false;
+};
+
+const destructStartLink = _str => {
+  const str = _str.trim();
+
+  switch (str) {
+    case '<--':
+      return { type: 'arrow', stroke: 'normal' };
+    case 'x--':
+      return { type: 'arrow_cross', stroke: 'normal' };
+    case 'o--':
+      return { type: 'arrow_circle', stroke: 'normal' };
+    case '<-.':
+      return { type: 'arrow', stroke: 'dotted' };
+    case 'x-.':
+      return { type: 'arrow_cross', stroke: 'dotted' };
+    case 'o-.':
+      return { type: 'arrow_circle', stroke: 'dotted' };
+    case '<==':
+      return { type: 'arrow', stroke: 'thick' };
+    case 'x==':
+      return { type: 'arrow_cross', stroke: 'thick' };
+    case 'o==':
+      return { type: 'arrow_circle', stroke: 'thick' };
+    case '--':
+      return { type: 'arrow_open', stroke: 'normal' };
+    case '==':
+      return { type: 'arrow_open', stroke: 'thick' };
+    case '-.':
+      return { type: 'arrow_open', stroke: 'dotted' };
+  }
+};
+
+const destructEndLink = _str => {
+  const str = _str.trim();
+
+  switch (str) {
+    case '--x':
+      return { type: 'arrow_cross', stroke: 'normal' };
+    case '-->':
+      return { type: 'arrow', stroke: 'normal' };
+    case '<-->':
+      return { type: 'double_arrow_point', stroke: 'normal' };
+    case 'x--x':
+      return { type: 'double_arrow_cross', stroke: 'normal' };
+    case 'o--o':
+      return { type: 'double_arrow_circle', stroke: 'normal' };
+    case 'o.-o':
+      return { type: 'double_arrow_circle', stroke: 'dotted' };
+    case '<==>':
+      return { type: 'double_arrow_point', stroke: 'thick' };
+    case 'o==o':
+      return { type: 'double_arrow_circle', stroke: 'thick' };
+    case 'x==x':
+      return { type: 'double_arrow_cross', stroke: 'thick' };
+    case 'x.-x':
+      return { type: 'double_arrow_cross', stroke: 'dotted' };
+    case 'x-.-x':
+      return { type: 'double_arrow_cross', stroke: 'dotted' };
+    case '<.->':
+      return { type: 'double_arrow_point', stroke: 'dotted' };
+    case '<-.->':
+      return { type: 'double_arrow_point', stroke: 'dotted' };
+    case 'o-.-o':
+      return { type: 'double_arrow_circle', stroke: 'dotted' };
+    case '--o':
+      return { type: 'arrow_circle', stroke: 'normal' };
+    case '---':
+      return { type: 'arrow_open', stroke: 'normal' };
+    case '-.-x':
+      return { type: 'arrow_cross', stroke: 'dotted' };
+    case '-.->':
+      return { type: 'arrow', stroke: 'dotted' };
+    case '-.-o':
+      return { type: 'arrow_circle', stroke: 'dotted' };
+    case '-.-':
+      return { type: 'arrow_open', stroke: 'dotted' };
+    case '.-x':
+      return { type: 'arrow_cross', stroke: 'dotted' };
+    case '.->':
+      return { type: 'arrow', stroke: 'dotted' };
+    case '.-o':
+      return { type: 'arrow_circle', stroke: 'dotted' };
+    case '.-':
+      return { type: 'arrow_open', stroke: 'dotted' };
+    case '==x':
+      return { type: 'arrow_cross', stroke: 'thick' };
+    case '==>':
+      return { type: 'arrow', stroke: 'thick' };
+    case '==o':
+      return { type: 'arrow_circle', stroke: 'thick' };
+    case '===':
+      return { type: 'arrow_open', stroke: 'thick' };
+  }
+};
+
+const destructLink = (_str, _startStr) => {
+  const info = destructEndLink(_str);
+  let startInfo;
+  if (_startStr) {
+    startInfo = destructStartLink(_startStr);
+
+    if (startInfo.stroke !== info.stroke) {
+      return { type: 'INVALID', stroke: 'INVALID' };
+    }
+
+    if (startInfo.type === 'arrow_open') {
+      // -- xyz -->  - take arrow type form ending
+      startInfo.type = info.type;
+    } else {
+      // x-- xyz -->  - not supported
+      if (startInfo.type !== info.type) return { type: 'INVALID', stroke: 'INVALID' };
+
+      startInfo.type = 'double_' + startInfo.type;
+    }
+
+    if (startInfo.type === 'double_arrow') {
+      startInfo.type = 'double_arrow_point';
+    }
+
+    return startInfo;
+  }
+
+  return info;
+};
+
+export default {
+  addVertex,
+  addLink,
+  updateLinkInterpolate,
+  updateLink,
+  addClass,
+  setDirection,
+  setClass,
+  getTooltip,
+  setClickEvent,
+  setLink,
+  bindFunctions,
+  getDirection,
+  getVertices,
+  getEdges,
+  getClasses,
+  clear,
+  defaultStyle,
+  addSubGraph,
+  getDepthFirstPos,
+  indexNodes,
+  getSubGraphs,
+  destructLink,
+  lex: {
+    firstGraph
+  }
+};
diff --git a/src/diagrams/flowchart-v2/flowRenderer.js b/src/diagrams/flowchart-v2/flowRenderer.js
new file mode 100644
index 000000000..10250a16c
--- /dev/null
+++ b/src/diagrams/flowchart-v2/flowRenderer.js
@@ -0,0 +1,488 @@
+import graphlib from 'graphlib';
+import * as d3 from 'd3';
+import dagre from 'dagre';
+
+import flowDb from '../flowchart/flowDb';
+import flow from '../flowchart/parser/flow';
+import { getConfig } from '../../config';
+
+import dagreD3 from 'dagre-d3';
+import addHtmlLabel from 'dagre-d3/lib/label/add-html-label.js';
+import { logger } from '../../logger';
+import { interpolateToCurve, getStylesFromArray } from '../../utils';
+import flowChartShapes from '../flowchart/flowChartShapes';
+
+const conf = {};
+export const setConf = function(cnf) {
+  const keys = Object.keys(cnf);
+  for (let i = 0; i < keys.length; i++) {
+    conf[keys[i]] = cnf[keys[i]];
+  }
+};
+
+/**
+ * Function that adds the vertices found in the graph definition to the graph to be rendered.
+ * @param vert Object containing the vertices.
+ * @param g The graph that is to be drawn.
+ */
+export const addVertices = function(vert, g, svgId) {
+  const svg = d3.select(`[id="${svgId}"]`);
+  const keys = Object.keys(vert);
+
+  // Iterate through each item in the vertex object (containing all the vertices found) in the graph definition
+  keys.forEach(function(id) {
+    const vertex = vert[id];
+
+    /**
+     * Variable for storing the classes for the vertex
+     * @type {string}
+     */
+    let classStr = 'default';
+    if (vertex.classes.length > 0) {
+      classStr = vertex.classes.join(' ');
+    }
+
+    const styles = getStylesFromArray(vertex.styles);
+
+    // Use vertex id as text in the box if no text is provided by the graph definition
+    let vertexText = vertex.text !== undefined ? vertex.text : vertex.id;
+
+    // We create a SVG label, either by delegating to addHtmlLabel or manually
+    let vertexNode;
+    if (getConfig().flowchart.htmlLabels) {
+      // TODO: addHtmlLabel accepts a labelStyle. Do we possibly have that?
+      const node = {
+        label: vertexText.replace(
+          /fa[lrsb]?:fa-[\w-]+/g,
+          s => `<i class='${s.replace(':', ' ')}'></i>`
+        )
+      };
+      vertexNode = addHtmlLabel(svg, node).node();
+      vertexNode.parentNode.removeChild(vertexNode);
+    } else {
+      const svgLabel = document.createElementNS('http://www.w3.org/2000/svg', 'text');
+      svgLabel.setAttribute('style', styles.labelStyle.replace('color:', 'fill:'));
+
+      const rows = vertexText.split(/<br\s*\/?>/gi);
+
+      for (let j = 0; j < rows.length; j++) {
+        const tspan = document.createElementNS('http://www.w3.org/2000/svg', 'tspan');
+        tspan.setAttributeNS('http://www.w3.org/XML/1998/namespace', 'xml:space', 'preserve');
+        tspan.setAttribute('dy', '1em');
+        tspan.setAttribute('x', '1');
+        tspan.textContent = rows[j];
+        svgLabel.appendChild(tspan);
+      }
+      vertexNode = svgLabel;
+    }
+
+    let radious = 0;
+    let _shape = '';
+    // Set the shape based parameters
+    switch (vertex.type) {
+      case 'round':
+        radious = 5;
+        _shape = 'rect';
+        break;
+      case 'square':
+        _shape = 'rect';
+        break;
+      case 'diamond':
+        _shape = 'question';
+        break;
+      case 'hexagon':
+        _shape = 'hexagon';
+        break;
+      case 'odd':
+        _shape = 'rect_left_inv_arrow';
+        break;
+      case 'lean_right':
+        _shape = 'lean_right';
+        break;
+      case 'lean_left':
+        _shape = 'lean_left';
+        break;
+      case 'trapezoid':
+        _shape = 'trapezoid';
+        break;
+      case 'inv_trapezoid':
+        _shape = 'inv_trapezoid';
+        break;
+      case 'odd_right':
+        _shape = 'rect_left_inv_arrow';
+        break;
+      case 'circle':
+        _shape = 'circle';
+        break;
+      case 'ellipse':
+        _shape = 'ellipse';
+        break;
+      case 'stadium':
+        _shape = 'stadium';
+        break;
+      case 'cylinder':
+        _shape = 'cylinder';
+        break;
+      case 'group':
+        _shape = 'rect';
+        break;
+      default:
+        _shape = 'rect';
+    }
+    // Add the node
+    g.setNode(vertex.id, {
+      labelType: 'svg',
+      labelStyle: styles.labelStyle,
+      shape: _shape,
+      label: vertexNode,
+      rx: radious,
+      ry: radious,
+      class: classStr,
+      style: styles.style,
+      id: vertex.id
+    });
+  });
+};
+
+/**
+ * Add edges to graph based on parsed graph defninition
+ * @param {Object} edges The edges to add to the graph
+ * @param {Object} g The graph object
+ */
+export const addEdges = function(edges, g) {
+  let cnt = 0;
+
+  let defaultStyle;
+  let defaultLabelStyle;
+
+  if (typeof edges.defaultStyle !== 'undefined') {
+    const defaultStyles = getStylesFromArray(edges.defaultStyle);
+    defaultStyle = defaultStyles.style;
+    defaultLabelStyle = defaultStyles.labelStyle;
+  }
+
+  edges.forEach(function(edge) {
+    cnt++;
+    const edgeData = {};
+
+    // Set link type for rendering
+    if (edge.type === 'arrow_open') {
+      edgeData.arrowhead = 'none';
+    } else {
+      edgeData.arrowhead = 'normal';
+    }
+
+    let style = '';
+    let labelStyle = '';
+
+    if (typeof edge.style !== 'undefined') {
+      const styles = getStylesFromArray(edge.style);
+      style = styles.style;
+      labelStyle = styles.labelStyle;
+    } else {
+      switch (edge.stroke) {
+        case 'normal':
+          style = 'fill:none';
+          if (typeof defaultStyle !== 'undefined') {
+            style = defaultStyle;
+          }
+          if (typeof defaultLabelStyle !== 'undefined') {
+            labelStyle = defaultLabelStyle;
+          }
+          break;
+        case 'dotted':
+          style = 'fill:none;stroke-width:2px;stroke-dasharray:3;';
+          break;
+        case 'thick':
+          style = ' stroke-width: 3.5px;fill:none';
+          break;
+      }
+    }
+
+    edgeData.style = style;
+    edgeData.labelStyle = labelStyle;
+
+    if (typeof edge.interpolate !== 'undefined') {
+      edgeData.curve = interpolateToCurve(edge.interpolate, d3.curveLinear);
+    } else if (typeof edges.defaultInterpolate !== 'undefined') {
+      edgeData.curve = interpolateToCurve(edges.defaultInterpolate, d3.curveLinear);
+    } else {
+      edgeData.curve = interpolateToCurve(conf.curve, d3.curveLinear);
+    }
+
+    if (typeof edge.text === 'undefined') {
+      if (typeof edge.style !== 'undefined') {
+        edgeData.arrowheadStyle = 'fill: #333';
+      }
+    } else {
+      edgeData.arrowheadStyle = 'fill: #333';
+      edgeData.labelpos = 'c';
+
+      if (getConfig().flowchart.htmlLabels) {
+        edgeData.labelType = 'html';
+        edgeData.label = '<span class="edgeLabel">' + edge.text + '</span>';
+      } else {
+        edgeData.labelType = 'text';
+        edgeData.label = edge.text.replace(/<br\s*\/?>/gi, '\n');
+
+        if (typeof edge.style === 'undefined') {
+          edgeData.style = edgeData.style || 'stroke: #333; stroke-width: 1.5px;fill:none';
+        }
+
+        edgeData.labelStyle = edgeData.labelStyle.replace('color:', 'fill:');
+      }
+    }
+    // Add the edge to the graph
+    g.setEdge(edge.start, edge.end, edgeData, cnt);
+  });
+};
+
+/**
+ * Returns the all the styles from classDef statements in the graph definition.
+ * @returns {object} classDef styles
+ */
+export const getClasses = function(text) {
+  logger.info('Extracting classes');
+  flowDb.clear();
+  const parser = flow.parser;
+  parser.yy = flowDb;
+
+  // Parse the graph definition
+  parser.parse(text);
+  return flowDb.getClasses();
+};
+
+/**
+ * Draws a flowchart in the tag with id: id based on the graph definition in text.
+ * @param text
+ * @param id
+ */
+export const draw = function(text, id) {
+  logger.info('Drawing flowchart');
+  flowDb.clear();
+  const parser = flow.parser;
+  parser.yy = flowDb;
+
+  // Parse the graph definition
+  try {
+    parser.parse(text);
+  } catch (err) {
+    logger.debug('Parsing failed');
+  }
+
+  // Fetch the default direction, use TD if none was found
+  let dir = flowDb.getDirection();
+  if (typeof dir === 'undefined') {
+    dir = 'TD';
+  }
+
+  const conf = getConfig().flowchart;
+  const nodeSpacing = conf.nodeSpacing || 50;
+  const rankSpacing = conf.rankSpacing || 50;
+
+  // Create the input mermaid.graph
+  const g = new graphlib.Graph({
+    multigraph: true,
+    compound: true
+  })
+    .setGraph({
+      rankdir: dir,
+      nodesep: nodeSpacing,
+      ranksep: rankSpacing,
+      marginx: 8,
+      marginy: 8
+    })
+    .setDefaultEdgeLabel(function() {
+      return {};
+    });
+
+  let subG;
+  const subGraphs = flowDb.getSubGraphs();
+  for (let i = subGraphs.length - 1; i >= 0; i--) {
+    subG = subGraphs[i];
+    flowDb.addVertex(subG.id, subG.title, 'group', undefined, subG.classes);
+  }
+
+  // Fetch the verices/nodes and edges/links from the parsed graph definition
+  const vert = flowDb.getVertices();
+
+  const edges = flowDb.getEdges();
+
+  let i = 0;
+  for (i = subGraphs.length - 1; i >= 0; i--) {
+    subG = subGraphs[i];
+
+    d3.selectAll('cluster').append('text');
+
+    for (let j = 0; j < subG.nodes.length; j++) {
+      g.setParent(subG.nodes[j], subG.id);
+    }
+  }
+  addVertices(vert, g, id);
+  addEdges(edges, g);
+
+  // Create the renderer
+  const Render = dagreD3.render;
+  const render = new Render();
+
+  // Add custom shapes
+  flowChartShapes.addToRender(render);
+
+  // Add our custom arrow - an empty arrowhead
+  render.arrows().none = function normal(parent, id, edge, type) {
+    const marker = parent
+      .append('marker')
+      .attr('id', id)
+      .attr('viewBox', '0 0 10 10')
+      .attr('refX', 9)
+      .attr('refY', 5)
+      .attr('markerUnits', 'strokeWidth')
+      .attr('markerWidth', 8)
+      .attr('markerHeight', 6)
+      .attr('orient', 'auto');
+
+    const path = marker.append('path').attr('d', 'M 0 0 L 0 0 L 0 0 z');
+    dagreD3.util.applyStyle(path, edge[type + 'Style']);
+  };
+
+  // Override normal arrowhead defined in d3. Remove style & add class to allow css styling.
+  render.arrows().normal = function normal(parent, id) {
+    const marker = parent
+      .append('marker')
+      .attr('id', id)
+      .attr('viewBox', '0 0 10 10')
+      .attr('refX', 9)
+      .attr('refY', 5)
+      .attr('markerUnits', 'strokeWidth')
+      .attr('markerWidth', 8)
+      .attr('markerHeight', 6)
+      .attr('orient', 'auto');
+
+    marker
+      .append('path')
+      .attr('d', 'M 0 0 L 10 5 L 0 10 z')
+      .attr('class', 'arrowheadPath')
+      .style('stroke-width', 1)
+      .style('stroke-dasharray', '1,0');
+  };
+
+  // Set up an SVG group so that we can translate the final graph.
+  const svg = d3.select(`[id="${id}"]`);
+
+  // Run the renderer. This is what draws the final graph.
+  const element = d3.select('#' + id + ' g');
+  render(element, g);
+
+  element.selectAll('g.node').attr('title', function() {
+    return flowDb.getTooltip(this.id);
+  });
+
+  const padding = 8;
+  const svgBounds = svg.node().getBBox();
+  const width = svgBounds.width + padding * 2;
+  const height = svgBounds.height + padding * 2;
+  logger.debug(
+    `new ViewBox 0 0 ${width} ${height}`,
+    `translate(${padding - g._label.marginx}, ${padding - g._label.marginy})`
+  );
+
+  if (conf.useMaxWidth) {
+    svg.attr('width', '100%');
+    svg.attr('style', `max-width: ${width}px;`);
+  } else {
+    svg.attr('height', height);
+    svg.attr('width', width);
+  }
+
+  svg.attr('viewBox', `0 0 ${width} ${height}`);
+  svg
+    .select('g')
+    .attr('transform', `translate(${padding - g._label.marginx}, ${padding - svgBounds.y})`);
+
+  // Index nodes
+  flowDb.indexNodes('subGraph' + i);
+
+  // reposition labels
+  for (i = 0; i < subGraphs.length; i++) {
+    subG = subGraphs[i];
+
+    if (subG.title !== 'undefined') {
+      const clusterRects = document.querySelectorAll('#' + id + ' [id="' + subG.id + '"] rect');
+      const clusterEl = document.querySelectorAll('#' + id + ' [id="' + subG.id + '"]');
+
+      const xPos = clusterRects[0].x.baseVal.value;
+      const yPos = clusterRects[0].y.baseVal.value;
+      const width = clusterRects[0].width.baseVal.value;
+      const cluster = d3.select(clusterEl[0]);
+      const te = cluster.select('.label');
+      te.attr('transform', `translate(${xPos + width / 2}, ${yPos + 14})`);
+      te.attr('id', id + 'Text');
+
+      for (let j = 0; j < subG.classes.length; j++) {
+        clusterEl[0].classList.add(subG.classes[j]);
+      }
+    }
+  }
+
+  // Add label rects for non html labels
+  if (!conf.htmlLabels) {
+    const labels = document.querySelectorAll('[id="' + id + '"] .edgeLabel .label');
+    for (let k = 0; k < labels.length; k++) {
+      const label = labels[k];
+
+      // Get dimensions of label
+      const dim = label.getBBox();
+
+      const rect = document.createElementNS('http://www.w3.org/2000/svg', 'rect');
+      rect.setAttribute('rx', 0);
+      rect.setAttribute('ry', 0);
+      rect.setAttribute('width', dim.width);
+      rect.setAttribute('height', dim.height);
+      rect.setAttribute('style', 'fill:#e8e8e8;');
+
+      label.insertBefore(rect, label.firstChild);
+    }
+  }
+
+  // If node has a link, wrap it in an anchor SVG object.
+  const keys = Object.keys(vert);
+  keys.forEach(function(key) {
+    const vertex = vert[key];
+
+    if (vertex.link) {
+      const node = d3.select('#' + id + ' [id="' + key + '"]');
+      if (node) {
+        const link = document.createElementNS('http://www.w3.org/2000/svg', 'a');
+        link.setAttributeNS('http://www.w3.org/2000/svg', 'class', vertex.classes.join(' '));
+        link.setAttributeNS('http://www.w3.org/2000/svg', 'href', vertex.link);
+        link.setAttributeNS('http://www.w3.org/2000/svg', 'rel', 'noopener');
+
+        const linkNode = node.insert(function() {
+          return link;
+        }, ':first-child');
+
+        const shape = node.select('.label-container');
+        if (shape) {
+          linkNode.append(function() {
+            return shape.node();
+          });
+        }
+
+        const label = node.select('.label');
+        if (label) {
+          linkNode.append(function() {
+            return label.node();
+          });
+        }
+      }
+    }
+  });
+};
+
+export default {
+  setConf,
+  addVertices,
+  addEdges,
+  getClasses,
+  draw
+};
diff --git a/src/diagrams/flowchart/parser/flow.jison b/src/diagrams/flowchart/parser/flow.jison
index f867e5713..58e4664a6 100644
--- a/src/diagrams/flowchart/parser/flow.jison
+++ b/src/diagrams/flowchart/parser/flow.jison
@@ -21,7 +21,8 @@
 "classDef"            return 'CLASSDEF';
 "class"               return 'CLASS';
 "click"               return 'CLICK';
-"graph"      {if(yy.lex.firstGraph()){this.begin("dir");}  return 'GRAPH';}
+"graph"                {if(yy.lex.firstGraph()){this.begin("dir");}  return 'GRAPH';}
+"flowchart"            {if(yy.lex.firstGraph()){this.begin("dir");}  return 'GRAPH';}
 "subgraph"            return 'subgraph';
 "end"\b\s*            return 'end';
 <dir>\s*"LR"             {   this.popState();  return 'DIR'; }
diff --git a/src/experimental.js b/src/experimental.js
new file mode 100644
index 000000000..d34de469d
--- /dev/null
+++ b/src/experimental.js
@@ -0,0 +1,42 @@
+import dagre from 'dagre';
+import graphlib from 'graphlib';
+
+// Create a new directed graph
+var g = new dagre.graphlib.Graph({ compound: true });
+
+// Set an object for the graph label
+g.setGraph({});
+
+// Default to assigning a new object as a label for each new edge.
+g.setDefaultEdgeLabel(function() {
+  return {};
+});
+
+// Add nodes to the graph. The first argument is the node id. The second is
+// metadata about the node. In this case we're going to add labels to each of
+// our nodes.
+g.setNode('root', { label: 'Cluster' });
+g.setNode('kspacey', { label: 'Kevin Spacey', width: 144, height: 100, x: 200 });
+// g.setParent('kspacey', 'root');
+g.setNode('swilliams', { label: 'Saul Williams', width: 160, height: 100 });
+// g.setNode('bpitt', { label: 'Brad Pitt', width: 108, height: 100 });
+// g.setNode('hford', { label: 'Harrison Ford', width: 168, height: 100 });
+// g.setNode('lwilson', { label: 'Luke Wilson', width: 144, height: 100 });
+// g.setNode('kbacon', { label: 'Kevin Bacon', width: 121, height: 100 });
+
+// Add edges to the graph.
+g.setEdge('kspacey', 'swilliams');
+g.setEdge('swilliams');
+// g.setEdge('swilliams', 'kbacon');
+// g.setEdge('bpitt', 'kbacon');
+// g.setEdge('hford', 'lwilson');
+// g.setEdge('lwilson', 'kbacon');
+
+dagre.layout(g);
+
+g.nodes().forEach(function(v) {
+  console.log('Node ' + v + ': ' + JSON.stringify(g.node(v)));
+});
+g.edges().forEach(function(e) {
+  console.log('Edge ' + e.v + ' -> ' + e.w + ': ' + JSON.stringify(g.edge(e)));
+});
diff --git a/src/mermaid.js b/src/mermaid.js
index 0cf24e81f..6f2311390 100644
--- a/src/mermaid.js
+++ b/src/mermaid.js
@@ -6,7 +6,6 @@ import he from 'he';
 
 import mermaidAPI from './mermaidAPI';
 import { logger } from './logger';
-
 /**
  * ## init
  * Function that goes through the document to find the chart definitions in there and render them.
diff --git a/src/mermaidAPI.js b/src/mermaidAPI.js
index 205254540..600938027 100644
--- a/src/mermaidAPI.js
+++ b/src/mermaidAPI.js
@@ -17,6 +17,7 @@ import { setConfig, getConfig } from './config';
 import { logger, setLogLevel } from './logger';
 import utils from './utils';
 import flowRenderer from './diagrams/flowchart/flowRenderer';
+import flowRendererV2 from './diagrams/flowchart-v2/flowRenderer';
 import flowParser from './diagrams/flowchart/parser/flow';
 import flowDb from './diagrams/flowchart/flowDb';
 import sequenceRenderer from './diagrams/sequence/sequenceRenderer';
@@ -363,6 +364,11 @@ function parse(text) {
       parser = flowParser;
       parser.parser.yy = flowDb;
       break;
+    case 'flowchart-v2':
+      flowDb.clear();
+      parser = flowRendererV2;
+      parser.parser.yy = flowDb;
+      break;
     case 'sequence':
       parser = sequenceParser;
       parser.parser.yy = sequenceDb;
@@ -568,6 +574,11 @@ const render = function(id, _txt, cb, container) {
       flowRenderer.setConf(config.flowchart);
       flowRenderer.draw(txt, id, false);
       break;
+    case 'flowchart-v2':
+      config.flowchart.arrowMarkerAbsolute = config.arrowMarkerAbsolute;
+      flowRendererV2.setConf(config.flowchart);
+      flowRendererV2.draw(txt, id, false);
+      break;
     case 'sequence':
       config.sequence.arrowMarkerAbsolute = config.arrowMarkerAbsolute;
       if (config.sequenceDiagram) {
diff --git a/src/utils.js b/src/utils.js
index 1aec62d4f..c6e37bb9d 100644
--- a/src/utils.js
+++ b/src/utils.js
@@ -41,6 +41,9 @@ export const detectType = function(text) {
   if (text.match(/^\s*gitGraph/)) {
     return 'git';
   }
+  if (text.match(/^\s*flowchart/)) {
+    return 'flowchart-v2';
+  }
 
   if (text.match(/^\s*info/)) {
     return 'info';

From 1570ed4610bbfc9ec1c3a331f2ad1f7038d21f51 Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Thu, 5 Mar 2020 17:34:06 -0800
Subject: [PATCH 06/34] Update mermaidAPI.md

---
 docs/mermaidAPI.md | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/docs/mermaidAPI.md b/docs/mermaidAPI.md
index 7b7b68e06..bd4f3787f 100644
--- a/docs/mermaidAPI.md
+++ b/docs/mermaidAPI.md
@@ -2,14 +2,13 @@
 
 ## mermaidAPI
 
-This is the api to be used when optionally handling the integration with the web page, instead of using the default integration provided by mermaid.js.
+This API can  be used optionally handle the integration  of mermaid to a web page, instead of using the default integration methods provided by mermaid.js.
 
-The core of this api is the [**render**][1] function which, given a graph
-definition as text, renders the graph/diagram and returns an svg element for the graph.
+The core of this api is the [**render**][1] function which, renders the given text based input to a graph/diagram, that is returned as an svg element.
 
-It is is then up to the user of the API to make use of the svg, either insert it somewhere in the page or do something completely different.
+After it is rendered, it is is then up to the user of the API to make use of the svg, which can be either inserted somewhere in the page or something else altogether.
 
-In addition to the render function, a number of behavioral configuration options are available.
+In addition to the render function, a number of behavioral configuration options are also available.
 
 ## Configuration
 

From 997353ab71620ef2d0691a34b4df180afab3ba36 Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Sat, 7 Mar 2020 00:59:39 -0800
Subject: [PATCH 07/34] Update gantt.md

---
 docs/gantt.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/gantt.md b/docs/gantt.md
index 9d2124469..70f980bae 100755
--- a/docs/gantt.md
+++ b/docs/gantt.md
@@ -30,6 +30,11 @@ gantt
 
 ```
 gantt
+##     excludes (excludes specified day, i.e, "weekends", saturday, sunday, monday, or specific dates, making it useful for computing the amount of time it will take before a project is finished, not the amount of time and effort spent on a project, by individual contributors. 
+important note when using exclude function, the graphic will accomodate the exclusion of certain days. however, if the date being excluded is inside the time alloted for a task, by adding an extra day to the duration of the task, rather than creating a gap within the scheduled task. 
+
+## present some screenshots to show for it and the math to back it up. 
+
        dateFormat  YYYY-MM-DD
        title Adding GANTT diagram functionality to mermaid
 

From 005defbb5c65f1c225db48476fa5d7ff1a46b799 Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Sat, 7 Mar 2020 16:17:03 -0800
Subject: [PATCH 08/34] Add files via upload

---
 docs/img/Gantt-excluded-days-within.png | Bin 0 -> 79453 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 docs/img/Gantt-excluded-days-within.png

diff --git a/docs/img/Gantt-excluded-days-within.png b/docs/img/Gantt-excluded-days-within.png
new file mode 100644
index 0000000000000000000000000000000000000000..2283bf99d8d6ed1b721541ce1f0f8b38d6e19887
GIT binary patch
literal 79453
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

literal 0
HcmV?d00001


From 4caa02474c3b88948c2f8d6fd3f5ef5443cc605f Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Sat, 7 Mar 2020 16:17:11 -0800
Subject: [PATCH 09/34] Update gantt.md

---
 docs/gantt.md | 28 ++++++++++++++++++----------
 1 file changed, 18 insertions(+), 10 deletions(-)

diff --git a/docs/gantt.md b/docs/gantt.md
index 70f980bae..7f61578de 100755
--- a/docs/gantt.md
+++ b/docs/gantt.md
@@ -1,8 +1,19 @@
 # Gantt diagrams
 
-> A Gantt chart is a type of bar chart, first developed by Karol Adamiecki in 1896, and independently by Henry Gantt in the 1910s, that illustrates a project schedule. Gantt charts illustrate the start and finish dates of the terminal elements and summary elements of a project.
-
-Mermaid can render Gantt diagrams.
+> A Gantt chart is a type of bar chart, first developed by Karol Adamiecki in 1896, and independently by Henry Gantt in the 1910s, that illustrates a project schedule and the amount of time it would take for any one project to finish. Gantt charts illustrate number of days between the start and finish dates of the terminal elements and summary elements of a project.
+ 
+ ## A note to users
+ Gannt Charts will record each scheduled task as one continuous bar that extends from the left to the right. The lower axis represents time and the right records the different tasks and their order.  
+ 
+ It is important to remember that when a date, day or collection of dates are "excluded", the Gannt Chart will accomodate those changes by extending another day, towards the right, not by creating a gap inside the task.
+ As shown here [excluded dates without](.docs/img/Gantt-excluded-days-within.png)
+ 
+ However, if the excluded date/s is between two tasks that are set to start consecutively, the excluded dates will be skipped graphically and left blank, and the following task will begin after the end of the excluded date/s.   
+ As shown here [excluded dates between](.docs/img/Gantt-long-weekend-look.png)
+ 
+ Thus, it is useful for tracking the amount of time it would take before a project is finished, but it can also be used to graphically represent "non-working days.
+ 
+Mermaid can render Gantt diagrams as SVG, PNG or a MarkDown link that can be pasted into docs. 
 
 ```
 gantt
@@ -30,14 +41,11 @@ gantt
 
 ```
 gantt
-##     excludes (excludes specified day, i.e, "weekends", saturday, sunday, monday, or specific dates, making it useful for computing the amount of time it will take before a project is finished, not the amount of time and effort spent on a project, by individual contributors. 
-important note when using exclude function, the graphic will accomodate the exclusion of certain days. however, if the date being excluded is inside the time alloted for a task, by adding an extra day to the duration of the task, rather than creating a gap within the scheduled task. 
 
-## present some screenshots to show for it and the math to back it up. 
-
-       dateFormat  YYYY-MM-DD
-       title Adding GANTT diagram functionality to mermaid
 
+       dateFormat                :YYYY-MM-DD
+       title                     :Adding GANTT diagram functionality to mermaid
+       excludes                  :excludes the named objects from being charted. Accepts specific dates in YY-MM-DD format, days of the week ("sunday") or "weekends", but not the word "weekdays". 
        section A section
        Completed task            :done,    des1, 2014-01-06,2014-01-08
        Active task               :active,  des2, 2014-01-09, 3d
@@ -123,7 +131,7 @@ Tbd
 
 ### Date format
 
-The default date format is YYYY-MM-DD. You can define your ``dateFormat``. For example:
+The default date format is YYYY-MM-DD. You can define your ``dateFormat``. For example: 2020-3-7
 
 ```
 dateFormat YYYY MM DD

From 5cd54c4831e31940952cd7cd4e3d7c7714350e85 Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Sat, 7 Mar 2020 16:21:07 -0800
Subject: [PATCH 10/34] Update gantt.md

---
 docs/gantt.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/gantt.md b/docs/gantt.md
index 7f61578de..5fc40436e 100755
--- a/docs/gantt.md
+++ b/docs/gantt.md
@@ -6,7 +6,7 @@
  Gannt Charts will record each scheduled task as one continuous bar that extends from the left to the right. The lower axis represents time and the right records the different tasks and their order.  
  
  It is important to remember that when a date, day or collection of dates are "excluded", the Gannt Chart will accomodate those changes by extending another day, towards the right, not by creating a gap inside the task.
- As shown here [excluded dates without](.docs/img/Gantt-excluded-days-within.png)
+ As shown here [excluded dates without](https://github.com/NeilCuzon/mermaid/blob/develop/docs/img/Gantt-excluded-days-within.png)
  
  However, if the excluded date/s is between two tasks that are set to start consecutively, the excluded dates will be skipped graphically and left blank, and the following task will begin after the end of the excluded date/s.   
  As shown here [excluded dates between](.docs/img/Gantt-long-weekend-look.png)

From 5dae0c14d92f76ee19224847912d424c12549a39 Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Sat, 7 Mar 2020 16:22:55 -0800
Subject: [PATCH 11/34] Add files via upload

---
 docs/img/Gantt-long-weekend-look.png | Bin 0 -> 79092 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 docs/img/Gantt-long-weekend-look.png

diff --git a/docs/img/Gantt-long-weekend-look.png b/docs/img/Gantt-long-weekend-look.png
new file mode 100644
index 0000000000000000000000000000000000000000..1b2fc8e17ef9a4adb34de9dc326d41584873292c
GIT binary patch
literal 79092
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
MKlB@l@6qgk080{I(f|Me

literal 0
HcmV?d00001


From d96d40e0b069576b9cdea30104626bda291c33ac Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Sat, 7 Mar 2020 16:23:51 -0800
Subject: [PATCH 12/34] Update gantt.md

---
 docs/gantt.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/gantt.md b/docs/gantt.md
index 5fc40436e..3cae0f4ac 100755
--- a/docs/gantt.md
+++ b/docs/gantt.md
@@ -6,10 +6,10 @@
  Gannt Charts will record each scheduled task as one continuous bar that extends from the left to the right. The lower axis represents time and the right records the different tasks and their order.  
  
  It is important to remember that when a date, day or collection of dates are "excluded", the Gannt Chart will accomodate those changes by extending another day, towards the right, not by creating a gap inside the task.
- As shown here [excluded dates without](https://github.com/NeilCuzon/mermaid/blob/develop/docs/img/Gantt-excluded-days-within.png)
+ As shown here ![](https://github.com/NeilCuzon/mermaid/blob/develop/docs/img/Gantt-excluded-days-within.png)
  
  However, if the excluded date/s is between two tasks that are set to start consecutively, the excluded dates will be skipped graphically and left blank, and the following task will begin after the end of the excluded date/s.   
- As shown here [excluded dates between](.docs/img/Gantt-long-weekend-look.png)
+ As shown here ![](https://github.com/NeilCuzon/mermaid/blob/develop/docs/img/Gantt-long-weekend-look.png)
  
  Thus, it is useful for tracking the amount of time it would take before a project is finished, but it can also be used to graphically represent "non-working days.
  

From fdaf13bdc4b80545a2b87ca87bebb5370ea91ce2 Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Sat, 7 Mar 2020 16:26:22 -0800
Subject: [PATCH 13/34] Update gantt.md

---
 docs/gantt.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/gantt.md b/docs/gantt.md
index 3cae0f4ac..b57b933c6 100755
--- a/docs/gantt.md
+++ b/docs/gantt.md
@@ -3,7 +3,7 @@
 > A Gantt chart is a type of bar chart, first developed by Karol Adamiecki in 1896, and independently by Henry Gantt in the 1910s, that illustrates a project schedule and the amount of time it would take for any one project to finish. Gantt charts illustrate number of days between the start and finish dates of the terminal elements and summary elements of a project.
  
  ## A note to users
- Gannt Charts will record each scheduled task as one continuous bar that extends from the left to the right. The lower axis represents time and the right records the different tasks and their order.  
+ Gannt Charts will record each scheduled task as one continuous bar that extends from the left to the right. The x axis represents time and the y records the different tasks and the order in which they are to be completed.   
  
  It is important to remember that when a date, day or collection of dates are "excluded", the Gannt Chart will accomodate those changes by extending another day, towards the right, not by creating a gap inside the task.
  As shown here ![](https://github.com/NeilCuzon/mermaid/blob/develop/docs/img/Gantt-excluded-days-within.png)

From e90ed7a85329168f610d18f06ec2cddbfbb8e7fd Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Sat, 7 Mar 2020 16:46:59 -0800
Subject: [PATCH 14/34] Update gantt.md

---
 docs/gantt.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/gantt.md b/docs/gantt.md
index b57b933c6..321bb5712 100755
--- a/docs/gantt.md
+++ b/docs/gantt.md
@@ -5,13 +5,13 @@
  ## A note to users
  Gannt Charts will record each scheduled task as one continuous bar that extends from the left to the right. The x axis represents time and the y records the different tasks and the order in which they are to be completed.   
  
- It is important to remember that when a date, day or collection of dates are "excluded", the Gannt Chart will accomodate those changes by extending another day, towards the right, not by creating a gap inside the task.
+ It is important to remember that when a date, day or collection of dates specific to a task are "excluded", the Gannt Chart will accomodate those changes by extending an equal number of day, towards the right, not by creating a gap inside the task.
  As shown here ![](https://github.com/NeilCuzon/mermaid/blob/develop/docs/img/Gantt-excluded-days-within.png)
  
  However, if the excluded date/s is between two tasks that are set to start consecutively, the excluded dates will be skipped graphically and left blank, and the following task will begin after the end of the excluded date/s.   
  As shown here ![](https://github.com/NeilCuzon/mermaid/blob/develop/docs/img/Gantt-long-weekend-look.png)
  
- Thus, it is useful for tracking the amount of time it would take before a project is finished, but it can also be used to graphically represent "non-working days.
+ A Gantt chart is useful for tracking the amount of time it would take before a project is finished, but it can also be used to graphically represent "non-working days, with a few tweaks. 
  
 Mermaid can render Gantt diagrams as SVG, PNG or a MarkDown link that can be pasted into docs. 
 

From df88300e6e9c25179893c40b4b3f7fbcd0d415f2 Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Sat, 7 Mar 2020 16:50:39 -0800
Subject: [PATCH 15/34] Update README.md

---
 docs/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/README.md b/docs/README.md
index 22151a6f2..4e3f71c02 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -9,7 +9,7 @@
 
 It is a simple markdown-inspired, script language for diagramming and charting that can be deployed via Javascipt.
 
-The reasoning behind it's inception was a need for simplified documentation and frustration with heavy and time consuming tools like Visio, for explaining code. 
+The reasoning behind it's inception was a need for simplified documentation and frustration with heavy and time consuming tools for explaining code, like Visio. 
 
 Thus mermaid was created to make the process of diagramming and charting, as simple and as close to markdown, as possible.
 

From d3b69abd87941bf9f53bff70fadca0c02ea1e0f5 Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Sat, 7 Mar 2020 16:54:49 -0800
Subject: [PATCH 16/34] Update gantt.md

---
 docs/gantt.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/gantt.md b/docs/gantt.md
index 321bb5712..542f3a43e 100755
--- a/docs/gantt.md
+++ b/docs/gantt.md
@@ -45,7 +45,8 @@ gantt
 
        dateFormat                :YYYY-MM-DD
        title                     :Adding GANTT diagram functionality to mermaid
-       excludes                  :excludes the named objects from being charted. Accepts specific dates in YY-MM-DD format, days of the week ("sunday") or "weekends", but not the word "weekdays". 
+       excludes                  :excludes the named dates/days from being included in a charted task.. 
+       (Accepts specific dates in YYYY-MM-DD format, days of the week ("sunday") or "weekends", but not the word "weekdays".) 
        section A section
        Completed task            :done,    des1, 2014-01-06,2014-01-08
        Active task               :active,  des2, 2014-01-09, 3d

From b0852222530fc441ca9402399ad4ac5147ed4540 Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Mon, 9 Mar 2020 22:55:03 -0700
Subject: [PATCH 17/34] Delete README.md

---
 docs/README.md | 239 -------------------------------------------------
 1 file changed, 239 deletions(-)
 delete mode 100644 docs/README.md

diff --git a/docs/README.md b/docs/README.md
deleted file mode 100644
index 4e3f71c02..000000000
--- a/docs/README.md
+++ /dev/null
@@ -1,239 +0,0 @@
-# Mermaid
-
-[![Build Status](https://travis-ci.org/mermaid-js/mermaid.svg?branch=master)](https://travis-ci.org/mermaid-js/mermaid)
-[![Coverage Status](https://coveralls.io/repos/github/knsv/mermaid/badge.svg?branch=master)](https://coveralls.io/github/knsv/mermaid?branch=master)
-[![Join the chat at https://gitter.im/knsv/mermaid](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/knsv/mermaid?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
-
-![banner](./img/header.png)
-# What is mermaid?
-
-It is a simple markdown-inspired, script language for diagramming and charting that can be deployed via Javascipt.
-
-The reasoning behind it's inception was a need for simplified documentation and frustration with heavy and time consuming tools for explaining code, like Visio. 
-
-Thus mermaid was created to make the process of diagramming and charting, as simple and as close to markdown, as possible.
-
-Check out the list of [Integrations and Usages of Mermaid](./integrations.md)
-For the uninitiated, you can also  try out our [live editor](https://mermaid-js.github.io/mermaid-live-editor/) and look at our [documentation](https://mermaid-js.github.io/mermaid/#/n00b-overview) for a deeper understanding of the tool itself, more importantly don't forget to have fun. 
-
-**Mermaid was nominated and won the JS Open Source Awards (2019) in the category "The most exciting use of technology"!!! Thanks to all involved, people committing pull requests, people answering questions and special thanks to Tyler Long who is helping me maintain the project.**
-
-## New diagrams in 8.4
-
-With version 8.4 class diagrams have got some new features, bug fixes and documentation. Another new feature in 8.4 is the new diagram type, state diagrams.
-
-![Image show the two new diagram types](./img/new-diagrams.png)
-
-## Special note regarding version 8.2
-
-In version 8.2 a security improvement was introduced. A securityLevel configuration was introduced which sets the level of trust to be used on the parsed diagrams.
-
-- **true**: (default) tags in text are encoded, click functionality is disabled
-- false: tags in text are allowed, click functionality is enabled
-
-Closed issues:
-
-⚠️ **Note** : This changes the default behaviour of mermaid so that after upgrade to 8.2, if the securityLevel is not configured, tags in flowcharts are encoded as tags and clicking is prohibited.
-
-If your application is taking resposibility for the diagram source security you can set the securityLevel accordingly. By doing this clicks and tags are again allowed.
-
-```javascript
-mermaidAPI.initialize({
-    securityLevel: 'loose'
-});
-```
-
-**🖖 Keep a steady pulse: mermaid needs more Collaborators [#866](https://github.com/k3nsv/mermaid/issues/866)**
-
-## The following are examples of Diagrams that mermaid can make:
-
-### Flowchart
-
-```
-graph TD;
-    A-->B;
-    A-->C;
-    B-->D;
-    C-->D;
-```
-
-![Flowchart](./img/flow.png)
-
-### Sequence diagram
-
-```
-sequenceDiagram
-    participant Alice
-    participant Bob
-    Alice->>John: Hello John, how are you?
-    loop Healthcheck
-        John->>John: Fight against hypochondria
-    end
-    Note right of John: Rational thoughts <br/>prevail!
-    John-->>Alice: Great!
-    John->>Bob: How about you?
-    Bob-->>John: Jolly good!
-```
-
-![Sequence diagram](./img/sequence.png)
-
-### Gantt diagram
-
-```
-gantt
-dateFormat  YYYY-MM-DD
-title Adding GANTT diagram to mermaid
-excludes weekdays 2014-01-10
-
-section A section
-Completed task            :done,    des1, 2014-01-06,2014-01-08
-Active task               :active,  des2, 2014-01-09, 3d
-Future task               :         des3, after des2, 5d
-Future task2               :         des4, after des3, 5d
-```
-
-![Gantt diagram](./img/gantt.png)
-
-### Class diagram - :exclamation: experimental
-
-```
-classDiagram
-Class01 <|-- AveryLongClass : Cool
-Class03 *-- Class04
-Class05 o-- Class06
-Class07 .. Class08
-Class09 --> C2 : Where am i?
-Class09 --* C3
-Class09 --|> Class07
-Class07 : equals()
-Class07 : Object[] elementData
-Class01 : size()
-Class01 : int chimp
-Class01 : int gorilla
-Class08 <--> C2: Cool label
-```
-
-![Class diagram](./img/class.png)
-
-### Git graph - :exclamation: experimental
-
-```
-gitGraph:
-options
-{
-    "nodeSpacing": 150,
-    "nodeRadius": 10
-}
-end
-commit
-branch newbranch
-checkout newbranch
-commit
-commit
-checkout master
-commit
-commit
-merge newbranch
-
-```
-
-![Git graph](./img/git.png)
-
-## Installation
-
-### CDN
-
-```
-https://unpkg.com/mermaid@<version>/dist/
-```
-
-Replace `<version>` with expected version number.
-
-Example: https://unpkg.com/mermaid@7.1.0/dist/
-
-### Node.js
-
-```
-yarn add mermaid
-```
-
-## Documentation
-
-https://mermaidjs.github.io
-
-## Sibling projects
-
-- [mermaid CLI](https://github.com/mermaidjs/mermaid.cli)
-- [mermaid live editor](https://github.com/mermaidjs/mermaid-live-editor)
-- [mermaid webpack demo](https://github.com/mermaidjs/mermaid-webpack-demo)
-- [mermaid Parcel demo](https://github.com/mermaidjs/mermaid-parcel-demo)
-
-## Request for assistance
-
-Things are piling up and I have a hard time keeping up. To remedy this
-it would be great if we could form a core team of developers to cooperate
-with the future development of mermaid.
-
-As part of this team you would get write access to the repository and would
-represent the project when answering questions and issues.
-
-Together we could continue the work with things like:
-
-- Adding more types of diagrams like mindmaps, ert diagrams, etc.
-- Improving existing diagrams
-
-Don't hesitate to contact me if you want to get involved.
-
-## For contributors
-
-### Setup
-
-```
-yarn install
-```
-
-### Build
-
-```
-yarn build:watch
-```
-
-### Lint
-
-```
-yarn lint
-```
-
-We use [eslint](https://eslint.org/).
-We recommend you installing [editor plugins](https://eslint.org/docs/user-guide/integrations) so you can get real time lint result.
-
-### Test
-
-```
-yarn test
-```
-Manual test in browser: open `dist/index.html`
-
-### Release
-
-For those who have the permission to do so:
-
-Update version number in `package.json`.
-
-```
-npm publish
-```
-
-Command above generates files into the `dist` folder and publishes them to npmjs.org.
-
-## Credits
-
-Many thanks to the [d3](http://d3js.org/) and [dagre-d3](https://github.com/cpettitt/dagre-d3) projects for providing the graphical layout and drawing libraries!
-
-Thanks also to the [js-sequence-diagram](http://bramp.github.io/js-sequence-diagrams) project for usage of the grammar for the sequence diagrams. Thanks to Jessica Peter for inspiration and starting point for gantt rendering.
-
-_Mermaid was created by Knut Sveidqvist for easier documentation._
-
-_[Tyler Long](https://github.com/tylerlong) has became a collaborator since April 2017._
-
-Here is the full list of the projects [contributors](https://github.com/knsv/mermaid/graphs/contributors).

From 71cfec91afbfdf1223a28d029a82568c841201df Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Mon, 9 Mar 2020 23:02:14 -0700
Subject: [PATCH 18/34] Update README.md

---
 README.md | 344 +++++++++++++++++++++++++++++-------------------------
 1 file changed, 187 insertions(+), 157 deletions(-)

diff --git a/README.md b/README.md
index 781cee7e1..791ac115c 100644
--- a/README.md
+++ b/README.md
@@ -1,26 +1,29 @@
-<!-- <Remove this in the future> -->
-| :mega: :mega: :mega: |
-| :----: |
-| * If you're upgrading from a version __< v8.2.0__, there are [non-backward-compatible changes](http://mermaid-js.github.io/mermaid/#/usage?id=to-enable-click-event-and-tags-in-nodes) related to security issues. Default behaviour of the library might have changed for your implementation.|
-<!-- </Remove this in the future> -->
 
-# mermaid [![Build Status](https://travis-ci.org/mermaid-js/mermaid.svg?branch=master)](https://travis-ci.org/mermaid-js/mermaid) [![NPM](https://img.shields.io/npm/v/mermaid)](https://www.npmjs.com/package/mermaid) [![Coverage Status](https://coveralls.io/repos/github/mermaid-js/mermaid/badge.svg?branch=master)](https://coveralls.io/github/mermaid-js/mermaid?branch=master) [![Join our Slack!](https://img.shields.io/static/v1?message=join%20chat&color=9cf&logo=slack&label=slack)](https://join.slack.com/t/mermaid-talk/shared_invite/enQtNzc4NDIyNzk4OTAyLWVhYjQxOTI2OTg4YmE1ZmJkY2Y4MTU3ODliYmIwOTY3NDJlYjA0YjIyZTdkMDMyZTUwOGI0NjEzYmEwODcwOTE) [![This project is using Percy.io for visual regression testing.](https://percy.io/static/images/percy-badge.svg)](https://percy.io/Mermaid/mermaid)
+# Mermaid
 
-<!-- <Main description> -->
-__mermaid is a Javascript based diagramming and charting tool. It generates diagrams flowcharts and more, using markdown-inspired text for ease and speed.__
+[![Build Status](https://travis-ci.org/mermaid-js/mermaid.svg?branch=master)](https://travis-ci.org/mermaid-js/mermaid)
+[![Coverage Status](https://coveralls.io/repos/github/knsv/mermaid/badge.svg?branch=master)](https://coveralls.io/github/knsv/mermaid?branch=master)
+[![Join the chat at https://gitter.im/knsv/mermaid](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/knsv/mermaid?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
-Check out the list of [Integrations and Usages of Mermaid](https://github.com/mermaid-js/mermaid/blob/develop/docs/integrations.md)
+![banner](./img/header.png)
+# What is mermaid?
 
-For more information and help in getting started, please view our [documentation](http://mermaid-js.github.io/mermaid/) and start simplifying yours. Alternatively, you can also play with our [live editor](https://mermaidjs.github.io/mermaid-live-editor/).
-<!-- </Main description> --> 
+It is a simple markdown-inspired, script language for diagramming and charting that can be deployed via Javascipt.
 
-:trophy: **Mermaid was nominated and won the [JS Open Source Awards (2019)](https://osawards.com/javascript/#nominees) in the category "The most exciting use of technology"!!! Thanks to all involved, people committing pull requests, people answering questions and special thanks to Tyler Long who is helping me maintain the project.**
+The reasoning behind it's inception was a need for simplified documentation and frustration with heavy and time consuming tools for explaining code, like Visio. 
+
+Thus mermaid was created to make the process of diagramming and charting, as simple and as close to markdown, as possible.
+
+Check out the list of [Integrations and Usages of Mermaid](./integrations.md)
+For the uninitiated, you can also  try out our [live editor](https://mermaid-js.github.io/mermaid-live-editor/) and look at our [documentation](https://mermaid-js.github.io/mermaid/#/n00b-overview) for a deeper understanding of the tool itself, more importantly don't forget to have fun. 
+
+**Mermaid was nominated and won the JS Open Source Awards (2019) in the category "The most exciting use of technology"!!! Thanks to all involved, people committing pull requests, people answering questions and special thanks to Tyler Long who is helping me maintain the project.**
 
 ## New diagrams in 8.4
 
 With version 8.4 class diagrams have got some new features, bug fixes and documentation. Another new feature in 8.4 is the new diagram type, state diagrams.
 
-![Image show the two new diagram types](.docs/img/new-diagrams.png)
+![Image show the two new diagram types](./img/new-diagrams.png)
 
 ## Special note regarding version 8.2
 
@@ -41,82 +44,64 @@ mermaidAPI.initialize({
 });
 ```
 
-For more information and help in getting started, please view our [documentation](http://mermaid-js.github.io/mermaid/) and start simplifying yours. Play with our [live editor](https://mermaidjs.github.io/mermaid-live-editor/) or jump straight to the [installation and usage](http://mermaid-js.github.io/mermaid/#/usage).
-<!-- </Main description> -->
+**🖖 Keep a steady pulse: mermaid needs more Collaborators [#866](https://github.com/k3nsv/mermaid/issues/866)**
 
-__The following are some examples of the diagrams, charts and graphs that can be made using mermaid and the Markdown-inspired text specific to it. Click here jump into the [text syntax](https://mermaid-js.github.io/mermaid/#/n00b-syntaxReference).__
-<table>
-<!-- <Flowchart> -->
-<tr><td colspan=2 align="center">
-    <b>Flow</b></br>
-    [<a href="http://mermaid-js.github.io/mermaid/#/flowchart">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZ3JhcGggVERcbiAgICBBW0hhcmRdIC0tPnxUZXh0fCBCKFJvdW5kKVxuICAgIEIgLS0-IEN7RGVjaXNpb259XG4gICAgQyAtLT58T25lfCBEW1Jlc3VsdCAxXVxuICAgIEMgLS0-fFR3b3wgRVtSZXN1bHQgMl0iLCJtZXJtYWlkIjp7InRoZW1lIjoiZGVmYXVsdCJ9fQ">live editor</a>]
-</td></tr>
-<tr>
-    <td><pre>
-graph TD
-A[Hard] -->|Text| B(Round)
-B --> C{Decision}
-C -->|One| D[Result 1]
-C -->|Two| E[Result 2]
-    </pre></td>
-    <td align="center">
-        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-flow.png" />
-    </td>
-</tr>
-<!-- </Flowchart> -->
-<!-- <Sequence> -->
-<tr><td colspan=2 align="center">
-    <b>Sequence</b><br />
-    [<a href="http://mermaid-js.github.io/mermaid/#/sequenceDiagram">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoic2VxdWVuY2VEaWFncmFtXG5BbGljZS0-PkpvaG46IEhlbGxvIEpvaG4sIGhvdyBhcmUgeW91P1xubG9vcCBIZWFsdGhjaGVja1xuICAgIEpvaG4tPj5Kb2huOiBGaWdodCBhZ2FpbnN0IGh5cG9jaG9uZHJpYVxuZW5kXG5Ob3RlIHJpZ2h0IG9mIEpvaG46IFJhdGlvbmFsIHRob3VnaHRzIVxuSm9obi0tPj5BbGljZTogR3JlYXQhXG5Kb2huLT4-Qm9iOiBIb3cgYWJvdXQgeW91P1xuQm9iLS0-PkpvaG46IEpvbGx5IGdvb2QhIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
-</td></tr>
-<tr>
-    <td><pre>
+## The following are examples of Diagrams that mermaid can make:
+
+### Flowchart
+
+```
+graph TD;
+    A-->B;
+    A-->C;
+    B-->D;
+    C-->D;
+```
+
+![Flowchart](./img/flow.png)
+
+### Sequence diagram
+
+```
 sequenceDiagram
-Alice->>John: Hello John, how are you?
-loop Healthcheck
-    John->>John: Fight against hypochondria
-end
-Note right of John: Rational thoughts!
-John-->>Alice: Great!
-John->>Bob: How about you?
-Bob-->>John: Jolly good!
-    </pre></td>
-    <td align="center">
-        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-sequence.png" />
-    </td>
-</tr>
-<!-- </Sequence> -->
-<!-- <Gantt> -->
-<tr><td colspan=2 align="center">
-    <b>Gantt</b><br />
-    [<a href="http://mermaid-js.github.io/mermaid/#/gantt">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZ2FudHRcbnNlY3Rpb24gU2VjdGlvblxuQ29tcGxldGVkIDpkb25lLCAgICBkZXMxLCAyMDE0LTAxLTA2LDIwMTQtMDEtMDhcbkFjdGl2ZSAgICAgICAgOmFjdGl2ZSwgIGRlczIsIDIwMTQtMDEtMDcsIDNkXG5QYXJhbGxlbCAxICAgOiAgICAgICAgIGRlczMsIGFmdGVyIGRlczEsIDFkXG5QYXJhbGxlbCAyICAgOiAgICAgICAgIGRlczQsIGFmdGVyIGRlczEsIDFkXG5QYXJhbGxlbCAzICAgOiAgICAgICAgIGRlczUsIGFmdGVyIGRlczMsIDFkXG5QYXJhbGxlbCA0ICAgOiAgICAgICAgIGRlczYsIGFmdGVyIGRlczQsIDFkIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
-</td></tr>
-<tr>
-    <td><pre>
+    participant Alice
+    participant Bob
+    Alice->>John: Hello John, how are you?
+    loop Healthcheck
+        John->>John: Fight against hypochondria
+    end
+    Note right of John: Rational thoughts <br/>prevail!
+    John-->>Alice: Great!
+    John->>Bob: How about you?
+    Bob-->>John: Jolly good!
+```
+
+![Sequence diagram](./img/sequence.png)
+
+### Gantt diagram
+
+```
 gantt
-section Section
-Completed :done,    des1, 2014-01-06,2014-01-08
-Active        :active,  des2, 2014-01-07, 3d
-Parallel 1   :         des3, after des1, 1d
-Parallel 2   :         des4, after des1, 1d
-Parallel 3   :         des5, after des3, 1d
-Parallel 4   :         des6, after des4, 1d
-    </pre></td>
-    <td align="center">
-        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-gantt.png" />
-    </td>
-</tr>
-<!-- </Gantt> -->
-<!-- <Class> -->
-<tr><td colspan=2 align="center">
-    <b>Class</b><br />
-    [<a href="http://mermaid-js.github.io/mermaid/#/classDiagram">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiY2xhc3NEaWFncmFtXG5DbGFzczAxIDx8LS0gQXZlcnlMb25nQ2xhc3MgOiBDb29sXG48PGludGVyZmFjZT4-IENsYXNzMDFcbkNsYXNzMDkgLS0-IEMyIDogV2hlcmUgYW0gaT9cbkNsYXNzMDkgLS0qIEMzXG5DbGFzczA5IC0tfD4gQ2xhc3MwN1xuQ2xhc3MwNyA6IGVxdWFscygpXG5DbGFzczA3IDogT2JqZWN0W10gZWxlbWVudERhdGFcbkNsYXNzMDEgOiBzaXplKClcbkNsYXNzMDEgOiBpbnQgY2hpbXBcbkNsYXNzMDEgOiBpbnQgZ29yaWxsYVxuY2xhc3MgQ2xhc3MxMCB7XG4gID4-c2VydmljZT4-XG4gIGludCBpZFxuICBzaXplKClcbn0iLCJtZXJtYWlkIjp7InRoZW1lIjoiZGVmYXVsdCJ9fQ">live editor</a>]
-</td></tr>
-<tr>
-    <td><pre>
+dateFormat  YYYY-MM-DD
+title Adding GANTT diagram to mermaid
+excludes weekdays 2014-01-10
+section A section
+Completed task            :done,    des1, 2014-01-06,2014-01-08
+Active task               :active,  des2, 2014-01-09, 3d
+Future task               :         des3, after des2, 5d
+Future task2               :         des4, after des3, 5d
+```
+
+![Gantt diagram](./img/gantt.png)
+
+### Class diagram - :exclamation: experimental
+
+```
 classDiagram
-Class01 &lt;|-- AveryLongClass : Cool
-&lt;&lt;interface>> Class01
+Class01 <|-- AveryLongClass : Cool
+Class03 *-- Class04
+Class05 o-- Class06
+Class07 .. Class08
 Class09 --> C2 : Where am i?
 Class09 --* C3
 Class09 --|> Class07
@@ -125,84 +110,129 @@ Class07 : Object[] elementData
 Class01 : size()
 Class01 : int chimp
 Class01 : int gorilla
-class Class10 {
-  &lt;&lt;service>>
-  int id
-  size()
+Class08 <--> C2: Cool label
+```
+
+![Class diagram](./img/class.png)
+
+### Git graph - :exclamation: experimental
+
+```
+gitGraph:
+options
+{
+    "nodeSpacing": 150,
+    "nodeRadius": 10
 }
-</pre></td>
-    <td align="center">
-        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-class.png" />
-    </td>
-</tr>
-<!-- </Class> -->
-<!-- <State> -->
-<tr><td colspan=2 align="center">
-    <b>State</b><br />
-    [<a href="http://mermaid-js.github.io/mermaid/#/stateDiagram">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoic3RhdGVEaWFncmFtXG4gICAgWypdIC0tPiBTdGlsbFxuICAgIFN0aWxsIC0tPiBbKl1cbiAgICBTdGlsbCAtLT4gTW92aW5nXG4gICAgTW92aW5nIC0tPiBTdGlsbFxuICAgIE1vdmluZyAtLT4gQ3Jhc2hcbiAgICBDcmFzaCAtLT4gWypdIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
-</td></tr>
-<tr>
-    <td><pre>
-stateDiagram
-[*] --> Still
-Still --> [*]
-Still --> Moving
-Moving --> Still
-Moving --> Crash
-Crash --> [*]
-</pre></td>
-    <td align="center">
-        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-state.png" />
-    </td>
-</tr>
-<!-- </State> -->
-<!-- <Pie> -->
-<tr><td colspan=2 align="center">
-    <b>Pie</b><br />
-    [<a href="http://mermaid-js.github.io/mermaid/#/pie">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoicGllXG5cIkRvZ3NcIiA6IDQyLjk2XG5cIkNhdHNcIiA6IDUwLjA1XG5cIlJhdHNcIiA6IDEwLjAxIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
-</td></tr>
-<tr>
-    <td><pre>
-pie
-"Dogs" : 386
-"Cats" : 85
-"Rats" : 15 
-</pre></td>
-    <td align="center">
-        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-pie.png" />
-    </td>
-</tr>
-<!-- </Pie> -->
-<!-- <Git> -->
-<tr><td colspan=2 align="center">
-    <b>Git</b><br />
-    [experimental - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZ2l0R3JhcGg6XG5vcHRpb25zXG57XG4gICAgXCJub2RlU3BhY2luZ1wiOiAxNTAsXG4gICAgXCJub2RlUmFkaXVzXCI6IDEwXG59XG5lbmRcbmNvbW1pdFxuYnJhbmNoIG5ld2JyYW5jaFxuY2hlY2tvdXQgbmV3YnJhbmNoXG5jb21taXRcbmNvbW1pdFxuY2hlY2tvdXQgbWFzdGVyXG5jb21taXRcbmNvbW1pdFxubWVyZ2UgbmV3YnJhbmNoXG4iLCJtZXJtYWlkIjp7InRoZW1lIjoiZGVmYXVsdCJ9fQ">live editor</a>]
-</td></tr>
-<tr>
-    <td colspan="2" align="center"><i>Coming soon!</i></td>
-</tr>
-<!-- </Git> -->
-</table>
+end
+commit
+branch newbranch
+checkout newbranch
+commit
+commit
+checkout master
+commit
+commit
+merge newbranch
+```
 
-## Related projects 
+![Git graph](./img/git.png)
 
-- [Command Line Interface](https://github.com/mermaid-js/mermaid.cli)
-- [Live Editor](https://github.com/mermaid-js/mermaid-live-editor)
+## Installation
 
-# Contributors [![Help wanted](https://img.shields.io/github/labels/mermaid-js/mermaid/Help%20wanted!)](https://github.com/mermaid-js/mermaid/issues?q=is%3Aissue+is%3Aopen+label%3A%22Help+wanted%21%22) [![Contributors](https://img.shields.io/github/contributors/mermaid-js/mermaid)](https://github.com/mermaid-js/mermaid/graphs/contributors) [![Commits](https://img.shields.io/github/commit-activity/m/mermaid-js/mermaid)](https://github.com/mermaid-js/mermaid/graphs/contributors)
+### CDN
 
-Mermaid is a growing community and is always accepting new contributors. There's a lot of different ways to help out and we're always looking for extra hands! Look at [this issue](https://github.com/mermaid-js/mermaid/issues/866) if you want to know where to start helping out.
+```
+https://unpkg.com/mermaid@<version>/dist/
+```
 
-Detailed information about how to contribute can be found in the [contribution guide](CONTRIBUTING.md)
+Replace `<version>` with expected version number.
 
-# Appreciation
-A quick note from Knut Sveidqvist:
->*Many thanks to the [d3](http://d3js.org/) and [dagre-d3](https://github.com/cpettitt/dagre-d3) projects for providing the graphical layout and drawing libraries!*
->*Thanks also to the [js-sequence-diagram](http://bramp.github.io/js-sequence-diagrams) project for usage of the grammar for the sequence diagrams. Thanks to Jessica Peter for inspiration and starting point for gantt rendering.*
->*Thank you to [Tyler Long](https://github.com/tylerlong) who has been a collaborator since April 2017.*
->
->*Thank you to the ever-growing list of [contributors](https://github.com/knsv/mermaid/graphs/contributors) that brought the project this far!*
+Example: https://unpkg.com/mermaid@7.1.0/dist/
 
----
+### Node.js
 
-*Mermaid was created by Knut Sveidqvist for easier documentation.*
+```
+yarn add mermaid
+```
+
+## Documentation
+
+https://mermaidjs.github.io
+
+## Sibling projects
+
+- [mermaid CLI](https://github.com/mermaidjs/mermaid.cli)
+- [mermaid live editor](https://github.com/mermaidjs/mermaid-live-editor)
+- [mermaid webpack demo](https://github.com/mermaidjs/mermaid-webpack-demo)
+- [mermaid Parcel demo](https://github.com/mermaidjs/mermaid-parcel-demo)
+
+## Request for assistance
+
+Things are piling up and I have a hard time keeping up. To remedy this
+it would be great if we could form a core team of developers to cooperate
+with the future development of mermaid.
+
+As part of this team you would get write access to the repository and would
+represent the project when answering questions and issues.
+
+Together we could continue the work with things like:
+
+- Adding more types of diagrams like mindmaps, ert diagrams, etc.
+- Improving existing diagrams
+
+Don't hesitate to contact me if you want to get involved.
+
+## For contributors
+
+### Setup
+
+```
+yarn install
+```
+
+### Build
+
+```
+yarn build:watch
+```
+
+### Lint
+
+```
+yarn lint
+```
+
+We use [eslint](https://eslint.org/).
+We recommend you installing [editor plugins](https://eslint.org/docs/user-guide/integrations) so you can get real time lint result.
+
+### Test
+
+```
+yarn test
+```
+Manual test in browser: open `dist/index.html`
+
+### Release
+
+For those who have the permission to do so:
+
+Update version number in `package.json`.
+
+```
+npm publish
+```
+
+Command above generates files into the `dist` folder and publishes them to npmjs.org.
+
+## Credits
+
+Many thanks to the [d3](http://d3js.org/) and [dagre-d3](https://github.com/cpettitt/dagre-d3) projects for providing the graphical layout and drawing libraries!
+
+Thanks also to the [js-sequence-diagram](http://bramp.github.io/js-sequence-diagrams) project for usage of the grammar for the sequence diagrams. Thanks to Jessica Peter for inspiration and starting point for gantt rendering.
+
+_Mermaid was created by Knut Sveidqvist for easier documentation._
+
+_[Tyler Long](https://github.com/tylerlong) has became a collaborator since April 2017._
+
+Here is the full list of the projects [contributors](https://github.com/knsv/mermaid/graphs/contributors).

From c3e9ae0ca055eef0f1f944f616dd34bc7ae445f9 Mon Sep 17 00:00:00 2001
From: NeilCuzon <elancuzon@gmail.com>
Date: Mon, 9 Mar 2020 23:23:27 -0700
Subject: [PATCH 19/34] Revert "Delete README.md"

This reverts commit b0852222530fc441ca9402399ad4ac5147ed4540.
---
 docs/README.md | 239 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 239 insertions(+)
 create mode 100644 docs/README.md

diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 000000000..4e3f71c02
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,239 @@
+# Mermaid
+
+[![Build Status](https://travis-ci.org/mermaid-js/mermaid.svg?branch=master)](https://travis-ci.org/mermaid-js/mermaid)
+[![Coverage Status](https://coveralls.io/repos/github/knsv/mermaid/badge.svg?branch=master)](https://coveralls.io/github/knsv/mermaid?branch=master)
+[![Join the chat at https://gitter.im/knsv/mermaid](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/knsv/mermaid?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+
+![banner](./img/header.png)
+# What is mermaid?
+
+It is a simple markdown-inspired, script language for diagramming and charting that can be deployed via Javascipt.
+
+The reasoning behind it's inception was a need for simplified documentation and frustration with heavy and time consuming tools for explaining code, like Visio. 
+
+Thus mermaid was created to make the process of diagramming and charting, as simple and as close to markdown, as possible.
+
+Check out the list of [Integrations and Usages of Mermaid](./integrations.md)
+For the uninitiated, you can also  try out our [live editor](https://mermaid-js.github.io/mermaid-live-editor/) and look at our [documentation](https://mermaid-js.github.io/mermaid/#/n00b-overview) for a deeper understanding of the tool itself, more importantly don't forget to have fun. 
+
+**Mermaid was nominated and won the JS Open Source Awards (2019) in the category "The most exciting use of technology"!!! Thanks to all involved, people committing pull requests, people answering questions and special thanks to Tyler Long who is helping me maintain the project.**
+
+## New diagrams in 8.4
+
+With version 8.4 class diagrams have got some new features, bug fixes and documentation. Another new feature in 8.4 is the new diagram type, state diagrams.
+
+![Image show the two new diagram types](./img/new-diagrams.png)
+
+## Special note regarding version 8.2
+
+In version 8.2 a security improvement was introduced. A securityLevel configuration was introduced which sets the level of trust to be used on the parsed diagrams.
+
+- **true**: (default) tags in text are encoded, click functionality is disabled
+- false: tags in text are allowed, click functionality is enabled
+
+Closed issues:
+
+⚠️ **Note** : This changes the default behaviour of mermaid so that after upgrade to 8.2, if the securityLevel is not configured, tags in flowcharts are encoded as tags and clicking is prohibited.
+
+If your application is taking resposibility for the diagram source security you can set the securityLevel accordingly. By doing this clicks and tags are again allowed.
+
+```javascript
+mermaidAPI.initialize({
+    securityLevel: 'loose'
+});
+```
+
+**🖖 Keep a steady pulse: mermaid needs more Collaborators [#866](https://github.com/k3nsv/mermaid/issues/866)**
+
+## The following are examples of Diagrams that mermaid can make:
+
+### Flowchart
+
+```
+graph TD;
+    A-->B;
+    A-->C;
+    B-->D;
+    C-->D;
+```
+
+![Flowchart](./img/flow.png)
+
+### Sequence diagram
+
+```
+sequenceDiagram
+    participant Alice
+    participant Bob
+    Alice->>John: Hello John, how are you?
+    loop Healthcheck
+        John->>John: Fight against hypochondria
+    end
+    Note right of John: Rational thoughts <br/>prevail!
+    John-->>Alice: Great!
+    John->>Bob: How about you?
+    Bob-->>John: Jolly good!
+```
+
+![Sequence diagram](./img/sequence.png)
+
+### Gantt diagram
+
+```
+gantt
+dateFormat  YYYY-MM-DD
+title Adding GANTT diagram to mermaid
+excludes weekdays 2014-01-10
+
+section A section
+Completed task            :done,    des1, 2014-01-06,2014-01-08
+Active task               :active,  des2, 2014-01-09, 3d
+Future task               :         des3, after des2, 5d
+Future task2               :         des4, after des3, 5d
+```
+
+![Gantt diagram](./img/gantt.png)
+
+### Class diagram - :exclamation: experimental
+
+```
+classDiagram
+Class01 <|-- AveryLongClass : Cool
+Class03 *-- Class04
+Class05 o-- Class06
+Class07 .. Class08
+Class09 --> C2 : Where am i?
+Class09 --* C3
+Class09 --|> Class07
+Class07 : equals()
+Class07 : Object[] elementData
+Class01 : size()
+Class01 : int chimp
+Class01 : int gorilla
+Class08 <--> C2: Cool label
+```
+
+![Class diagram](./img/class.png)
+
+### Git graph - :exclamation: experimental
+
+```
+gitGraph:
+options
+{
+    "nodeSpacing": 150,
+    "nodeRadius": 10
+}
+end
+commit
+branch newbranch
+checkout newbranch
+commit
+commit
+checkout master
+commit
+commit
+merge newbranch
+
+```
+
+![Git graph](./img/git.png)
+
+## Installation
+
+### CDN
+
+```
+https://unpkg.com/mermaid@<version>/dist/
+```
+
+Replace `<version>` with expected version number.
+
+Example: https://unpkg.com/mermaid@7.1.0/dist/
+
+### Node.js
+
+```
+yarn add mermaid
+```
+
+## Documentation
+
+https://mermaidjs.github.io
+
+## Sibling projects
+
+- [mermaid CLI](https://github.com/mermaidjs/mermaid.cli)
+- [mermaid live editor](https://github.com/mermaidjs/mermaid-live-editor)
+- [mermaid webpack demo](https://github.com/mermaidjs/mermaid-webpack-demo)
+- [mermaid Parcel demo](https://github.com/mermaidjs/mermaid-parcel-demo)
+
+## Request for assistance
+
+Things are piling up and I have a hard time keeping up. To remedy this
+it would be great if we could form a core team of developers to cooperate
+with the future development of mermaid.
+
+As part of this team you would get write access to the repository and would
+represent the project when answering questions and issues.
+
+Together we could continue the work with things like:
+
+- Adding more types of diagrams like mindmaps, ert diagrams, etc.
+- Improving existing diagrams
+
+Don't hesitate to contact me if you want to get involved.
+
+## For contributors
+
+### Setup
+
+```
+yarn install
+```
+
+### Build
+
+```
+yarn build:watch
+```
+
+### Lint
+
+```
+yarn lint
+```
+
+We use [eslint](https://eslint.org/).
+We recommend you installing [editor plugins](https://eslint.org/docs/user-guide/integrations) so you can get real time lint result.
+
+### Test
+
+```
+yarn test
+```
+Manual test in browser: open `dist/index.html`
+
+### Release
+
+For those who have the permission to do so:
+
+Update version number in `package.json`.
+
+```
+npm publish
+```
+
+Command above generates files into the `dist` folder and publishes them to npmjs.org.
+
+## Credits
+
+Many thanks to the [d3](http://d3js.org/) and [dagre-d3](https://github.com/cpettitt/dagre-d3) projects for providing the graphical layout and drawing libraries!
+
+Thanks also to the [js-sequence-diagram](http://bramp.github.io/js-sequence-diagrams) project for usage of the grammar for the sequence diagrams. Thanks to Jessica Peter for inspiration and starting point for gantt rendering.
+
+_Mermaid was created by Knut Sveidqvist for easier documentation._
+
+_[Tyler Long](https://github.com/tylerlong) has became a collaborator since April 2017._
+
+Here is the full list of the projects [contributors](https://github.com/knsv/mermaid/graphs/contributors).

From d28e3374c77798b1f83330c977265311bd393ce6 Mon Sep 17 00:00:00 2001
From: NeilCuzon <elancuzon@gmail.com>
Date: Mon, 9 Mar 2020 23:23:44 -0700
Subject: [PATCH 20/34] Revert "Update README.md"

This reverts commit 71cfec91afbfdf1223a28d029a82568c841201df.
---
 README.md | 344 +++++++++++++++++++++++++-----------------------------
 1 file changed, 157 insertions(+), 187 deletions(-)

diff --git a/README.md b/README.md
index 791ac115c..781cee7e1 100644
--- a/README.md
+++ b/README.md
@@ -1,29 +1,26 @@
+<!-- <Remove this in the future> -->
+| :mega: :mega: :mega: |
+| :----: |
+| * If you're upgrading from a version __< v8.2.0__, there are [non-backward-compatible changes](http://mermaid-js.github.io/mermaid/#/usage?id=to-enable-click-event-and-tags-in-nodes) related to security issues. Default behaviour of the library might have changed for your implementation.|
+<!-- </Remove this in the future> -->
 
-# Mermaid
+# mermaid [![Build Status](https://travis-ci.org/mermaid-js/mermaid.svg?branch=master)](https://travis-ci.org/mermaid-js/mermaid) [![NPM](https://img.shields.io/npm/v/mermaid)](https://www.npmjs.com/package/mermaid) [![Coverage Status](https://coveralls.io/repos/github/mermaid-js/mermaid/badge.svg?branch=master)](https://coveralls.io/github/mermaid-js/mermaid?branch=master) [![Join our Slack!](https://img.shields.io/static/v1?message=join%20chat&color=9cf&logo=slack&label=slack)](https://join.slack.com/t/mermaid-talk/shared_invite/enQtNzc4NDIyNzk4OTAyLWVhYjQxOTI2OTg4YmE1ZmJkY2Y4MTU3ODliYmIwOTY3NDJlYjA0YjIyZTdkMDMyZTUwOGI0NjEzYmEwODcwOTE) [![This project is using Percy.io for visual regression testing.](https://percy.io/static/images/percy-badge.svg)](https://percy.io/Mermaid/mermaid)
 
-[![Build Status](https://travis-ci.org/mermaid-js/mermaid.svg?branch=master)](https://travis-ci.org/mermaid-js/mermaid)
-[![Coverage Status](https://coveralls.io/repos/github/knsv/mermaid/badge.svg?branch=master)](https://coveralls.io/github/knsv/mermaid?branch=master)
-[![Join the chat at https://gitter.im/knsv/mermaid](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/knsv/mermaid?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+<!-- <Main description> -->
+__mermaid is a Javascript based diagramming and charting tool. It generates diagrams flowcharts and more, using markdown-inspired text for ease and speed.__
 
-![banner](./img/header.png)
-# What is mermaid?
+Check out the list of [Integrations and Usages of Mermaid](https://github.com/mermaid-js/mermaid/blob/develop/docs/integrations.md)
 
-It is a simple markdown-inspired, script language for diagramming and charting that can be deployed via Javascipt.
+For more information and help in getting started, please view our [documentation](http://mermaid-js.github.io/mermaid/) and start simplifying yours. Alternatively, you can also play with our [live editor](https://mermaidjs.github.io/mermaid-live-editor/).
+<!-- </Main description> --> 
 
-The reasoning behind it's inception was a need for simplified documentation and frustration with heavy and time consuming tools for explaining code, like Visio. 
-
-Thus mermaid was created to make the process of diagramming and charting, as simple and as close to markdown, as possible.
-
-Check out the list of [Integrations and Usages of Mermaid](./integrations.md)
-For the uninitiated, you can also  try out our [live editor](https://mermaid-js.github.io/mermaid-live-editor/) and look at our [documentation](https://mermaid-js.github.io/mermaid/#/n00b-overview) for a deeper understanding of the tool itself, more importantly don't forget to have fun. 
-
-**Mermaid was nominated and won the JS Open Source Awards (2019) in the category "The most exciting use of technology"!!! Thanks to all involved, people committing pull requests, people answering questions and special thanks to Tyler Long who is helping me maintain the project.**
+:trophy: **Mermaid was nominated and won the [JS Open Source Awards (2019)](https://osawards.com/javascript/#nominees) in the category "The most exciting use of technology"!!! Thanks to all involved, people committing pull requests, people answering questions and special thanks to Tyler Long who is helping me maintain the project.**
 
 ## New diagrams in 8.4
 
 With version 8.4 class diagrams have got some new features, bug fixes and documentation. Another new feature in 8.4 is the new diagram type, state diagrams.
 
-![Image show the two new diagram types](./img/new-diagrams.png)
+![Image show the two new diagram types](.docs/img/new-diagrams.png)
 
 ## Special note regarding version 8.2
 
@@ -44,64 +41,82 @@ mermaidAPI.initialize({
 });
 ```
 
-**🖖 Keep a steady pulse: mermaid needs more Collaborators [#866](https://github.com/k3nsv/mermaid/issues/866)**
+For more information and help in getting started, please view our [documentation](http://mermaid-js.github.io/mermaid/) and start simplifying yours. Play with our [live editor](https://mermaidjs.github.io/mermaid-live-editor/) or jump straight to the [installation and usage](http://mermaid-js.github.io/mermaid/#/usage).
+<!-- </Main description> -->
 
-## The following are examples of Diagrams that mermaid can make:
-
-### Flowchart
-
-```
-graph TD;
-    A-->B;
-    A-->C;
-    B-->D;
-    C-->D;
-```
-
-![Flowchart](./img/flow.png)
-
-### Sequence diagram
-
-```
+__The following are some examples of the diagrams, charts and graphs that can be made using mermaid and the Markdown-inspired text specific to it. Click here jump into the [text syntax](https://mermaid-js.github.io/mermaid/#/n00b-syntaxReference).__
+<table>
+<!-- <Flowchart> -->
+<tr><td colspan=2 align="center">
+    <b>Flow</b></br>
+    [<a href="http://mermaid-js.github.io/mermaid/#/flowchart">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZ3JhcGggVERcbiAgICBBW0hhcmRdIC0tPnxUZXh0fCBCKFJvdW5kKVxuICAgIEIgLS0-IEN7RGVjaXNpb259XG4gICAgQyAtLT58T25lfCBEW1Jlc3VsdCAxXVxuICAgIEMgLS0-fFR3b3wgRVtSZXN1bHQgMl0iLCJtZXJtYWlkIjp7InRoZW1lIjoiZGVmYXVsdCJ9fQ">live editor</a>]
+</td></tr>
+<tr>
+    <td><pre>
+graph TD
+A[Hard] -->|Text| B(Round)
+B --> C{Decision}
+C -->|One| D[Result 1]
+C -->|Two| E[Result 2]
+    </pre></td>
+    <td align="center">
+        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-flow.png" />
+    </td>
+</tr>
+<!-- </Flowchart> -->
+<!-- <Sequence> -->
+<tr><td colspan=2 align="center">
+    <b>Sequence</b><br />
+    [<a href="http://mermaid-js.github.io/mermaid/#/sequenceDiagram">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoic2VxdWVuY2VEaWFncmFtXG5BbGljZS0-PkpvaG46IEhlbGxvIEpvaG4sIGhvdyBhcmUgeW91P1xubG9vcCBIZWFsdGhjaGVja1xuICAgIEpvaG4tPj5Kb2huOiBGaWdodCBhZ2FpbnN0IGh5cG9jaG9uZHJpYVxuZW5kXG5Ob3RlIHJpZ2h0IG9mIEpvaG46IFJhdGlvbmFsIHRob3VnaHRzIVxuSm9obi0tPj5BbGljZTogR3JlYXQhXG5Kb2huLT4-Qm9iOiBIb3cgYWJvdXQgeW91P1xuQm9iLS0-PkpvaG46IEpvbGx5IGdvb2QhIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
+</td></tr>
+<tr>
+    <td><pre>
 sequenceDiagram
-    participant Alice
-    participant Bob
-    Alice->>John: Hello John, how are you?
-    loop Healthcheck
-        John->>John: Fight against hypochondria
-    end
-    Note right of John: Rational thoughts <br/>prevail!
-    John-->>Alice: Great!
-    John->>Bob: How about you?
-    Bob-->>John: Jolly good!
-```
-
-![Sequence diagram](./img/sequence.png)
-
-### Gantt diagram
-
-```
+Alice->>John: Hello John, how are you?
+loop Healthcheck
+    John->>John: Fight against hypochondria
+end
+Note right of John: Rational thoughts!
+John-->>Alice: Great!
+John->>Bob: How about you?
+Bob-->>John: Jolly good!
+    </pre></td>
+    <td align="center">
+        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-sequence.png" />
+    </td>
+</tr>
+<!-- </Sequence> -->
+<!-- <Gantt> -->
+<tr><td colspan=2 align="center">
+    <b>Gantt</b><br />
+    [<a href="http://mermaid-js.github.io/mermaid/#/gantt">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZ2FudHRcbnNlY3Rpb24gU2VjdGlvblxuQ29tcGxldGVkIDpkb25lLCAgICBkZXMxLCAyMDE0LTAxLTA2LDIwMTQtMDEtMDhcbkFjdGl2ZSAgICAgICAgOmFjdGl2ZSwgIGRlczIsIDIwMTQtMDEtMDcsIDNkXG5QYXJhbGxlbCAxICAgOiAgICAgICAgIGRlczMsIGFmdGVyIGRlczEsIDFkXG5QYXJhbGxlbCAyICAgOiAgICAgICAgIGRlczQsIGFmdGVyIGRlczEsIDFkXG5QYXJhbGxlbCAzICAgOiAgICAgICAgIGRlczUsIGFmdGVyIGRlczMsIDFkXG5QYXJhbGxlbCA0ICAgOiAgICAgICAgIGRlczYsIGFmdGVyIGRlczQsIDFkIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
+</td></tr>
+<tr>
+    <td><pre>
 gantt
-dateFormat  YYYY-MM-DD
-title Adding GANTT diagram to mermaid
-excludes weekdays 2014-01-10
-section A section
-Completed task            :done,    des1, 2014-01-06,2014-01-08
-Active task               :active,  des2, 2014-01-09, 3d
-Future task               :         des3, after des2, 5d
-Future task2               :         des4, after des3, 5d
-```
-
-![Gantt diagram](./img/gantt.png)
-
-### Class diagram - :exclamation: experimental
-
-```
+section Section
+Completed :done,    des1, 2014-01-06,2014-01-08
+Active        :active,  des2, 2014-01-07, 3d
+Parallel 1   :         des3, after des1, 1d
+Parallel 2   :         des4, after des1, 1d
+Parallel 3   :         des5, after des3, 1d
+Parallel 4   :         des6, after des4, 1d
+    </pre></td>
+    <td align="center">
+        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-gantt.png" />
+    </td>
+</tr>
+<!-- </Gantt> -->
+<!-- <Class> -->
+<tr><td colspan=2 align="center">
+    <b>Class</b><br />
+    [<a href="http://mermaid-js.github.io/mermaid/#/classDiagram">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiY2xhc3NEaWFncmFtXG5DbGFzczAxIDx8LS0gQXZlcnlMb25nQ2xhc3MgOiBDb29sXG48PGludGVyZmFjZT4-IENsYXNzMDFcbkNsYXNzMDkgLS0-IEMyIDogV2hlcmUgYW0gaT9cbkNsYXNzMDkgLS0qIEMzXG5DbGFzczA5IC0tfD4gQ2xhc3MwN1xuQ2xhc3MwNyA6IGVxdWFscygpXG5DbGFzczA3IDogT2JqZWN0W10gZWxlbWVudERhdGFcbkNsYXNzMDEgOiBzaXplKClcbkNsYXNzMDEgOiBpbnQgY2hpbXBcbkNsYXNzMDEgOiBpbnQgZ29yaWxsYVxuY2xhc3MgQ2xhc3MxMCB7XG4gID4-c2VydmljZT4-XG4gIGludCBpZFxuICBzaXplKClcbn0iLCJtZXJtYWlkIjp7InRoZW1lIjoiZGVmYXVsdCJ9fQ">live editor</a>]
+</td></tr>
+<tr>
+    <td><pre>
 classDiagram
-Class01 <|-- AveryLongClass : Cool
-Class03 *-- Class04
-Class05 o-- Class06
-Class07 .. Class08
+Class01 &lt;|-- AveryLongClass : Cool
+&lt;&lt;interface>> Class01
 Class09 --> C2 : Where am i?
 Class09 --* C3
 Class09 --|> Class07
@@ -110,129 +125,84 @@ Class07 : Object[] elementData
 Class01 : size()
 Class01 : int chimp
 Class01 : int gorilla
-Class08 <--> C2: Cool label
-```
-
-![Class diagram](./img/class.png)
-
-### Git graph - :exclamation: experimental
-
-```
-gitGraph:
-options
-{
-    "nodeSpacing": 150,
-    "nodeRadius": 10
+class Class10 {
+  &lt;&lt;service>>
+  int id
+  size()
 }
-end
-commit
-branch newbranch
-checkout newbranch
-commit
-commit
-checkout master
-commit
-commit
-merge newbranch
-```
+</pre></td>
+    <td align="center">
+        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-class.png" />
+    </td>
+</tr>
+<!-- </Class> -->
+<!-- <State> -->
+<tr><td colspan=2 align="center">
+    <b>State</b><br />
+    [<a href="http://mermaid-js.github.io/mermaid/#/stateDiagram">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoic3RhdGVEaWFncmFtXG4gICAgWypdIC0tPiBTdGlsbFxuICAgIFN0aWxsIC0tPiBbKl1cbiAgICBTdGlsbCAtLT4gTW92aW5nXG4gICAgTW92aW5nIC0tPiBTdGlsbFxuICAgIE1vdmluZyAtLT4gQ3Jhc2hcbiAgICBDcmFzaCAtLT4gWypdIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
+</td></tr>
+<tr>
+    <td><pre>
+stateDiagram
+[*] --> Still
+Still --> [*]
+Still --> Moving
+Moving --> Still
+Moving --> Crash
+Crash --> [*]
+</pre></td>
+    <td align="center">
+        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-state.png" />
+    </td>
+</tr>
+<!-- </State> -->
+<!-- <Pie> -->
+<tr><td colspan=2 align="center">
+    <b>Pie</b><br />
+    [<a href="http://mermaid-js.github.io/mermaid/#/pie">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoicGllXG5cIkRvZ3NcIiA6IDQyLjk2XG5cIkNhdHNcIiA6IDUwLjA1XG5cIlJhdHNcIiA6IDEwLjAxIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
+</td></tr>
+<tr>
+    <td><pre>
+pie
+"Dogs" : 386
+"Cats" : 85
+"Rats" : 15 
+</pre></td>
+    <td align="center">
+        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-pie.png" />
+    </td>
+</tr>
+<!-- </Pie> -->
+<!-- <Git> -->
+<tr><td colspan=2 align="center">
+    <b>Git</b><br />
+    [experimental - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZ2l0R3JhcGg6XG5vcHRpb25zXG57XG4gICAgXCJub2RlU3BhY2luZ1wiOiAxNTAsXG4gICAgXCJub2RlUmFkaXVzXCI6IDEwXG59XG5lbmRcbmNvbW1pdFxuYnJhbmNoIG5ld2JyYW5jaFxuY2hlY2tvdXQgbmV3YnJhbmNoXG5jb21taXRcbmNvbW1pdFxuY2hlY2tvdXQgbWFzdGVyXG5jb21taXRcbmNvbW1pdFxubWVyZ2UgbmV3YnJhbmNoXG4iLCJtZXJtYWlkIjp7InRoZW1lIjoiZGVmYXVsdCJ9fQ">live editor</a>]
+</td></tr>
+<tr>
+    <td colspan="2" align="center"><i>Coming soon!</i></td>
+</tr>
+<!-- </Git> -->
+</table>
 
-![Git graph](./img/git.png)
+## Related projects 
 
-## Installation
+- [Command Line Interface](https://github.com/mermaid-js/mermaid.cli)
+- [Live Editor](https://github.com/mermaid-js/mermaid-live-editor)
 
-### CDN
+# Contributors [![Help wanted](https://img.shields.io/github/labels/mermaid-js/mermaid/Help%20wanted!)](https://github.com/mermaid-js/mermaid/issues?q=is%3Aissue+is%3Aopen+label%3A%22Help+wanted%21%22) [![Contributors](https://img.shields.io/github/contributors/mermaid-js/mermaid)](https://github.com/mermaid-js/mermaid/graphs/contributors) [![Commits](https://img.shields.io/github/commit-activity/m/mermaid-js/mermaid)](https://github.com/mermaid-js/mermaid/graphs/contributors)
 
-```
-https://unpkg.com/mermaid@<version>/dist/
-```
+Mermaid is a growing community and is always accepting new contributors. There's a lot of different ways to help out and we're always looking for extra hands! Look at [this issue](https://github.com/mermaid-js/mermaid/issues/866) if you want to know where to start helping out.
 
-Replace `<version>` with expected version number.
+Detailed information about how to contribute can be found in the [contribution guide](CONTRIBUTING.md)
 
-Example: https://unpkg.com/mermaid@7.1.0/dist/
+# Appreciation
+A quick note from Knut Sveidqvist:
+>*Many thanks to the [d3](http://d3js.org/) and [dagre-d3](https://github.com/cpettitt/dagre-d3) projects for providing the graphical layout and drawing libraries!*
+>*Thanks also to the [js-sequence-diagram](http://bramp.github.io/js-sequence-diagrams) project for usage of the grammar for the sequence diagrams. Thanks to Jessica Peter for inspiration and starting point for gantt rendering.*
+>*Thank you to [Tyler Long](https://github.com/tylerlong) who has been a collaborator since April 2017.*
+>
+>*Thank you to the ever-growing list of [contributors](https://github.com/knsv/mermaid/graphs/contributors) that brought the project this far!*
 
-### Node.js
+---
 
-```
-yarn add mermaid
-```
-
-## Documentation
-
-https://mermaidjs.github.io
-
-## Sibling projects
-
-- [mermaid CLI](https://github.com/mermaidjs/mermaid.cli)
-- [mermaid live editor](https://github.com/mermaidjs/mermaid-live-editor)
-- [mermaid webpack demo](https://github.com/mermaidjs/mermaid-webpack-demo)
-- [mermaid Parcel demo](https://github.com/mermaidjs/mermaid-parcel-demo)
-
-## Request for assistance
-
-Things are piling up and I have a hard time keeping up. To remedy this
-it would be great if we could form a core team of developers to cooperate
-with the future development of mermaid.
-
-As part of this team you would get write access to the repository and would
-represent the project when answering questions and issues.
-
-Together we could continue the work with things like:
-
-- Adding more types of diagrams like mindmaps, ert diagrams, etc.
-- Improving existing diagrams
-
-Don't hesitate to contact me if you want to get involved.
-
-## For contributors
-
-### Setup
-
-```
-yarn install
-```
-
-### Build
-
-```
-yarn build:watch
-```
-
-### Lint
-
-```
-yarn lint
-```
-
-We use [eslint](https://eslint.org/).
-We recommend you installing [editor plugins](https://eslint.org/docs/user-guide/integrations) so you can get real time lint result.
-
-### Test
-
-```
-yarn test
-```
-Manual test in browser: open `dist/index.html`
-
-### Release
-
-For those who have the permission to do so:
-
-Update version number in `package.json`.
-
-```
-npm publish
-```
-
-Command above generates files into the `dist` folder and publishes them to npmjs.org.
-
-## Credits
-
-Many thanks to the [d3](http://d3js.org/) and [dagre-d3](https://github.com/cpettitt/dagre-d3) projects for providing the graphical layout and drawing libraries!
-
-Thanks also to the [js-sequence-diagram](http://bramp.github.io/js-sequence-diagrams) project for usage of the grammar for the sequence diagrams. Thanks to Jessica Peter for inspiration and starting point for gantt rendering.
-
-_Mermaid was created by Knut Sveidqvist for easier documentation._
-
-_[Tyler Long](https://github.com/tylerlong) has became a collaborator since April 2017._
-
-Here is the full list of the projects [contributors](https://github.com/knsv/mermaid/graphs/contributors).
+*Mermaid was created by Knut Sveidqvist for easier documentation.*

From a8eeb7f76a082097b6c14a504a9ae9d6095cc780 Mon Sep 17 00:00:00 2001
From: NeilCuzon <elancuzon@gmail.com>
Date: Mon, 9 Mar 2020 23:25:19 -0700
Subject: [PATCH 21/34] Revert "Revert "Delete README.md""

This reverts commit c3e9ae0ca055eef0f1f944f616dd34bc7ae445f9.
---
 docs/README.md | 239 -------------------------------------------------
 1 file changed, 239 deletions(-)
 delete mode 100644 docs/README.md

diff --git a/docs/README.md b/docs/README.md
deleted file mode 100644
index 4e3f71c02..000000000
--- a/docs/README.md
+++ /dev/null
@@ -1,239 +0,0 @@
-# Mermaid
-
-[![Build Status](https://travis-ci.org/mermaid-js/mermaid.svg?branch=master)](https://travis-ci.org/mermaid-js/mermaid)
-[![Coverage Status](https://coveralls.io/repos/github/knsv/mermaid/badge.svg?branch=master)](https://coveralls.io/github/knsv/mermaid?branch=master)
-[![Join the chat at https://gitter.im/knsv/mermaid](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/knsv/mermaid?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
-
-![banner](./img/header.png)
-# What is mermaid?
-
-It is a simple markdown-inspired, script language for diagramming and charting that can be deployed via Javascipt.
-
-The reasoning behind it's inception was a need for simplified documentation and frustration with heavy and time consuming tools for explaining code, like Visio. 
-
-Thus mermaid was created to make the process of diagramming and charting, as simple and as close to markdown, as possible.
-
-Check out the list of [Integrations and Usages of Mermaid](./integrations.md)
-For the uninitiated, you can also  try out our [live editor](https://mermaid-js.github.io/mermaid-live-editor/) and look at our [documentation](https://mermaid-js.github.io/mermaid/#/n00b-overview) for a deeper understanding of the tool itself, more importantly don't forget to have fun. 
-
-**Mermaid was nominated and won the JS Open Source Awards (2019) in the category "The most exciting use of technology"!!! Thanks to all involved, people committing pull requests, people answering questions and special thanks to Tyler Long who is helping me maintain the project.**
-
-## New diagrams in 8.4
-
-With version 8.4 class diagrams have got some new features, bug fixes and documentation. Another new feature in 8.4 is the new diagram type, state diagrams.
-
-![Image show the two new diagram types](./img/new-diagrams.png)
-
-## Special note regarding version 8.2
-
-In version 8.2 a security improvement was introduced. A securityLevel configuration was introduced which sets the level of trust to be used on the parsed diagrams.
-
-- **true**: (default) tags in text are encoded, click functionality is disabled
-- false: tags in text are allowed, click functionality is enabled
-
-Closed issues:
-
-⚠️ **Note** : This changes the default behaviour of mermaid so that after upgrade to 8.2, if the securityLevel is not configured, tags in flowcharts are encoded as tags and clicking is prohibited.
-
-If your application is taking resposibility for the diagram source security you can set the securityLevel accordingly. By doing this clicks and tags are again allowed.
-
-```javascript
-mermaidAPI.initialize({
-    securityLevel: 'loose'
-});
-```
-
-**🖖 Keep a steady pulse: mermaid needs more Collaborators [#866](https://github.com/k3nsv/mermaid/issues/866)**
-
-## The following are examples of Diagrams that mermaid can make:
-
-### Flowchart
-
-```
-graph TD;
-    A-->B;
-    A-->C;
-    B-->D;
-    C-->D;
-```
-
-![Flowchart](./img/flow.png)
-
-### Sequence diagram
-
-```
-sequenceDiagram
-    participant Alice
-    participant Bob
-    Alice->>John: Hello John, how are you?
-    loop Healthcheck
-        John->>John: Fight against hypochondria
-    end
-    Note right of John: Rational thoughts <br/>prevail!
-    John-->>Alice: Great!
-    John->>Bob: How about you?
-    Bob-->>John: Jolly good!
-```
-
-![Sequence diagram](./img/sequence.png)
-
-### Gantt diagram
-
-```
-gantt
-dateFormat  YYYY-MM-DD
-title Adding GANTT diagram to mermaid
-excludes weekdays 2014-01-10
-
-section A section
-Completed task            :done,    des1, 2014-01-06,2014-01-08
-Active task               :active,  des2, 2014-01-09, 3d
-Future task               :         des3, after des2, 5d
-Future task2               :         des4, after des3, 5d
-```
-
-![Gantt diagram](./img/gantt.png)
-
-### Class diagram - :exclamation: experimental
-
-```
-classDiagram
-Class01 <|-- AveryLongClass : Cool
-Class03 *-- Class04
-Class05 o-- Class06
-Class07 .. Class08
-Class09 --> C2 : Where am i?
-Class09 --* C3
-Class09 --|> Class07
-Class07 : equals()
-Class07 : Object[] elementData
-Class01 : size()
-Class01 : int chimp
-Class01 : int gorilla
-Class08 <--> C2: Cool label
-```
-
-![Class diagram](./img/class.png)
-
-### Git graph - :exclamation: experimental
-
-```
-gitGraph:
-options
-{
-    "nodeSpacing": 150,
-    "nodeRadius": 10
-}
-end
-commit
-branch newbranch
-checkout newbranch
-commit
-commit
-checkout master
-commit
-commit
-merge newbranch
-
-```
-
-![Git graph](./img/git.png)
-
-## Installation
-
-### CDN
-
-```
-https://unpkg.com/mermaid@<version>/dist/
-```
-
-Replace `<version>` with expected version number.
-
-Example: https://unpkg.com/mermaid@7.1.0/dist/
-
-### Node.js
-
-```
-yarn add mermaid
-```
-
-## Documentation
-
-https://mermaidjs.github.io
-
-## Sibling projects
-
-- [mermaid CLI](https://github.com/mermaidjs/mermaid.cli)
-- [mermaid live editor](https://github.com/mermaidjs/mermaid-live-editor)
-- [mermaid webpack demo](https://github.com/mermaidjs/mermaid-webpack-demo)
-- [mermaid Parcel demo](https://github.com/mermaidjs/mermaid-parcel-demo)
-
-## Request for assistance
-
-Things are piling up and I have a hard time keeping up. To remedy this
-it would be great if we could form a core team of developers to cooperate
-with the future development of mermaid.
-
-As part of this team you would get write access to the repository and would
-represent the project when answering questions and issues.
-
-Together we could continue the work with things like:
-
-- Adding more types of diagrams like mindmaps, ert diagrams, etc.
-- Improving existing diagrams
-
-Don't hesitate to contact me if you want to get involved.
-
-## For contributors
-
-### Setup
-
-```
-yarn install
-```
-
-### Build
-
-```
-yarn build:watch
-```
-
-### Lint
-
-```
-yarn lint
-```
-
-We use [eslint](https://eslint.org/).
-We recommend you installing [editor plugins](https://eslint.org/docs/user-guide/integrations) so you can get real time lint result.
-
-### Test
-
-```
-yarn test
-```
-Manual test in browser: open `dist/index.html`
-
-### Release
-
-For those who have the permission to do so:
-
-Update version number in `package.json`.
-
-```
-npm publish
-```
-
-Command above generates files into the `dist` folder and publishes them to npmjs.org.
-
-## Credits
-
-Many thanks to the [d3](http://d3js.org/) and [dagre-d3](https://github.com/cpettitt/dagre-d3) projects for providing the graphical layout and drawing libraries!
-
-Thanks also to the [js-sequence-diagram](http://bramp.github.io/js-sequence-diagrams) project for usage of the grammar for the sequence diagrams. Thanks to Jessica Peter for inspiration and starting point for gantt rendering.
-
-_Mermaid was created by Knut Sveidqvist for easier documentation._
-
-_[Tyler Long](https://github.com/tylerlong) has became a collaborator since April 2017._
-
-Here is the full list of the projects [contributors](https://github.com/knsv/mermaid/graphs/contributors).

From c598fd9ec4a14f38c789f741232f6d40fdb031b0 Mon Sep 17 00:00:00 2001
From: NeilCuzon <elancuzon@gmail.com>
Date: Mon, 9 Mar 2020 23:25:24 -0700
Subject: [PATCH 22/34] Revert "Revert "Update README.md""

This reverts commit d28e3374c77798b1f83330c977265311bd393ce6.
---
 README.md | 344 +++++++++++++++++++++++++++++-------------------------
 1 file changed, 187 insertions(+), 157 deletions(-)

diff --git a/README.md b/README.md
index 781cee7e1..791ac115c 100644
--- a/README.md
+++ b/README.md
@@ -1,26 +1,29 @@
-<!-- <Remove this in the future> -->
-| :mega: :mega: :mega: |
-| :----: |
-| * If you're upgrading from a version __< v8.2.0__, there are [non-backward-compatible changes](http://mermaid-js.github.io/mermaid/#/usage?id=to-enable-click-event-and-tags-in-nodes) related to security issues. Default behaviour of the library might have changed for your implementation.|
-<!-- </Remove this in the future> -->
 
-# mermaid [![Build Status](https://travis-ci.org/mermaid-js/mermaid.svg?branch=master)](https://travis-ci.org/mermaid-js/mermaid) [![NPM](https://img.shields.io/npm/v/mermaid)](https://www.npmjs.com/package/mermaid) [![Coverage Status](https://coveralls.io/repos/github/mermaid-js/mermaid/badge.svg?branch=master)](https://coveralls.io/github/mermaid-js/mermaid?branch=master) [![Join our Slack!](https://img.shields.io/static/v1?message=join%20chat&color=9cf&logo=slack&label=slack)](https://join.slack.com/t/mermaid-talk/shared_invite/enQtNzc4NDIyNzk4OTAyLWVhYjQxOTI2OTg4YmE1ZmJkY2Y4MTU3ODliYmIwOTY3NDJlYjA0YjIyZTdkMDMyZTUwOGI0NjEzYmEwODcwOTE) [![This project is using Percy.io for visual regression testing.](https://percy.io/static/images/percy-badge.svg)](https://percy.io/Mermaid/mermaid)
+# Mermaid
 
-<!-- <Main description> -->
-__mermaid is a Javascript based diagramming and charting tool. It generates diagrams flowcharts and more, using markdown-inspired text for ease and speed.__
+[![Build Status](https://travis-ci.org/mermaid-js/mermaid.svg?branch=master)](https://travis-ci.org/mermaid-js/mermaid)
+[![Coverage Status](https://coveralls.io/repos/github/knsv/mermaid/badge.svg?branch=master)](https://coveralls.io/github/knsv/mermaid?branch=master)
+[![Join the chat at https://gitter.im/knsv/mermaid](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/knsv/mermaid?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
-Check out the list of [Integrations and Usages of Mermaid](https://github.com/mermaid-js/mermaid/blob/develop/docs/integrations.md)
+![banner](./img/header.png)
+# What is mermaid?
 
-For more information and help in getting started, please view our [documentation](http://mermaid-js.github.io/mermaid/) and start simplifying yours. Alternatively, you can also play with our [live editor](https://mermaidjs.github.io/mermaid-live-editor/).
-<!-- </Main description> --> 
+It is a simple markdown-inspired, script language for diagramming and charting that can be deployed via Javascipt.
 
-:trophy: **Mermaid was nominated and won the [JS Open Source Awards (2019)](https://osawards.com/javascript/#nominees) in the category "The most exciting use of technology"!!! Thanks to all involved, people committing pull requests, people answering questions and special thanks to Tyler Long who is helping me maintain the project.**
+The reasoning behind it's inception was a need for simplified documentation and frustration with heavy and time consuming tools for explaining code, like Visio. 
+
+Thus mermaid was created to make the process of diagramming and charting, as simple and as close to markdown, as possible.
+
+Check out the list of [Integrations and Usages of Mermaid](./integrations.md)
+For the uninitiated, you can also  try out our [live editor](https://mermaid-js.github.io/mermaid-live-editor/) and look at our [documentation](https://mermaid-js.github.io/mermaid/#/n00b-overview) for a deeper understanding of the tool itself, more importantly don't forget to have fun. 
+
+**Mermaid was nominated and won the JS Open Source Awards (2019) in the category "The most exciting use of technology"!!! Thanks to all involved, people committing pull requests, people answering questions and special thanks to Tyler Long who is helping me maintain the project.**
 
 ## New diagrams in 8.4
 
 With version 8.4 class diagrams have got some new features, bug fixes and documentation. Another new feature in 8.4 is the new diagram type, state diagrams.
 
-![Image show the two new diagram types](.docs/img/new-diagrams.png)
+![Image show the two new diagram types](./img/new-diagrams.png)
 
 ## Special note regarding version 8.2
 
@@ -41,82 +44,64 @@ mermaidAPI.initialize({
 });
 ```
 
-For more information and help in getting started, please view our [documentation](http://mermaid-js.github.io/mermaid/) and start simplifying yours. Play with our [live editor](https://mermaidjs.github.io/mermaid-live-editor/) or jump straight to the [installation and usage](http://mermaid-js.github.io/mermaid/#/usage).
-<!-- </Main description> -->
+**🖖 Keep a steady pulse: mermaid needs more Collaborators [#866](https://github.com/k3nsv/mermaid/issues/866)**
 
-__The following are some examples of the diagrams, charts and graphs that can be made using mermaid and the Markdown-inspired text specific to it. Click here jump into the [text syntax](https://mermaid-js.github.io/mermaid/#/n00b-syntaxReference).__
-<table>
-<!-- <Flowchart> -->
-<tr><td colspan=2 align="center">
-    <b>Flow</b></br>
-    [<a href="http://mermaid-js.github.io/mermaid/#/flowchart">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZ3JhcGggVERcbiAgICBBW0hhcmRdIC0tPnxUZXh0fCBCKFJvdW5kKVxuICAgIEIgLS0-IEN7RGVjaXNpb259XG4gICAgQyAtLT58T25lfCBEW1Jlc3VsdCAxXVxuICAgIEMgLS0-fFR3b3wgRVtSZXN1bHQgMl0iLCJtZXJtYWlkIjp7InRoZW1lIjoiZGVmYXVsdCJ9fQ">live editor</a>]
-</td></tr>
-<tr>
-    <td><pre>
-graph TD
-A[Hard] -->|Text| B(Round)
-B --> C{Decision}
-C -->|One| D[Result 1]
-C -->|Two| E[Result 2]
-    </pre></td>
-    <td align="center">
-        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-flow.png" />
-    </td>
-</tr>
-<!-- </Flowchart> -->
-<!-- <Sequence> -->
-<tr><td colspan=2 align="center">
-    <b>Sequence</b><br />
-    [<a href="http://mermaid-js.github.io/mermaid/#/sequenceDiagram">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoic2VxdWVuY2VEaWFncmFtXG5BbGljZS0-PkpvaG46IEhlbGxvIEpvaG4sIGhvdyBhcmUgeW91P1xubG9vcCBIZWFsdGhjaGVja1xuICAgIEpvaG4tPj5Kb2huOiBGaWdodCBhZ2FpbnN0IGh5cG9jaG9uZHJpYVxuZW5kXG5Ob3RlIHJpZ2h0IG9mIEpvaG46IFJhdGlvbmFsIHRob3VnaHRzIVxuSm9obi0tPj5BbGljZTogR3JlYXQhXG5Kb2huLT4-Qm9iOiBIb3cgYWJvdXQgeW91P1xuQm9iLS0-PkpvaG46IEpvbGx5IGdvb2QhIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
-</td></tr>
-<tr>
-    <td><pre>
+## The following are examples of Diagrams that mermaid can make:
+
+### Flowchart
+
+```
+graph TD;
+    A-->B;
+    A-->C;
+    B-->D;
+    C-->D;
+```
+
+![Flowchart](./img/flow.png)
+
+### Sequence diagram
+
+```
 sequenceDiagram
-Alice->>John: Hello John, how are you?
-loop Healthcheck
-    John->>John: Fight against hypochondria
-end
-Note right of John: Rational thoughts!
-John-->>Alice: Great!
-John->>Bob: How about you?
-Bob-->>John: Jolly good!
-    </pre></td>
-    <td align="center">
-        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-sequence.png" />
-    </td>
-</tr>
-<!-- </Sequence> -->
-<!-- <Gantt> -->
-<tr><td colspan=2 align="center">
-    <b>Gantt</b><br />
-    [<a href="http://mermaid-js.github.io/mermaid/#/gantt">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZ2FudHRcbnNlY3Rpb24gU2VjdGlvblxuQ29tcGxldGVkIDpkb25lLCAgICBkZXMxLCAyMDE0LTAxLTA2LDIwMTQtMDEtMDhcbkFjdGl2ZSAgICAgICAgOmFjdGl2ZSwgIGRlczIsIDIwMTQtMDEtMDcsIDNkXG5QYXJhbGxlbCAxICAgOiAgICAgICAgIGRlczMsIGFmdGVyIGRlczEsIDFkXG5QYXJhbGxlbCAyICAgOiAgICAgICAgIGRlczQsIGFmdGVyIGRlczEsIDFkXG5QYXJhbGxlbCAzICAgOiAgICAgICAgIGRlczUsIGFmdGVyIGRlczMsIDFkXG5QYXJhbGxlbCA0ICAgOiAgICAgICAgIGRlczYsIGFmdGVyIGRlczQsIDFkIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
-</td></tr>
-<tr>
-    <td><pre>
+    participant Alice
+    participant Bob
+    Alice->>John: Hello John, how are you?
+    loop Healthcheck
+        John->>John: Fight against hypochondria
+    end
+    Note right of John: Rational thoughts <br/>prevail!
+    John-->>Alice: Great!
+    John->>Bob: How about you?
+    Bob-->>John: Jolly good!
+```
+
+![Sequence diagram](./img/sequence.png)
+
+### Gantt diagram
+
+```
 gantt
-section Section
-Completed :done,    des1, 2014-01-06,2014-01-08
-Active        :active,  des2, 2014-01-07, 3d
-Parallel 1   :         des3, after des1, 1d
-Parallel 2   :         des4, after des1, 1d
-Parallel 3   :         des5, after des3, 1d
-Parallel 4   :         des6, after des4, 1d
-    </pre></td>
-    <td align="center">
-        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-gantt.png" />
-    </td>
-</tr>
-<!-- </Gantt> -->
-<!-- <Class> -->
-<tr><td colspan=2 align="center">
-    <b>Class</b><br />
-    [<a href="http://mermaid-js.github.io/mermaid/#/classDiagram">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiY2xhc3NEaWFncmFtXG5DbGFzczAxIDx8LS0gQXZlcnlMb25nQ2xhc3MgOiBDb29sXG48PGludGVyZmFjZT4-IENsYXNzMDFcbkNsYXNzMDkgLS0-IEMyIDogV2hlcmUgYW0gaT9cbkNsYXNzMDkgLS0qIEMzXG5DbGFzczA5IC0tfD4gQ2xhc3MwN1xuQ2xhc3MwNyA6IGVxdWFscygpXG5DbGFzczA3IDogT2JqZWN0W10gZWxlbWVudERhdGFcbkNsYXNzMDEgOiBzaXplKClcbkNsYXNzMDEgOiBpbnQgY2hpbXBcbkNsYXNzMDEgOiBpbnQgZ29yaWxsYVxuY2xhc3MgQ2xhc3MxMCB7XG4gID4-c2VydmljZT4-XG4gIGludCBpZFxuICBzaXplKClcbn0iLCJtZXJtYWlkIjp7InRoZW1lIjoiZGVmYXVsdCJ9fQ">live editor</a>]
-</td></tr>
-<tr>
-    <td><pre>
+dateFormat  YYYY-MM-DD
+title Adding GANTT diagram to mermaid
+excludes weekdays 2014-01-10
+section A section
+Completed task            :done,    des1, 2014-01-06,2014-01-08
+Active task               :active,  des2, 2014-01-09, 3d
+Future task               :         des3, after des2, 5d
+Future task2               :         des4, after des3, 5d
+```
+
+![Gantt diagram](./img/gantt.png)
+
+### Class diagram - :exclamation: experimental
+
+```
 classDiagram
-Class01 &lt;|-- AveryLongClass : Cool
-&lt;&lt;interface>> Class01
+Class01 <|-- AveryLongClass : Cool
+Class03 *-- Class04
+Class05 o-- Class06
+Class07 .. Class08
 Class09 --> C2 : Where am i?
 Class09 --* C3
 Class09 --|> Class07
@@ -125,84 +110,129 @@ Class07 : Object[] elementData
 Class01 : size()
 Class01 : int chimp
 Class01 : int gorilla
-class Class10 {
-  &lt;&lt;service>>
-  int id
-  size()
+Class08 <--> C2: Cool label
+```
+
+![Class diagram](./img/class.png)
+
+### Git graph - :exclamation: experimental
+
+```
+gitGraph:
+options
+{
+    "nodeSpacing": 150,
+    "nodeRadius": 10
 }
-</pre></td>
-    <td align="center">
-        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-class.png" />
-    </td>
-</tr>
-<!-- </Class> -->
-<!-- <State> -->
-<tr><td colspan=2 align="center">
-    <b>State</b><br />
-    [<a href="http://mermaid-js.github.io/mermaid/#/stateDiagram">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoic3RhdGVEaWFncmFtXG4gICAgWypdIC0tPiBTdGlsbFxuICAgIFN0aWxsIC0tPiBbKl1cbiAgICBTdGlsbCAtLT4gTW92aW5nXG4gICAgTW92aW5nIC0tPiBTdGlsbFxuICAgIE1vdmluZyAtLT4gQ3Jhc2hcbiAgICBDcmFzaCAtLT4gWypdIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
-</td></tr>
-<tr>
-    <td><pre>
-stateDiagram
-[*] --> Still
-Still --> [*]
-Still --> Moving
-Moving --> Still
-Moving --> Crash
-Crash --> [*]
-</pre></td>
-    <td align="center">
-        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-state.png" />
-    </td>
-</tr>
-<!-- </State> -->
-<!-- <Pie> -->
-<tr><td colspan=2 align="center">
-    <b>Pie</b><br />
-    [<a href="http://mermaid-js.github.io/mermaid/#/pie">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoicGllXG5cIkRvZ3NcIiA6IDQyLjk2XG5cIkNhdHNcIiA6IDUwLjA1XG5cIlJhdHNcIiA6IDEwLjAxIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
-</td></tr>
-<tr>
-    <td><pre>
-pie
-"Dogs" : 386
-"Cats" : 85
-"Rats" : 15 
-</pre></td>
-    <td align="center">
-        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-pie.png" />
-    </td>
-</tr>
-<!-- </Pie> -->
-<!-- <Git> -->
-<tr><td colspan=2 align="center">
-    <b>Git</b><br />
-    [experimental - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZ2l0R3JhcGg6XG5vcHRpb25zXG57XG4gICAgXCJub2RlU3BhY2luZ1wiOiAxNTAsXG4gICAgXCJub2RlUmFkaXVzXCI6IDEwXG59XG5lbmRcbmNvbW1pdFxuYnJhbmNoIG5ld2JyYW5jaFxuY2hlY2tvdXQgbmV3YnJhbmNoXG5jb21taXRcbmNvbW1pdFxuY2hlY2tvdXQgbWFzdGVyXG5jb21taXRcbmNvbW1pdFxubWVyZ2UgbmV3YnJhbmNoXG4iLCJtZXJtYWlkIjp7InRoZW1lIjoiZGVmYXVsdCJ9fQ">live editor</a>]
-</td></tr>
-<tr>
-    <td colspan="2" align="center"><i>Coming soon!</i></td>
-</tr>
-<!-- </Git> -->
-</table>
+end
+commit
+branch newbranch
+checkout newbranch
+commit
+commit
+checkout master
+commit
+commit
+merge newbranch
+```
 
-## Related projects 
+![Git graph](./img/git.png)
 
-- [Command Line Interface](https://github.com/mermaid-js/mermaid.cli)
-- [Live Editor](https://github.com/mermaid-js/mermaid-live-editor)
+## Installation
 
-# Contributors [![Help wanted](https://img.shields.io/github/labels/mermaid-js/mermaid/Help%20wanted!)](https://github.com/mermaid-js/mermaid/issues?q=is%3Aissue+is%3Aopen+label%3A%22Help+wanted%21%22) [![Contributors](https://img.shields.io/github/contributors/mermaid-js/mermaid)](https://github.com/mermaid-js/mermaid/graphs/contributors) [![Commits](https://img.shields.io/github/commit-activity/m/mermaid-js/mermaid)](https://github.com/mermaid-js/mermaid/graphs/contributors)
+### CDN
 
-Mermaid is a growing community and is always accepting new contributors. There's a lot of different ways to help out and we're always looking for extra hands! Look at [this issue](https://github.com/mermaid-js/mermaid/issues/866) if you want to know where to start helping out.
+```
+https://unpkg.com/mermaid@<version>/dist/
+```
 
-Detailed information about how to contribute can be found in the [contribution guide](CONTRIBUTING.md)
+Replace `<version>` with expected version number.
 
-# Appreciation
-A quick note from Knut Sveidqvist:
->*Many thanks to the [d3](http://d3js.org/) and [dagre-d3](https://github.com/cpettitt/dagre-d3) projects for providing the graphical layout and drawing libraries!*
->*Thanks also to the [js-sequence-diagram](http://bramp.github.io/js-sequence-diagrams) project for usage of the grammar for the sequence diagrams. Thanks to Jessica Peter for inspiration and starting point for gantt rendering.*
->*Thank you to [Tyler Long](https://github.com/tylerlong) who has been a collaborator since April 2017.*
->
->*Thank you to the ever-growing list of [contributors](https://github.com/knsv/mermaid/graphs/contributors) that brought the project this far!*
+Example: https://unpkg.com/mermaid@7.1.0/dist/
 
----
+### Node.js
 
-*Mermaid was created by Knut Sveidqvist for easier documentation.*
+```
+yarn add mermaid
+```
+
+## Documentation
+
+https://mermaidjs.github.io
+
+## Sibling projects
+
+- [mermaid CLI](https://github.com/mermaidjs/mermaid.cli)
+- [mermaid live editor](https://github.com/mermaidjs/mermaid-live-editor)
+- [mermaid webpack demo](https://github.com/mermaidjs/mermaid-webpack-demo)
+- [mermaid Parcel demo](https://github.com/mermaidjs/mermaid-parcel-demo)
+
+## Request for assistance
+
+Things are piling up and I have a hard time keeping up. To remedy this
+it would be great if we could form a core team of developers to cooperate
+with the future development of mermaid.
+
+As part of this team you would get write access to the repository and would
+represent the project when answering questions and issues.
+
+Together we could continue the work with things like:
+
+- Adding more types of diagrams like mindmaps, ert diagrams, etc.
+- Improving existing diagrams
+
+Don't hesitate to contact me if you want to get involved.
+
+## For contributors
+
+### Setup
+
+```
+yarn install
+```
+
+### Build
+
+```
+yarn build:watch
+```
+
+### Lint
+
+```
+yarn lint
+```
+
+We use [eslint](https://eslint.org/).
+We recommend you installing [editor plugins](https://eslint.org/docs/user-guide/integrations) so you can get real time lint result.
+
+### Test
+
+```
+yarn test
+```
+Manual test in browser: open `dist/index.html`
+
+### Release
+
+For those who have the permission to do so:
+
+Update version number in `package.json`.
+
+```
+npm publish
+```
+
+Command above generates files into the `dist` folder and publishes them to npmjs.org.
+
+## Credits
+
+Many thanks to the [d3](http://d3js.org/) and [dagre-d3](https://github.com/cpettitt/dagre-d3) projects for providing the graphical layout and drawing libraries!
+
+Thanks also to the [js-sequence-diagram](http://bramp.github.io/js-sequence-diagrams) project for usage of the grammar for the sequence diagrams. Thanks to Jessica Peter for inspiration and starting point for gantt rendering.
+
+_Mermaid was created by Knut Sveidqvist for easier documentation._
+
+_[Tyler Long](https://github.com/tylerlong) has became a collaborator since April 2017._
+
+Here is the full list of the projects [contributors](https://github.com/knsv/mermaid/graphs/contributors).

From a414aa27b6d6bd2b483b00f122e6483991043f04 Mon Sep 17 00:00:00 2001
From: NeilCuzon <elancuzon@gmail.com>
Date: Mon, 9 Mar 2020 23:25:28 -0700
Subject: [PATCH 23/34] Revert "Revert "Revert "Update README.md"""

This reverts commit c598fd9ec4a14f38c789f741232f6d40fdb031b0.
---
 README.md | 344 +++++++++++++++++++++++++-----------------------------
 1 file changed, 157 insertions(+), 187 deletions(-)

diff --git a/README.md b/README.md
index 791ac115c..781cee7e1 100644
--- a/README.md
+++ b/README.md
@@ -1,29 +1,26 @@
+<!-- <Remove this in the future> -->
+| :mega: :mega: :mega: |
+| :----: |
+| * If you're upgrading from a version __< v8.2.0__, there are [non-backward-compatible changes](http://mermaid-js.github.io/mermaid/#/usage?id=to-enable-click-event-and-tags-in-nodes) related to security issues. Default behaviour of the library might have changed for your implementation.|
+<!-- </Remove this in the future> -->
 
-# Mermaid
+# mermaid [![Build Status](https://travis-ci.org/mermaid-js/mermaid.svg?branch=master)](https://travis-ci.org/mermaid-js/mermaid) [![NPM](https://img.shields.io/npm/v/mermaid)](https://www.npmjs.com/package/mermaid) [![Coverage Status](https://coveralls.io/repos/github/mermaid-js/mermaid/badge.svg?branch=master)](https://coveralls.io/github/mermaid-js/mermaid?branch=master) [![Join our Slack!](https://img.shields.io/static/v1?message=join%20chat&color=9cf&logo=slack&label=slack)](https://join.slack.com/t/mermaid-talk/shared_invite/enQtNzc4NDIyNzk4OTAyLWVhYjQxOTI2OTg4YmE1ZmJkY2Y4MTU3ODliYmIwOTY3NDJlYjA0YjIyZTdkMDMyZTUwOGI0NjEzYmEwODcwOTE) [![This project is using Percy.io for visual regression testing.](https://percy.io/static/images/percy-badge.svg)](https://percy.io/Mermaid/mermaid)
 
-[![Build Status](https://travis-ci.org/mermaid-js/mermaid.svg?branch=master)](https://travis-ci.org/mermaid-js/mermaid)
-[![Coverage Status](https://coveralls.io/repos/github/knsv/mermaid/badge.svg?branch=master)](https://coveralls.io/github/knsv/mermaid?branch=master)
-[![Join the chat at https://gitter.im/knsv/mermaid](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/knsv/mermaid?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+<!-- <Main description> -->
+__mermaid is a Javascript based diagramming and charting tool. It generates diagrams flowcharts and more, using markdown-inspired text for ease and speed.__
 
-![banner](./img/header.png)
-# What is mermaid?
+Check out the list of [Integrations and Usages of Mermaid](https://github.com/mermaid-js/mermaid/blob/develop/docs/integrations.md)
 
-It is a simple markdown-inspired, script language for diagramming and charting that can be deployed via Javascipt.
+For more information and help in getting started, please view our [documentation](http://mermaid-js.github.io/mermaid/) and start simplifying yours. Alternatively, you can also play with our [live editor](https://mermaidjs.github.io/mermaid-live-editor/).
+<!-- </Main description> --> 
 
-The reasoning behind it's inception was a need for simplified documentation and frustration with heavy and time consuming tools for explaining code, like Visio. 
-
-Thus mermaid was created to make the process of diagramming and charting, as simple and as close to markdown, as possible.
-
-Check out the list of [Integrations and Usages of Mermaid](./integrations.md)
-For the uninitiated, you can also  try out our [live editor](https://mermaid-js.github.io/mermaid-live-editor/) and look at our [documentation](https://mermaid-js.github.io/mermaid/#/n00b-overview) for a deeper understanding of the tool itself, more importantly don't forget to have fun. 
-
-**Mermaid was nominated and won the JS Open Source Awards (2019) in the category "The most exciting use of technology"!!! Thanks to all involved, people committing pull requests, people answering questions and special thanks to Tyler Long who is helping me maintain the project.**
+:trophy: **Mermaid was nominated and won the [JS Open Source Awards (2019)](https://osawards.com/javascript/#nominees) in the category "The most exciting use of technology"!!! Thanks to all involved, people committing pull requests, people answering questions and special thanks to Tyler Long who is helping me maintain the project.**
 
 ## New diagrams in 8.4
 
 With version 8.4 class diagrams have got some new features, bug fixes and documentation. Another new feature in 8.4 is the new diagram type, state diagrams.
 
-![Image show the two new diagram types](./img/new-diagrams.png)
+![Image show the two new diagram types](.docs/img/new-diagrams.png)
 
 ## Special note regarding version 8.2
 
@@ -44,64 +41,82 @@ mermaidAPI.initialize({
 });
 ```
 
-**🖖 Keep a steady pulse: mermaid needs more Collaborators [#866](https://github.com/k3nsv/mermaid/issues/866)**
+For more information and help in getting started, please view our [documentation](http://mermaid-js.github.io/mermaid/) and start simplifying yours. Play with our [live editor](https://mermaidjs.github.io/mermaid-live-editor/) or jump straight to the [installation and usage](http://mermaid-js.github.io/mermaid/#/usage).
+<!-- </Main description> -->
 
-## The following are examples of Diagrams that mermaid can make:
-
-### Flowchart
-
-```
-graph TD;
-    A-->B;
-    A-->C;
-    B-->D;
-    C-->D;
-```
-
-![Flowchart](./img/flow.png)
-
-### Sequence diagram
-
-```
+__The following are some examples of the diagrams, charts and graphs that can be made using mermaid and the Markdown-inspired text specific to it. Click here jump into the [text syntax](https://mermaid-js.github.io/mermaid/#/n00b-syntaxReference).__
+<table>
+<!-- <Flowchart> -->
+<tr><td colspan=2 align="center">
+    <b>Flow</b></br>
+    [<a href="http://mermaid-js.github.io/mermaid/#/flowchart">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZ3JhcGggVERcbiAgICBBW0hhcmRdIC0tPnxUZXh0fCBCKFJvdW5kKVxuICAgIEIgLS0-IEN7RGVjaXNpb259XG4gICAgQyAtLT58T25lfCBEW1Jlc3VsdCAxXVxuICAgIEMgLS0-fFR3b3wgRVtSZXN1bHQgMl0iLCJtZXJtYWlkIjp7InRoZW1lIjoiZGVmYXVsdCJ9fQ">live editor</a>]
+</td></tr>
+<tr>
+    <td><pre>
+graph TD
+A[Hard] -->|Text| B(Round)
+B --> C{Decision}
+C -->|One| D[Result 1]
+C -->|Two| E[Result 2]
+    </pre></td>
+    <td align="center">
+        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-flow.png" />
+    </td>
+</tr>
+<!-- </Flowchart> -->
+<!-- <Sequence> -->
+<tr><td colspan=2 align="center">
+    <b>Sequence</b><br />
+    [<a href="http://mermaid-js.github.io/mermaid/#/sequenceDiagram">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoic2VxdWVuY2VEaWFncmFtXG5BbGljZS0-PkpvaG46IEhlbGxvIEpvaG4sIGhvdyBhcmUgeW91P1xubG9vcCBIZWFsdGhjaGVja1xuICAgIEpvaG4tPj5Kb2huOiBGaWdodCBhZ2FpbnN0IGh5cG9jaG9uZHJpYVxuZW5kXG5Ob3RlIHJpZ2h0IG9mIEpvaG46IFJhdGlvbmFsIHRob3VnaHRzIVxuSm9obi0tPj5BbGljZTogR3JlYXQhXG5Kb2huLT4-Qm9iOiBIb3cgYWJvdXQgeW91P1xuQm9iLS0-PkpvaG46IEpvbGx5IGdvb2QhIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
+</td></tr>
+<tr>
+    <td><pre>
 sequenceDiagram
-    participant Alice
-    participant Bob
-    Alice->>John: Hello John, how are you?
-    loop Healthcheck
-        John->>John: Fight against hypochondria
-    end
-    Note right of John: Rational thoughts <br/>prevail!
-    John-->>Alice: Great!
-    John->>Bob: How about you?
-    Bob-->>John: Jolly good!
-```
-
-![Sequence diagram](./img/sequence.png)
-
-### Gantt diagram
-
-```
+Alice->>John: Hello John, how are you?
+loop Healthcheck
+    John->>John: Fight against hypochondria
+end
+Note right of John: Rational thoughts!
+John-->>Alice: Great!
+John->>Bob: How about you?
+Bob-->>John: Jolly good!
+    </pre></td>
+    <td align="center">
+        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-sequence.png" />
+    </td>
+</tr>
+<!-- </Sequence> -->
+<!-- <Gantt> -->
+<tr><td colspan=2 align="center">
+    <b>Gantt</b><br />
+    [<a href="http://mermaid-js.github.io/mermaid/#/gantt">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZ2FudHRcbnNlY3Rpb24gU2VjdGlvblxuQ29tcGxldGVkIDpkb25lLCAgICBkZXMxLCAyMDE0LTAxLTA2LDIwMTQtMDEtMDhcbkFjdGl2ZSAgICAgICAgOmFjdGl2ZSwgIGRlczIsIDIwMTQtMDEtMDcsIDNkXG5QYXJhbGxlbCAxICAgOiAgICAgICAgIGRlczMsIGFmdGVyIGRlczEsIDFkXG5QYXJhbGxlbCAyICAgOiAgICAgICAgIGRlczQsIGFmdGVyIGRlczEsIDFkXG5QYXJhbGxlbCAzICAgOiAgICAgICAgIGRlczUsIGFmdGVyIGRlczMsIDFkXG5QYXJhbGxlbCA0ICAgOiAgICAgICAgIGRlczYsIGFmdGVyIGRlczQsIDFkIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
+</td></tr>
+<tr>
+    <td><pre>
 gantt
-dateFormat  YYYY-MM-DD
-title Adding GANTT diagram to mermaid
-excludes weekdays 2014-01-10
-section A section
-Completed task            :done,    des1, 2014-01-06,2014-01-08
-Active task               :active,  des2, 2014-01-09, 3d
-Future task               :         des3, after des2, 5d
-Future task2               :         des4, after des3, 5d
-```
-
-![Gantt diagram](./img/gantt.png)
-
-### Class diagram - :exclamation: experimental
-
-```
+section Section
+Completed :done,    des1, 2014-01-06,2014-01-08
+Active        :active,  des2, 2014-01-07, 3d
+Parallel 1   :         des3, after des1, 1d
+Parallel 2   :         des4, after des1, 1d
+Parallel 3   :         des5, after des3, 1d
+Parallel 4   :         des6, after des4, 1d
+    </pre></td>
+    <td align="center">
+        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-gantt.png" />
+    </td>
+</tr>
+<!-- </Gantt> -->
+<!-- <Class> -->
+<tr><td colspan=2 align="center">
+    <b>Class</b><br />
+    [<a href="http://mermaid-js.github.io/mermaid/#/classDiagram">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiY2xhc3NEaWFncmFtXG5DbGFzczAxIDx8LS0gQXZlcnlMb25nQ2xhc3MgOiBDb29sXG48PGludGVyZmFjZT4-IENsYXNzMDFcbkNsYXNzMDkgLS0-IEMyIDogV2hlcmUgYW0gaT9cbkNsYXNzMDkgLS0qIEMzXG5DbGFzczA5IC0tfD4gQ2xhc3MwN1xuQ2xhc3MwNyA6IGVxdWFscygpXG5DbGFzczA3IDogT2JqZWN0W10gZWxlbWVudERhdGFcbkNsYXNzMDEgOiBzaXplKClcbkNsYXNzMDEgOiBpbnQgY2hpbXBcbkNsYXNzMDEgOiBpbnQgZ29yaWxsYVxuY2xhc3MgQ2xhc3MxMCB7XG4gID4-c2VydmljZT4-XG4gIGludCBpZFxuICBzaXplKClcbn0iLCJtZXJtYWlkIjp7InRoZW1lIjoiZGVmYXVsdCJ9fQ">live editor</a>]
+</td></tr>
+<tr>
+    <td><pre>
 classDiagram
-Class01 <|-- AveryLongClass : Cool
-Class03 *-- Class04
-Class05 o-- Class06
-Class07 .. Class08
+Class01 &lt;|-- AveryLongClass : Cool
+&lt;&lt;interface>> Class01
 Class09 --> C2 : Where am i?
 Class09 --* C3
 Class09 --|> Class07
@@ -110,129 +125,84 @@ Class07 : Object[] elementData
 Class01 : size()
 Class01 : int chimp
 Class01 : int gorilla
-Class08 <--> C2: Cool label
-```
-
-![Class diagram](./img/class.png)
-
-### Git graph - :exclamation: experimental
-
-```
-gitGraph:
-options
-{
-    "nodeSpacing": 150,
-    "nodeRadius": 10
+class Class10 {
+  &lt;&lt;service>>
+  int id
+  size()
 }
-end
-commit
-branch newbranch
-checkout newbranch
-commit
-commit
-checkout master
-commit
-commit
-merge newbranch
-```
+</pre></td>
+    <td align="center">
+        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-class.png" />
+    </td>
+</tr>
+<!-- </Class> -->
+<!-- <State> -->
+<tr><td colspan=2 align="center">
+    <b>State</b><br />
+    [<a href="http://mermaid-js.github.io/mermaid/#/stateDiagram">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoic3RhdGVEaWFncmFtXG4gICAgWypdIC0tPiBTdGlsbFxuICAgIFN0aWxsIC0tPiBbKl1cbiAgICBTdGlsbCAtLT4gTW92aW5nXG4gICAgTW92aW5nIC0tPiBTdGlsbFxuICAgIE1vdmluZyAtLT4gQ3Jhc2hcbiAgICBDcmFzaCAtLT4gWypdIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
+</td></tr>
+<tr>
+    <td><pre>
+stateDiagram
+[*] --> Still
+Still --> [*]
+Still --> Moving
+Moving --> Still
+Moving --> Crash
+Crash --> [*]
+</pre></td>
+    <td align="center">
+        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-state.png" />
+    </td>
+</tr>
+<!-- </State> -->
+<!-- <Pie> -->
+<tr><td colspan=2 align="center">
+    <b>Pie</b><br />
+    [<a href="http://mermaid-js.github.io/mermaid/#/pie">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoicGllXG5cIkRvZ3NcIiA6IDQyLjk2XG5cIkNhdHNcIiA6IDUwLjA1XG5cIlJhdHNcIiA6IDEwLjAxIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
+</td></tr>
+<tr>
+    <td><pre>
+pie
+"Dogs" : 386
+"Cats" : 85
+"Rats" : 15 
+</pre></td>
+    <td align="center">
+        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-pie.png" />
+    </td>
+</tr>
+<!-- </Pie> -->
+<!-- <Git> -->
+<tr><td colspan=2 align="center">
+    <b>Git</b><br />
+    [experimental - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZ2l0R3JhcGg6XG5vcHRpb25zXG57XG4gICAgXCJub2RlU3BhY2luZ1wiOiAxNTAsXG4gICAgXCJub2RlUmFkaXVzXCI6IDEwXG59XG5lbmRcbmNvbW1pdFxuYnJhbmNoIG5ld2JyYW5jaFxuY2hlY2tvdXQgbmV3YnJhbmNoXG5jb21taXRcbmNvbW1pdFxuY2hlY2tvdXQgbWFzdGVyXG5jb21taXRcbmNvbW1pdFxubWVyZ2UgbmV3YnJhbmNoXG4iLCJtZXJtYWlkIjp7InRoZW1lIjoiZGVmYXVsdCJ9fQ">live editor</a>]
+</td></tr>
+<tr>
+    <td colspan="2" align="center"><i>Coming soon!</i></td>
+</tr>
+<!-- </Git> -->
+</table>
 
-![Git graph](./img/git.png)
+## Related projects 
 
-## Installation
+- [Command Line Interface](https://github.com/mermaid-js/mermaid.cli)
+- [Live Editor](https://github.com/mermaid-js/mermaid-live-editor)
 
-### CDN
+# Contributors [![Help wanted](https://img.shields.io/github/labels/mermaid-js/mermaid/Help%20wanted!)](https://github.com/mermaid-js/mermaid/issues?q=is%3Aissue+is%3Aopen+label%3A%22Help+wanted%21%22) [![Contributors](https://img.shields.io/github/contributors/mermaid-js/mermaid)](https://github.com/mermaid-js/mermaid/graphs/contributors) [![Commits](https://img.shields.io/github/commit-activity/m/mermaid-js/mermaid)](https://github.com/mermaid-js/mermaid/graphs/contributors)
 
-```
-https://unpkg.com/mermaid@<version>/dist/
-```
+Mermaid is a growing community and is always accepting new contributors. There's a lot of different ways to help out and we're always looking for extra hands! Look at [this issue](https://github.com/mermaid-js/mermaid/issues/866) if you want to know where to start helping out.
 
-Replace `<version>` with expected version number.
+Detailed information about how to contribute can be found in the [contribution guide](CONTRIBUTING.md)
 
-Example: https://unpkg.com/mermaid@7.1.0/dist/
+# Appreciation
+A quick note from Knut Sveidqvist:
+>*Many thanks to the [d3](http://d3js.org/) and [dagre-d3](https://github.com/cpettitt/dagre-d3) projects for providing the graphical layout and drawing libraries!*
+>*Thanks also to the [js-sequence-diagram](http://bramp.github.io/js-sequence-diagrams) project for usage of the grammar for the sequence diagrams. Thanks to Jessica Peter for inspiration and starting point for gantt rendering.*
+>*Thank you to [Tyler Long](https://github.com/tylerlong) who has been a collaborator since April 2017.*
+>
+>*Thank you to the ever-growing list of [contributors](https://github.com/knsv/mermaid/graphs/contributors) that brought the project this far!*
 
-### Node.js
+---
 
-```
-yarn add mermaid
-```
-
-## Documentation
-
-https://mermaidjs.github.io
-
-## Sibling projects
-
-- [mermaid CLI](https://github.com/mermaidjs/mermaid.cli)
-- [mermaid live editor](https://github.com/mermaidjs/mermaid-live-editor)
-- [mermaid webpack demo](https://github.com/mermaidjs/mermaid-webpack-demo)
-- [mermaid Parcel demo](https://github.com/mermaidjs/mermaid-parcel-demo)
-
-## Request for assistance
-
-Things are piling up and I have a hard time keeping up. To remedy this
-it would be great if we could form a core team of developers to cooperate
-with the future development of mermaid.
-
-As part of this team you would get write access to the repository and would
-represent the project when answering questions and issues.
-
-Together we could continue the work with things like:
-
-- Adding more types of diagrams like mindmaps, ert diagrams, etc.
-- Improving existing diagrams
-
-Don't hesitate to contact me if you want to get involved.
-
-## For contributors
-
-### Setup
-
-```
-yarn install
-```
-
-### Build
-
-```
-yarn build:watch
-```
-
-### Lint
-
-```
-yarn lint
-```
-
-We use [eslint](https://eslint.org/).
-We recommend you installing [editor plugins](https://eslint.org/docs/user-guide/integrations) so you can get real time lint result.
-
-### Test
-
-```
-yarn test
-```
-Manual test in browser: open `dist/index.html`
-
-### Release
-
-For those who have the permission to do so:
-
-Update version number in `package.json`.
-
-```
-npm publish
-```
-
-Command above generates files into the `dist` folder and publishes them to npmjs.org.
-
-## Credits
-
-Many thanks to the [d3](http://d3js.org/) and [dagre-d3](https://github.com/cpettitt/dagre-d3) projects for providing the graphical layout and drawing libraries!
-
-Thanks also to the [js-sequence-diagram](http://bramp.github.io/js-sequence-diagrams) project for usage of the grammar for the sequence diagrams. Thanks to Jessica Peter for inspiration and starting point for gantt rendering.
-
-_Mermaid was created by Knut Sveidqvist for easier documentation._
-
-_[Tyler Long](https://github.com/tylerlong) has became a collaborator since April 2017._
-
-Here is the full list of the projects [contributors](https://github.com/knsv/mermaid/graphs/contributors).
+*Mermaid was created by Knut Sveidqvist for easier documentation.*

From 09e6804761aa7bd8acd1bd3392120f58fa3703b5 Mon Sep 17 00:00:00 2001
From: NeilCuzon <elancuzon@gmail.com>
Date: Mon, 9 Mar 2020 23:25:55 -0700
Subject: [PATCH 24/34] Revert "Revert "Revert "Revert "Update README.md""""

This reverts commit a414aa27b6d6bd2b483b00f122e6483991043f04.
---
 README.md | 344 +++++++++++++++++++++++++++++-------------------------
 1 file changed, 187 insertions(+), 157 deletions(-)

diff --git a/README.md b/README.md
index 781cee7e1..791ac115c 100644
--- a/README.md
+++ b/README.md
@@ -1,26 +1,29 @@
-<!-- <Remove this in the future> -->
-| :mega: :mega: :mega: |
-| :----: |
-| * If you're upgrading from a version __< v8.2.0__, there are [non-backward-compatible changes](http://mermaid-js.github.io/mermaid/#/usage?id=to-enable-click-event-and-tags-in-nodes) related to security issues. Default behaviour of the library might have changed for your implementation.|
-<!-- </Remove this in the future> -->
 
-# mermaid [![Build Status](https://travis-ci.org/mermaid-js/mermaid.svg?branch=master)](https://travis-ci.org/mermaid-js/mermaid) [![NPM](https://img.shields.io/npm/v/mermaid)](https://www.npmjs.com/package/mermaid) [![Coverage Status](https://coveralls.io/repos/github/mermaid-js/mermaid/badge.svg?branch=master)](https://coveralls.io/github/mermaid-js/mermaid?branch=master) [![Join our Slack!](https://img.shields.io/static/v1?message=join%20chat&color=9cf&logo=slack&label=slack)](https://join.slack.com/t/mermaid-talk/shared_invite/enQtNzc4NDIyNzk4OTAyLWVhYjQxOTI2OTg4YmE1ZmJkY2Y4MTU3ODliYmIwOTY3NDJlYjA0YjIyZTdkMDMyZTUwOGI0NjEzYmEwODcwOTE) [![This project is using Percy.io for visual regression testing.](https://percy.io/static/images/percy-badge.svg)](https://percy.io/Mermaid/mermaid)
+# Mermaid
 
-<!-- <Main description> -->
-__mermaid is a Javascript based diagramming and charting tool. It generates diagrams flowcharts and more, using markdown-inspired text for ease and speed.__
+[![Build Status](https://travis-ci.org/mermaid-js/mermaid.svg?branch=master)](https://travis-ci.org/mermaid-js/mermaid)
+[![Coverage Status](https://coveralls.io/repos/github/knsv/mermaid/badge.svg?branch=master)](https://coveralls.io/github/knsv/mermaid?branch=master)
+[![Join the chat at https://gitter.im/knsv/mermaid](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/knsv/mermaid?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
-Check out the list of [Integrations and Usages of Mermaid](https://github.com/mermaid-js/mermaid/blob/develop/docs/integrations.md)
+![banner](./img/header.png)
+# What is mermaid?
 
-For more information and help in getting started, please view our [documentation](http://mermaid-js.github.io/mermaid/) and start simplifying yours. Alternatively, you can also play with our [live editor](https://mermaidjs.github.io/mermaid-live-editor/).
-<!-- </Main description> --> 
+It is a simple markdown-inspired, script language for diagramming and charting that can be deployed via Javascipt.
 
-:trophy: **Mermaid was nominated and won the [JS Open Source Awards (2019)](https://osawards.com/javascript/#nominees) in the category "The most exciting use of technology"!!! Thanks to all involved, people committing pull requests, people answering questions and special thanks to Tyler Long who is helping me maintain the project.**
+The reasoning behind it's inception was a need for simplified documentation and frustration with heavy and time consuming tools for explaining code, like Visio. 
+
+Thus mermaid was created to make the process of diagramming and charting, as simple and as close to markdown, as possible.
+
+Check out the list of [Integrations and Usages of Mermaid](./integrations.md)
+For the uninitiated, you can also  try out our [live editor](https://mermaid-js.github.io/mermaid-live-editor/) and look at our [documentation](https://mermaid-js.github.io/mermaid/#/n00b-overview) for a deeper understanding of the tool itself, more importantly don't forget to have fun. 
+
+**Mermaid was nominated and won the JS Open Source Awards (2019) in the category "The most exciting use of technology"!!! Thanks to all involved, people committing pull requests, people answering questions and special thanks to Tyler Long who is helping me maintain the project.**
 
 ## New diagrams in 8.4
 
 With version 8.4 class diagrams have got some new features, bug fixes and documentation. Another new feature in 8.4 is the new diagram type, state diagrams.
 
-![Image show the two new diagram types](.docs/img/new-diagrams.png)
+![Image show the two new diagram types](./img/new-diagrams.png)
 
 ## Special note regarding version 8.2
 
@@ -41,82 +44,64 @@ mermaidAPI.initialize({
 });
 ```
 
-For more information and help in getting started, please view our [documentation](http://mermaid-js.github.io/mermaid/) and start simplifying yours. Play with our [live editor](https://mermaidjs.github.io/mermaid-live-editor/) or jump straight to the [installation and usage](http://mermaid-js.github.io/mermaid/#/usage).
-<!-- </Main description> -->
+**🖖 Keep a steady pulse: mermaid needs more Collaborators [#866](https://github.com/k3nsv/mermaid/issues/866)**
 
-__The following are some examples of the diagrams, charts and graphs that can be made using mermaid and the Markdown-inspired text specific to it. Click here jump into the [text syntax](https://mermaid-js.github.io/mermaid/#/n00b-syntaxReference).__
-<table>
-<!-- <Flowchart> -->
-<tr><td colspan=2 align="center">
-    <b>Flow</b></br>
-    [<a href="http://mermaid-js.github.io/mermaid/#/flowchart">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZ3JhcGggVERcbiAgICBBW0hhcmRdIC0tPnxUZXh0fCBCKFJvdW5kKVxuICAgIEIgLS0-IEN7RGVjaXNpb259XG4gICAgQyAtLT58T25lfCBEW1Jlc3VsdCAxXVxuICAgIEMgLS0-fFR3b3wgRVtSZXN1bHQgMl0iLCJtZXJtYWlkIjp7InRoZW1lIjoiZGVmYXVsdCJ9fQ">live editor</a>]
-</td></tr>
-<tr>
-    <td><pre>
-graph TD
-A[Hard] -->|Text| B(Round)
-B --> C{Decision}
-C -->|One| D[Result 1]
-C -->|Two| E[Result 2]
-    </pre></td>
-    <td align="center">
-        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-flow.png" />
-    </td>
-</tr>
-<!-- </Flowchart> -->
-<!-- <Sequence> -->
-<tr><td colspan=2 align="center">
-    <b>Sequence</b><br />
-    [<a href="http://mermaid-js.github.io/mermaid/#/sequenceDiagram">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoic2VxdWVuY2VEaWFncmFtXG5BbGljZS0-PkpvaG46IEhlbGxvIEpvaG4sIGhvdyBhcmUgeW91P1xubG9vcCBIZWFsdGhjaGVja1xuICAgIEpvaG4tPj5Kb2huOiBGaWdodCBhZ2FpbnN0IGh5cG9jaG9uZHJpYVxuZW5kXG5Ob3RlIHJpZ2h0IG9mIEpvaG46IFJhdGlvbmFsIHRob3VnaHRzIVxuSm9obi0tPj5BbGljZTogR3JlYXQhXG5Kb2huLT4-Qm9iOiBIb3cgYWJvdXQgeW91P1xuQm9iLS0-PkpvaG46IEpvbGx5IGdvb2QhIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
-</td></tr>
-<tr>
-    <td><pre>
+## The following are examples of Diagrams that mermaid can make:
+
+### Flowchart
+
+```
+graph TD;
+    A-->B;
+    A-->C;
+    B-->D;
+    C-->D;
+```
+
+![Flowchart](./img/flow.png)
+
+### Sequence diagram
+
+```
 sequenceDiagram
-Alice->>John: Hello John, how are you?
-loop Healthcheck
-    John->>John: Fight against hypochondria
-end
-Note right of John: Rational thoughts!
-John-->>Alice: Great!
-John->>Bob: How about you?
-Bob-->>John: Jolly good!
-    </pre></td>
-    <td align="center">
-        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-sequence.png" />
-    </td>
-</tr>
-<!-- </Sequence> -->
-<!-- <Gantt> -->
-<tr><td colspan=2 align="center">
-    <b>Gantt</b><br />
-    [<a href="http://mermaid-js.github.io/mermaid/#/gantt">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZ2FudHRcbnNlY3Rpb24gU2VjdGlvblxuQ29tcGxldGVkIDpkb25lLCAgICBkZXMxLCAyMDE0LTAxLTA2LDIwMTQtMDEtMDhcbkFjdGl2ZSAgICAgICAgOmFjdGl2ZSwgIGRlczIsIDIwMTQtMDEtMDcsIDNkXG5QYXJhbGxlbCAxICAgOiAgICAgICAgIGRlczMsIGFmdGVyIGRlczEsIDFkXG5QYXJhbGxlbCAyICAgOiAgICAgICAgIGRlczQsIGFmdGVyIGRlczEsIDFkXG5QYXJhbGxlbCAzICAgOiAgICAgICAgIGRlczUsIGFmdGVyIGRlczMsIDFkXG5QYXJhbGxlbCA0ICAgOiAgICAgICAgIGRlczYsIGFmdGVyIGRlczQsIDFkIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
-</td></tr>
-<tr>
-    <td><pre>
+    participant Alice
+    participant Bob
+    Alice->>John: Hello John, how are you?
+    loop Healthcheck
+        John->>John: Fight against hypochondria
+    end
+    Note right of John: Rational thoughts <br/>prevail!
+    John-->>Alice: Great!
+    John->>Bob: How about you?
+    Bob-->>John: Jolly good!
+```
+
+![Sequence diagram](./img/sequence.png)
+
+### Gantt diagram
+
+```
 gantt
-section Section
-Completed :done,    des1, 2014-01-06,2014-01-08
-Active        :active,  des2, 2014-01-07, 3d
-Parallel 1   :         des3, after des1, 1d
-Parallel 2   :         des4, after des1, 1d
-Parallel 3   :         des5, after des3, 1d
-Parallel 4   :         des6, after des4, 1d
-    </pre></td>
-    <td align="center">
-        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-gantt.png" />
-    </td>
-</tr>
-<!-- </Gantt> -->
-<!-- <Class> -->
-<tr><td colspan=2 align="center">
-    <b>Class</b><br />
-    [<a href="http://mermaid-js.github.io/mermaid/#/classDiagram">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiY2xhc3NEaWFncmFtXG5DbGFzczAxIDx8LS0gQXZlcnlMb25nQ2xhc3MgOiBDb29sXG48PGludGVyZmFjZT4-IENsYXNzMDFcbkNsYXNzMDkgLS0-IEMyIDogV2hlcmUgYW0gaT9cbkNsYXNzMDkgLS0qIEMzXG5DbGFzczA5IC0tfD4gQ2xhc3MwN1xuQ2xhc3MwNyA6IGVxdWFscygpXG5DbGFzczA3IDogT2JqZWN0W10gZWxlbWVudERhdGFcbkNsYXNzMDEgOiBzaXplKClcbkNsYXNzMDEgOiBpbnQgY2hpbXBcbkNsYXNzMDEgOiBpbnQgZ29yaWxsYVxuY2xhc3MgQ2xhc3MxMCB7XG4gID4-c2VydmljZT4-XG4gIGludCBpZFxuICBzaXplKClcbn0iLCJtZXJtYWlkIjp7InRoZW1lIjoiZGVmYXVsdCJ9fQ">live editor</a>]
-</td></tr>
-<tr>
-    <td><pre>
+dateFormat  YYYY-MM-DD
+title Adding GANTT diagram to mermaid
+excludes weekdays 2014-01-10
+section A section
+Completed task            :done,    des1, 2014-01-06,2014-01-08
+Active task               :active,  des2, 2014-01-09, 3d
+Future task               :         des3, after des2, 5d
+Future task2               :         des4, after des3, 5d
+```
+
+![Gantt diagram](./img/gantt.png)
+
+### Class diagram - :exclamation: experimental
+
+```
 classDiagram
-Class01 &lt;|-- AveryLongClass : Cool
-&lt;&lt;interface>> Class01
+Class01 <|-- AveryLongClass : Cool
+Class03 *-- Class04
+Class05 o-- Class06
+Class07 .. Class08
 Class09 --> C2 : Where am i?
 Class09 --* C3
 Class09 --|> Class07
@@ -125,84 +110,129 @@ Class07 : Object[] elementData
 Class01 : size()
 Class01 : int chimp
 Class01 : int gorilla
-class Class10 {
-  &lt;&lt;service>>
-  int id
-  size()
+Class08 <--> C2: Cool label
+```
+
+![Class diagram](./img/class.png)
+
+### Git graph - :exclamation: experimental
+
+```
+gitGraph:
+options
+{
+    "nodeSpacing": 150,
+    "nodeRadius": 10
 }
-</pre></td>
-    <td align="center">
-        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-class.png" />
-    </td>
-</tr>
-<!-- </Class> -->
-<!-- <State> -->
-<tr><td colspan=2 align="center">
-    <b>State</b><br />
-    [<a href="http://mermaid-js.github.io/mermaid/#/stateDiagram">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoic3RhdGVEaWFncmFtXG4gICAgWypdIC0tPiBTdGlsbFxuICAgIFN0aWxsIC0tPiBbKl1cbiAgICBTdGlsbCAtLT4gTW92aW5nXG4gICAgTW92aW5nIC0tPiBTdGlsbFxuICAgIE1vdmluZyAtLT4gQ3Jhc2hcbiAgICBDcmFzaCAtLT4gWypdIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
-</td></tr>
-<tr>
-    <td><pre>
-stateDiagram
-[*] --> Still
-Still --> [*]
-Still --> Moving
-Moving --> Still
-Moving --> Crash
-Crash --> [*]
-</pre></td>
-    <td align="center">
-        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-state.png" />
-    </td>
-</tr>
-<!-- </State> -->
-<!-- <Pie> -->
-<tr><td colspan=2 align="center">
-    <b>Pie</b><br />
-    [<a href="http://mermaid-js.github.io/mermaid/#/pie">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoicGllXG5cIkRvZ3NcIiA6IDQyLjk2XG5cIkNhdHNcIiA6IDUwLjA1XG5cIlJhdHNcIiA6IDEwLjAxIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
-</td></tr>
-<tr>
-    <td><pre>
-pie
-"Dogs" : 386
-"Cats" : 85
-"Rats" : 15 
-</pre></td>
-    <td align="center">
-        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-pie.png" />
-    </td>
-</tr>
-<!-- </Pie> -->
-<!-- <Git> -->
-<tr><td colspan=2 align="center">
-    <b>Git</b><br />
-    [experimental - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZ2l0R3JhcGg6XG5vcHRpb25zXG57XG4gICAgXCJub2RlU3BhY2luZ1wiOiAxNTAsXG4gICAgXCJub2RlUmFkaXVzXCI6IDEwXG59XG5lbmRcbmNvbW1pdFxuYnJhbmNoIG5ld2JyYW5jaFxuY2hlY2tvdXQgbmV3YnJhbmNoXG5jb21taXRcbmNvbW1pdFxuY2hlY2tvdXQgbWFzdGVyXG5jb21taXRcbmNvbW1pdFxubWVyZ2UgbmV3YnJhbmNoXG4iLCJtZXJtYWlkIjp7InRoZW1lIjoiZGVmYXVsdCJ9fQ">live editor</a>]
-</td></tr>
-<tr>
-    <td colspan="2" align="center"><i>Coming soon!</i></td>
-</tr>
-<!-- </Git> -->
-</table>
+end
+commit
+branch newbranch
+checkout newbranch
+commit
+commit
+checkout master
+commit
+commit
+merge newbranch
+```
 
-## Related projects 
+![Git graph](./img/git.png)
 
-- [Command Line Interface](https://github.com/mermaid-js/mermaid.cli)
-- [Live Editor](https://github.com/mermaid-js/mermaid-live-editor)
+## Installation
 
-# Contributors [![Help wanted](https://img.shields.io/github/labels/mermaid-js/mermaid/Help%20wanted!)](https://github.com/mermaid-js/mermaid/issues?q=is%3Aissue+is%3Aopen+label%3A%22Help+wanted%21%22) [![Contributors](https://img.shields.io/github/contributors/mermaid-js/mermaid)](https://github.com/mermaid-js/mermaid/graphs/contributors) [![Commits](https://img.shields.io/github/commit-activity/m/mermaid-js/mermaid)](https://github.com/mermaid-js/mermaid/graphs/contributors)
+### CDN
 
-Mermaid is a growing community and is always accepting new contributors. There's a lot of different ways to help out and we're always looking for extra hands! Look at [this issue](https://github.com/mermaid-js/mermaid/issues/866) if you want to know where to start helping out.
+```
+https://unpkg.com/mermaid@<version>/dist/
+```
 
-Detailed information about how to contribute can be found in the [contribution guide](CONTRIBUTING.md)
+Replace `<version>` with expected version number.
 
-# Appreciation
-A quick note from Knut Sveidqvist:
->*Many thanks to the [d3](http://d3js.org/) and [dagre-d3](https://github.com/cpettitt/dagre-d3) projects for providing the graphical layout and drawing libraries!*
->*Thanks also to the [js-sequence-diagram](http://bramp.github.io/js-sequence-diagrams) project for usage of the grammar for the sequence diagrams. Thanks to Jessica Peter for inspiration and starting point for gantt rendering.*
->*Thank you to [Tyler Long](https://github.com/tylerlong) who has been a collaborator since April 2017.*
->
->*Thank you to the ever-growing list of [contributors](https://github.com/knsv/mermaid/graphs/contributors) that brought the project this far!*
+Example: https://unpkg.com/mermaid@7.1.0/dist/
 
----
+### Node.js
 
-*Mermaid was created by Knut Sveidqvist for easier documentation.*
+```
+yarn add mermaid
+```
+
+## Documentation
+
+https://mermaidjs.github.io
+
+## Sibling projects
+
+- [mermaid CLI](https://github.com/mermaidjs/mermaid.cli)
+- [mermaid live editor](https://github.com/mermaidjs/mermaid-live-editor)
+- [mermaid webpack demo](https://github.com/mermaidjs/mermaid-webpack-demo)
+- [mermaid Parcel demo](https://github.com/mermaidjs/mermaid-parcel-demo)
+
+## Request for assistance
+
+Things are piling up and I have a hard time keeping up. To remedy this
+it would be great if we could form a core team of developers to cooperate
+with the future development of mermaid.
+
+As part of this team you would get write access to the repository and would
+represent the project when answering questions and issues.
+
+Together we could continue the work with things like:
+
+- Adding more types of diagrams like mindmaps, ert diagrams, etc.
+- Improving existing diagrams
+
+Don't hesitate to contact me if you want to get involved.
+
+## For contributors
+
+### Setup
+
+```
+yarn install
+```
+
+### Build
+
+```
+yarn build:watch
+```
+
+### Lint
+
+```
+yarn lint
+```
+
+We use [eslint](https://eslint.org/).
+We recommend you installing [editor plugins](https://eslint.org/docs/user-guide/integrations) so you can get real time lint result.
+
+### Test
+
+```
+yarn test
+```
+Manual test in browser: open `dist/index.html`
+
+### Release
+
+For those who have the permission to do so:
+
+Update version number in `package.json`.
+
+```
+npm publish
+```
+
+Command above generates files into the `dist` folder and publishes them to npmjs.org.
+
+## Credits
+
+Many thanks to the [d3](http://d3js.org/) and [dagre-d3](https://github.com/cpettitt/dagre-d3) projects for providing the graphical layout and drawing libraries!
+
+Thanks also to the [js-sequence-diagram](http://bramp.github.io/js-sequence-diagrams) project for usage of the grammar for the sequence diagrams. Thanks to Jessica Peter for inspiration and starting point for gantt rendering.
+
+_Mermaid was created by Knut Sveidqvist for easier documentation._
+
+_[Tyler Long](https://github.com/tylerlong) has became a collaborator since April 2017._
+
+Here is the full list of the projects [contributors](https://github.com/knsv/mermaid/graphs/contributors).

From 5a763230e5945a37ad72b5ffd546f9ea0b8392b9 Mon Sep 17 00:00:00 2001
From: NeilCuzon <elancuzon@gmail.com>
Date: Mon, 9 Mar 2020 23:26:00 -0700
Subject: [PATCH 25/34] Revert "Revert "Revert "Revert "Revert "Update
 README.md"""""

This reverts commit 09e6804761aa7bd8acd1bd3392120f58fa3703b5.
---
 README.md | 344 +++++++++++++++++++++++++-----------------------------
 1 file changed, 157 insertions(+), 187 deletions(-)

diff --git a/README.md b/README.md
index 791ac115c..781cee7e1 100644
--- a/README.md
+++ b/README.md
@@ -1,29 +1,26 @@
+<!-- <Remove this in the future> -->
+| :mega: :mega: :mega: |
+| :----: |
+| * If you're upgrading from a version __< v8.2.0__, there are [non-backward-compatible changes](http://mermaid-js.github.io/mermaid/#/usage?id=to-enable-click-event-and-tags-in-nodes) related to security issues. Default behaviour of the library might have changed for your implementation.|
+<!-- </Remove this in the future> -->
 
-# Mermaid
+# mermaid [![Build Status](https://travis-ci.org/mermaid-js/mermaid.svg?branch=master)](https://travis-ci.org/mermaid-js/mermaid) [![NPM](https://img.shields.io/npm/v/mermaid)](https://www.npmjs.com/package/mermaid) [![Coverage Status](https://coveralls.io/repos/github/mermaid-js/mermaid/badge.svg?branch=master)](https://coveralls.io/github/mermaid-js/mermaid?branch=master) [![Join our Slack!](https://img.shields.io/static/v1?message=join%20chat&color=9cf&logo=slack&label=slack)](https://join.slack.com/t/mermaid-talk/shared_invite/enQtNzc4NDIyNzk4OTAyLWVhYjQxOTI2OTg4YmE1ZmJkY2Y4MTU3ODliYmIwOTY3NDJlYjA0YjIyZTdkMDMyZTUwOGI0NjEzYmEwODcwOTE) [![This project is using Percy.io for visual regression testing.](https://percy.io/static/images/percy-badge.svg)](https://percy.io/Mermaid/mermaid)
 
-[![Build Status](https://travis-ci.org/mermaid-js/mermaid.svg?branch=master)](https://travis-ci.org/mermaid-js/mermaid)
-[![Coverage Status](https://coveralls.io/repos/github/knsv/mermaid/badge.svg?branch=master)](https://coveralls.io/github/knsv/mermaid?branch=master)
-[![Join the chat at https://gitter.im/knsv/mermaid](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/knsv/mermaid?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+<!-- <Main description> -->
+__mermaid is a Javascript based diagramming and charting tool. It generates diagrams flowcharts and more, using markdown-inspired text for ease and speed.__
 
-![banner](./img/header.png)
-# What is mermaid?
+Check out the list of [Integrations and Usages of Mermaid](https://github.com/mermaid-js/mermaid/blob/develop/docs/integrations.md)
 
-It is a simple markdown-inspired, script language for diagramming and charting that can be deployed via Javascipt.
+For more information and help in getting started, please view our [documentation](http://mermaid-js.github.io/mermaid/) and start simplifying yours. Alternatively, you can also play with our [live editor](https://mermaidjs.github.io/mermaid-live-editor/).
+<!-- </Main description> --> 
 
-The reasoning behind it's inception was a need for simplified documentation and frustration with heavy and time consuming tools for explaining code, like Visio. 
-
-Thus mermaid was created to make the process of diagramming and charting, as simple and as close to markdown, as possible.
-
-Check out the list of [Integrations and Usages of Mermaid](./integrations.md)
-For the uninitiated, you can also  try out our [live editor](https://mermaid-js.github.io/mermaid-live-editor/) and look at our [documentation](https://mermaid-js.github.io/mermaid/#/n00b-overview) for a deeper understanding of the tool itself, more importantly don't forget to have fun. 
-
-**Mermaid was nominated and won the JS Open Source Awards (2019) in the category "The most exciting use of technology"!!! Thanks to all involved, people committing pull requests, people answering questions and special thanks to Tyler Long who is helping me maintain the project.**
+:trophy: **Mermaid was nominated and won the [JS Open Source Awards (2019)](https://osawards.com/javascript/#nominees) in the category "The most exciting use of technology"!!! Thanks to all involved, people committing pull requests, people answering questions and special thanks to Tyler Long who is helping me maintain the project.**
 
 ## New diagrams in 8.4
 
 With version 8.4 class diagrams have got some new features, bug fixes and documentation. Another new feature in 8.4 is the new diagram type, state diagrams.
 
-![Image show the two new diagram types](./img/new-diagrams.png)
+![Image show the two new diagram types](.docs/img/new-diagrams.png)
 
 ## Special note regarding version 8.2
 
@@ -44,64 +41,82 @@ mermaidAPI.initialize({
 });
 ```
 
-**🖖 Keep a steady pulse: mermaid needs more Collaborators [#866](https://github.com/k3nsv/mermaid/issues/866)**
+For more information and help in getting started, please view our [documentation](http://mermaid-js.github.io/mermaid/) and start simplifying yours. Play with our [live editor](https://mermaidjs.github.io/mermaid-live-editor/) or jump straight to the [installation and usage](http://mermaid-js.github.io/mermaid/#/usage).
+<!-- </Main description> -->
 
-## The following are examples of Diagrams that mermaid can make:
-
-### Flowchart
-
-```
-graph TD;
-    A-->B;
-    A-->C;
-    B-->D;
-    C-->D;
-```
-
-![Flowchart](./img/flow.png)
-
-### Sequence diagram
-
-```
+__The following are some examples of the diagrams, charts and graphs that can be made using mermaid and the Markdown-inspired text specific to it. Click here jump into the [text syntax](https://mermaid-js.github.io/mermaid/#/n00b-syntaxReference).__
+<table>
+<!-- <Flowchart> -->
+<tr><td colspan=2 align="center">
+    <b>Flow</b></br>
+    [<a href="http://mermaid-js.github.io/mermaid/#/flowchart">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZ3JhcGggVERcbiAgICBBW0hhcmRdIC0tPnxUZXh0fCBCKFJvdW5kKVxuICAgIEIgLS0-IEN7RGVjaXNpb259XG4gICAgQyAtLT58T25lfCBEW1Jlc3VsdCAxXVxuICAgIEMgLS0-fFR3b3wgRVtSZXN1bHQgMl0iLCJtZXJtYWlkIjp7InRoZW1lIjoiZGVmYXVsdCJ9fQ">live editor</a>]
+</td></tr>
+<tr>
+    <td><pre>
+graph TD
+A[Hard] -->|Text| B(Round)
+B --> C{Decision}
+C -->|One| D[Result 1]
+C -->|Two| E[Result 2]
+    </pre></td>
+    <td align="center">
+        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-flow.png" />
+    </td>
+</tr>
+<!-- </Flowchart> -->
+<!-- <Sequence> -->
+<tr><td colspan=2 align="center">
+    <b>Sequence</b><br />
+    [<a href="http://mermaid-js.github.io/mermaid/#/sequenceDiagram">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoic2VxdWVuY2VEaWFncmFtXG5BbGljZS0-PkpvaG46IEhlbGxvIEpvaG4sIGhvdyBhcmUgeW91P1xubG9vcCBIZWFsdGhjaGVja1xuICAgIEpvaG4tPj5Kb2huOiBGaWdodCBhZ2FpbnN0IGh5cG9jaG9uZHJpYVxuZW5kXG5Ob3RlIHJpZ2h0IG9mIEpvaG46IFJhdGlvbmFsIHRob3VnaHRzIVxuSm9obi0tPj5BbGljZTogR3JlYXQhXG5Kb2huLT4-Qm9iOiBIb3cgYWJvdXQgeW91P1xuQm9iLS0-PkpvaG46IEpvbGx5IGdvb2QhIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
+</td></tr>
+<tr>
+    <td><pre>
 sequenceDiagram
-    participant Alice
-    participant Bob
-    Alice->>John: Hello John, how are you?
-    loop Healthcheck
-        John->>John: Fight against hypochondria
-    end
-    Note right of John: Rational thoughts <br/>prevail!
-    John-->>Alice: Great!
-    John->>Bob: How about you?
-    Bob-->>John: Jolly good!
-```
-
-![Sequence diagram](./img/sequence.png)
-
-### Gantt diagram
-
-```
+Alice->>John: Hello John, how are you?
+loop Healthcheck
+    John->>John: Fight against hypochondria
+end
+Note right of John: Rational thoughts!
+John-->>Alice: Great!
+John->>Bob: How about you?
+Bob-->>John: Jolly good!
+    </pre></td>
+    <td align="center">
+        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-sequence.png" />
+    </td>
+</tr>
+<!-- </Sequence> -->
+<!-- <Gantt> -->
+<tr><td colspan=2 align="center">
+    <b>Gantt</b><br />
+    [<a href="http://mermaid-js.github.io/mermaid/#/gantt">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZ2FudHRcbnNlY3Rpb24gU2VjdGlvblxuQ29tcGxldGVkIDpkb25lLCAgICBkZXMxLCAyMDE0LTAxLTA2LDIwMTQtMDEtMDhcbkFjdGl2ZSAgICAgICAgOmFjdGl2ZSwgIGRlczIsIDIwMTQtMDEtMDcsIDNkXG5QYXJhbGxlbCAxICAgOiAgICAgICAgIGRlczMsIGFmdGVyIGRlczEsIDFkXG5QYXJhbGxlbCAyICAgOiAgICAgICAgIGRlczQsIGFmdGVyIGRlczEsIDFkXG5QYXJhbGxlbCAzICAgOiAgICAgICAgIGRlczUsIGFmdGVyIGRlczMsIDFkXG5QYXJhbGxlbCA0ICAgOiAgICAgICAgIGRlczYsIGFmdGVyIGRlczQsIDFkIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
+</td></tr>
+<tr>
+    <td><pre>
 gantt
-dateFormat  YYYY-MM-DD
-title Adding GANTT diagram to mermaid
-excludes weekdays 2014-01-10
-section A section
-Completed task            :done,    des1, 2014-01-06,2014-01-08
-Active task               :active,  des2, 2014-01-09, 3d
-Future task               :         des3, after des2, 5d
-Future task2               :         des4, after des3, 5d
-```
-
-![Gantt diagram](./img/gantt.png)
-
-### Class diagram - :exclamation: experimental
-
-```
+section Section
+Completed :done,    des1, 2014-01-06,2014-01-08
+Active        :active,  des2, 2014-01-07, 3d
+Parallel 1   :         des3, after des1, 1d
+Parallel 2   :         des4, after des1, 1d
+Parallel 3   :         des5, after des3, 1d
+Parallel 4   :         des6, after des4, 1d
+    </pre></td>
+    <td align="center">
+        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-gantt.png" />
+    </td>
+</tr>
+<!-- </Gantt> -->
+<!-- <Class> -->
+<tr><td colspan=2 align="center">
+    <b>Class</b><br />
+    [<a href="http://mermaid-js.github.io/mermaid/#/classDiagram">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiY2xhc3NEaWFncmFtXG5DbGFzczAxIDx8LS0gQXZlcnlMb25nQ2xhc3MgOiBDb29sXG48PGludGVyZmFjZT4-IENsYXNzMDFcbkNsYXNzMDkgLS0-IEMyIDogV2hlcmUgYW0gaT9cbkNsYXNzMDkgLS0qIEMzXG5DbGFzczA5IC0tfD4gQ2xhc3MwN1xuQ2xhc3MwNyA6IGVxdWFscygpXG5DbGFzczA3IDogT2JqZWN0W10gZWxlbWVudERhdGFcbkNsYXNzMDEgOiBzaXplKClcbkNsYXNzMDEgOiBpbnQgY2hpbXBcbkNsYXNzMDEgOiBpbnQgZ29yaWxsYVxuY2xhc3MgQ2xhc3MxMCB7XG4gID4-c2VydmljZT4-XG4gIGludCBpZFxuICBzaXplKClcbn0iLCJtZXJtYWlkIjp7InRoZW1lIjoiZGVmYXVsdCJ9fQ">live editor</a>]
+</td></tr>
+<tr>
+    <td><pre>
 classDiagram
-Class01 <|-- AveryLongClass : Cool
-Class03 *-- Class04
-Class05 o-- Class06
-Class07 .. Class08
+Class01 &lt;|-- AveryLongClass : Cool
+&lt;&lt;interface>> Class01
 Class09 --> C2 : Where am i?
 Class09 --* C3
 Class09 --|> Class07
@@ -110,129 +125,84 @@ Class07 : Object[] elementData
 Class01 : size()
 Class01 : int chimp
 Class01 : int gorilla
-Class08 <--> C2: Cool label
-```
-
-![Class diagram](./img/class.png)
-
-### Git graph - :exclamation: experimental
-
-```
-gitGraph:
-options
-{
-    "nodeSpacing": 150,
-    "nodeRadius": 10
+class Class10 {
+  &lt;&lt;service>>
+  int id
+  size()
 }
-end
-commit
-branch newbranch
-checkout newbranch
-commit
-commit
-checkout master
-commit
-commit
-merge newbranch
-```
+</pre></td>
+    <td align="center">
+        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-class.png" />
+    </td>
+</tr>
+<!-- </Class> -->
+<!-- <State> -->
+<tr><td colspan=2 align="center">
+    <b>State</b><br />
+    [<a href="http://mermaid-js.github.io/mermaid/#/stateDiagram">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoic3RhdGVEaWFncmFtXG4gICAgWypdIC0tPiBTdGlsbFxuICAgIFN0aWxsIC0tPiBbKl1cbiAgICBTdGlsbCAtLT4gTW92aW5nXG4gICAgTW92aW5nIC0tPiBTdGlsbFxuICAgIE1vdmluZyAtLT4gQ3Jhc2hcbiAgICBDcmFzaCAtLT4gWypdIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
+</td></tr>
+<tr>
+    <td><pre>
+stateDiagram
+[*] --> Still
+Still --> [*]
+Still --> Moving
+Moving --> Still
+Moving --> Crash
+Crash --> [*]
+</pre></td>
+    <td align="center">
+        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-state.png" />
+    </td>
+</tr>
+<!-- </State> -->
+<!-- <Pie> -->
+<tr><td colspan=2 align="center">
+    <b>Pie</b><br />
+    [<a href="http://mermaid-js.github.io/mermaid/#/pie">docs</a> - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoicGllXG5cIkRvZ3NcIiA6IDQyLjk2XG5cIkNhdHNcIiA6IDUwLjA1XG5cIlJhdHNcIiA6IDEwLjAxIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0">live editor</a>]
+</td></tr>
+<tr>
+    <td><pre>
+pie
+"Dogs" : 386
+"Cats" : 85
+"Rats" : 15 
+</pre></td>
+    <td align="center">
+        <img src="https://raw.githubusercontent.com/mermaid-js/mermaid/master/img/gray-pie.png" />
+    </td>
+</tr>
+<!-- </Pie> -->
+<!-- <Git> -->
+<tr><td colspan=2 align="center">
+    <b>Git</b><br />
+    [experimental - <a href="https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZ2l0R3JhcGg6XG5vcHRpb25zXG57XG4gICAgXCJub2RlU3BhY2luZ1wiOiAxNTAsXG4gICAgXCJub2RlUmFkaXVzXCI6IDEwXG59XG5lbmRcbmNvbW1pdFxuYnJhbmNoIG5ld2JyYW5jaFxuY2hlY2tvdXQgbmV3YnJhbmNoXG5jb21taXRcbmNvbW1pdFxuY2hlY2tvdXQgbWFzdGVyXG5jb21taXRcbmNvbW1pdFxubWVyZ2UgbmV3YnJhbmNoXG4iLCJtZXJtYWlkIjp7InRoZW1lIjoiZGVmYXVsdCJ9fQ">live editor</a>]
+</td></tr>
+<tr>
+    <td colspan="2" align="center"><i>Coming soon!</i></td>
+</tr>
+<!-- </Git> -->
+</table>
 
-![Git graph](./img/git.png)
+## Related projects 
 
-## Installation
+- [Command Line Interface](https://github.com/mermaid-js/mermaid.cli)
+- [Live Editor](https://github.com/mermaid-js/mermaid-live-editor)
 
-### CDN
+# Contributors [![Help wanted](https://img.shields.io/github/labels/mermaid-js/mermaid/Help%20wanted!)](https://github.com/mermaid-js/mermaid/issues?q=is%3Aissue+is%3Aopen+label%3A%22Help+wanted%21%22) [![Contributors](https://img.shields.io/github/contributors/mermaid-js/mermaid)](https://github.com/mermaid-js/mermaid/graphs/contributors) [![Commits](https://img.shields.io/github/commit-activity/m/mermaid-js/mermaid)](https://github.com/mermaid-js/mermaid/graphs/contributors)
 
-```
-https://unpkg.com/mermaid@<version>/dist/
-```
+Mermaid is a growing community and is always accepting new contributors. There's a lot of different ways to help out and we're always looking for extra hands! Look at [this issue](https://github.com/mermaid-js/mermaid/issues/866) if you want to know where to start helping out.
 
-Replace `<version>` with expected version number.
+Detailed information about how to contribute can be found in the [contribution guide](CONTRIBUTING.md)
 
-Example: https://unpkg.com/mermaid@7.1.0/dist/
+# Appreciation
+A quick note from Knut Sveidqvist:
+>*Many thanks to the [d3](http://d3js.org/) and [dagre-d3](https://github.com/cpettitt/dagre-d3) projects for providing the graphical layout and drawing libraries!*
+>*Thanks also to the [js-sequence-diagram](http://bramp.github.io/js-sequence-diagrams) project for usage of the grammar for the sequence diagrams. Thanks to Jessica Peter for inspiration and starting point for gantt rendering.*
+>*Thank you to [Tyler Long](https://github.com/tylerlong) who has been a collaborator since April 2017.*
+>
+>*Thank you to the ever-growing list of [contributors](https://github.com/knsv/mermaid/graphs/contributors) that brought the project this far!*
 
-### Node.js
+---
 
-```
-yarn add mermaid
-```
-
-## Documentation
-
-https://mermaidjs.github.io
-
-## Sibling projects
-
-- [mermaid CLI](https://github.com/mermaidjs/mermaid.cli)
-- [mermaid live editor](https://github.com/mermaidjs/mermaid-live-editor)
-- [mermaid webpack demo](https://github.com/mermaidjs/mermaid-webpack-demo)
-- [mermaid Parcel demo](https://github.com/mermaidjs/mermaid-parcel-demo)
-
-## Request for assistance
-
-Things are piling up and I have a hard time keeping up. To remedy this
-it would be great if we could form a core team of developers to cooperate
-with the future development of mermaid.
-
-As part of this team you would get write access to the repository and would
-represent the project when answering questions and issues.
-
-Together we could continue the work with things like:
-
-- Adding more types of diagrams like mindmaps, ert diagrams, etc.
-- Improving existing diagrams
-
-Don't hesitate to contact me if you want to get involved.
-
-## For contributors
-
-### Setup
-
-```
-yarn install
-```
-
-### Build
-
-```
-yarn build:watch
-```
-
-### Lint
-
-```
-yarn lint
-```
-
-We use [eslint](https://eslint.org/).
-We recommend you installing [editor plugins](https://eslint.org/docs/user-guide/integrations) so you can get real time lint result.
-
-### Test
-
-```
-yarn test
-```
-Manual test in browser: open `dist/index.html`
-
-### Release
-
-For those who have the permission to do so:
-
-Update version number in `package.json`.
-
-```
-npm publish
-```
-
-Command above generates files into the `dist` folder and publishes them to npmjs.org.
-
-## Credits
-
-Many thanks to the [d3](http://d3js.org/) and [dagre-d3](https://github.com/cpettitt/dagre-d3) projects for providing the graphical layout and drawing libraries!
-
-Thanks also to the [js-sequence-diagram](http://bramp.github.io/js-sequence-diagrams) project for usage of the grammar for the sequence diagrams. Thanks to Jessica Peter for inspiration and starting point for gantt rendering.
-
-_Mermaid was created by Knut Sveidqvist for easier documentation._
-
-_[Tyler Long](https://github.com/tylerlong) has became a collaborator since April 2017._
-
-Here is the full list of the projects [contributors](https://github.com/knsv/mermaid/graphs/contributors).
+*Mermaid was created by Knut Sveidqvist for easier documentation.*

From 9a6e4ba77fe9e906d71c1f7dc0fd379c5a29d3bf Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Tue, 10 Mar 2020 19:14:46 -0700
Subject: [PATCH 26/34] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 781cee7e1..83fe09ec7 100644
--- a/README.md
+++ b/README.md
@@ -20,7 +20,7 @@ For more information and help in getting started, please view our [documentation
 
 With version 8.4 class diagrams have got some new features, bug fixes and documentation. Another new feature in 8.4 is the new diagram type, state diagrams.
 
-![Image show the two new diagram types](.docs/img/new-diagrams.png)
+![Image show the two new diagram types](./docs/img/new-diagrams.png)
 
 ## Special note regarding version 8.2
 

From e6910d3c5208b6f39b5589331764b6fbd38ad373 Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Tue, 10 Mar 2020 19:15:44 -0700
Subject: [PATCH 27/34] Update SUMMARY.md

---
 docs/SUMMARY.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md
index f40657a49..e4be903f9 100644
--- a/docs/SUMMARY.md
+++ b/docs/SUMMARY.md
@@ -1,6 +1,6 @@
 # Summary
 
-- [mermaid-README](README.md)
+- [mermaid](README.md)
 - [FAQ](faq.md)
 - [Breaking changes](breakingChanges.md)
 - [Usage](usage.md)

From 71e0a788d1d6de7abcffaead10c21789fe3180e3 Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Tue, 10 Mar 2020 19:16:24 -0700
Subject: [PATCH 28/34] Update mermaidAPI.md

---
 docs/mermaidAPI.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/docs/mermaidAPI.md b/docs/mermaidAPI.md
index bd4f3787f..7b7b68e06 100644
--- a/docs/mermaidAPI.md
+++ b/docs/mermaidAPI.md
@@ -2,13 +2,14 @@
 
 ## mermaidAPI
 
-This API can  be used optionally handle the integration  of mermaid to a web page, instead of using the default integration methods provided by mermaid.js.
+This is the api to be used when optionally handling the integration with the web page, instead of using the default integration provided by mermaid.js.
 
-The core of this api is the [**render**][1] function which, renders the given text based input to a graph/diagram, that is returned as an svg element.
+The core of this api is the [**render**][1] function which, given a graph
+definition as text, renders the graph/diagram and returns an svg element for the graph.
 
-After it is rendered, it is is then up to the user of the API to make use of the svg, which can be either inserted somewhere in the page or something else altogether.
+It is is then up to the user of the API to make use of the svg, either insert it somewhere in the page or do something completely different.
 
-In addition to the render function, a number of behavioral configuration options are also available.
+In addition to the render function, a number of behavioral configuration options are available.
 
 ## Configuration
 

From a9570f7298b88358e320ab5ae9b34859d910f75f Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Tue, 10 Mar 2020 19:24:55 -0700
Subject: [PATCH 29/34] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 83fe09ec7..781cee7e1 100644
--- a/README.md
+++ b/README.md
@@ -20,7 +20,7 @@ For more information and help in getting started, please view our [documentation
 
 With version 8.4 class diagrams have got some new features, bug fixes and documentation. Another new feature in 8.4 is the new diagram type, state diagrams.
 
-![Image show the two new diagram types](./docs/img/new-diagrams.png)
+![Image show the two new diagram types](.docs/img/new-diagrams.png)
 
 ## Special note regarding version 8.2
 

From 83c6aef0783d3bfce2fb49dbd9a957a81fa4e687 Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Tue, 10 Mar 2020 19:26:26 -0700
Subject: [PATCH 30/34] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 781cee7e1..83fe09ec7 100644
--- a/README.md
+++ b/README.md
@@ -20,7 +20,7 @@ For more information and help in getting started, please view our [documentation
 
 With version 8.4 class diagrams have got some new features, bug fixes and documentation. Another new feature in 8.4 is the new diagram type, state diagrams.
 
-![Image show the two new diagram types](.docs/img/new-diagrams.png)
+![Image show the two new diagram types](./docs/img/new-diagrams.png)
 
 ## Special note regarding version 8.2
 

From d2685f2544642f7394527f154bd7c6016c19a654 Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Tue, 10 Mar 2020 19:42:11 -0700
Subject: [PATCH 31/34] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 83fe09ec7..781cee7e1 100644
--- a/README.md
+++ b/README.md
@@ -20,7 +20,7 @@ For more information and help in getting started, please view our [documentation
 
 With version 8.4 class diagrams have got some new features, bug fixes and documentation. Another new feature in 8.4 is the new diagram type, state diagrams.
 
-![Image show the two new diagram types](./docs/img/new-diagrams.png)
+![Image show the two new diagram types](.docs/img/new-diagrams.png)
 
 ## Special note regarding version 8.2
 

From 96b8dce9821c0f1a40cdaaf37978e4e86af84356 Mon Sep 17 00:00:00 2001
From: Neil Cuzon <58763315+NeilCuzon@users.noreply.github.com>
Date: Wed, 11 Mar 2020 18:59:06 -0700
Subject: [PATCH 32/34] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 781cee7e1..83fe09ec7 100644
--- a/README.md
+++ b/README.md
@@ -20,7 +20,7 @@ For more information and help in getting started, please view our [documentation
 
 With version 8.4 class diagrams have got some new features, bug fixes and documentation. Another new feature in 8.4 is the new diagram type, state diagrams.
 
-![Image show the two new diagram types](.docs/img/new-diagrams.png)
+![Image show the two new diagram types](./docs/img/new-diagrams.png)
 
 ## Special note regarding version 8.2
 

From 10583610bda772ce82645c333bc8ecc8ce09f379 Mon Sep 17 00:00:00 2001
From: Knut Sveidqvist <knut.sveidqvist@ipiccolo.com>
Date: Sat, 14 Mar 2020 08:36:49 +0100
Subject: [PATCH 33/34] Lint fixes

---
 src/diagrams/flowchart-v2/flowRenderer.js | 1 -
 src/experimental.js                       | 1 -
 2 files changed, 2 deletions(-)

diff --git a/src/diagrams/flowchart-v2/flowRenderer.js b/src/diagrams/flowchart-v2/flowRenderer.js
index 10250a16c..1baeeb9ad 100644
--- a/src/diagrams/flowchart-v2/flowRenderer.js
+++ b/src/diagrams/flowchart-v2/flowRenderer.js
@@ -1,6 +1,5 @@
 import graphlib from 'graphlib';
 import * as d3 from 'd3';
-import dagre from 'dagre';
 
 import flowDb from '../flowchart/flowDb';
 import flow from '../flowchart/parser/flow';
diff --git a/src/experimental.js b/src/experimental.js
index d34de469d..e6c3bd806 100644
--- a/src/experimental.js
+++ b/src/experimental.js
@@ -1,5 +1,4 @@
 import dagre from 'dagre';
-import graphlib from 'graphlib';
 
 // Create a new directed graph
 var g = new dagre.graphlib.Graph({ compound: true });

From d86a7ccf3ef38612942e8dd0ffd96428d2dafaa7 Mon Sep 17 00:00:00 2001
From: Knut Sveidqvist <knut.sveidqvist@ipiccolo.com>
Date: Sat, 14 Mar 2020 08:49:30 +0100
Subject: [PATCH 34/34] Restoring docs README

---
 docs/README.md | 237 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 237 insertions(+)
 create mode 100644 docs/README.md

diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 000000000..4fb40e62b
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,237 @@
+# Mermaid
+
+[![Build Status](https://travis-ci.org/mermaid-js/mermaid.svg?branch=master)](https://travis-ci.org/mermaid-js/mermaid)
+[![Coverage Status](https://coveralls.io/repos/github/knsv/mermaid/badge.svg?branch=master)](https://coveralls.io/github/knsv/mermaid?branch=master)
+[![Join the chat at https://gitter.im/knsv/mermaid](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/knsv/mermaid?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+
+![banner](./img/header.png)
+
+Generation of diagrams and flowcharts from text in a similar manner as markdown.
+
+Ever wanted to simplify documentation and avoid heavy tools like Visio when explaining your code?
+
+This is why mermaid was born, a simple markdown-like script language for generating charts from text via javascript.
+
+Check out the list of [Integrations and Usages of Mermaid](./integrations.md)
+
+**Mermaid was nominated and won the JS Open Source Awards (2019) in the category "The most exciting use of technology"!!! Thanks to all involved, people committing pull requests, people answering questions and special thanks to Tyler Long who is helping me maintain the project.**
+
+## New diagrams in 8.4
+
+With version 8.4 class diagrams have got some new features, bug fixes and documentation. Another new feature in 8.4 is the new diagram type, state diagrams.
+
+![Image show the two new diagram types](./img/new-diagrams.png)
+
+## Special note regarding version 8.2
+
+In version 8.2 a security improvement was introduced. A securityLevel configuration was introduced which sets the level of trust to be used on the parsed diagrams.
+
+- **true**: (default) tags in text are encoded, click functionality is disabled
+- false: tags in text are allowed, click functionality is enabled
+
+Closed issues:
+
+⚠️ **Note** : This changes the default behaviour of mermaid so that after upgrade to 8.2, if the securityLevel is not configured, tags in flowcharts are encoded as tags and clicking is prohibited.
+
+If your application is taking resposibility for the diagram source security you can set the securityLevel accordingly. By doing this clicks and tags are again allowed.
+
+```javascript
+mermaidAPI.initialize({
+    securityLevel: 'loose'
+});
+```
+
+**🖖 Keep a steady pulse: mermaid needs more Collaborators [#866](https://github.com/knsv/mermaid/issues/866)**
+
+## Diagrams
+
+### Flowchart
+
+```
+graph TD;
+    A-->B;
+    A-->C;
+    B-->D;
+    C-->D;
+```
+
+![Flowchart](./img/flow.png)
+
+### Sequence diagram
+
+```
+sequenceDiagram
+    participant Alice
+    participant Bob
+    Alice->>John: Hello John, how are you?
+    loop Healthcheck
+        John->>John: Fight against hypochondria
+    end
+    Note right of John: Rational thoughts <br/>prevail!
+    John-->>Alice: Great!
+    John->>Bob: How about you?
+    Bob-->>John: Jolly good!
+```
+
+![Sequence diagram](./img/sequence.png)
+
+### Gantt diagram
+
+```
+gantt
+dateFormat  YYYY-MM-DD
+title Adding GANTT diagram to mermaid
+excludes weekdays 2014-01-10
+
+section A section
+Completed task            :done,    des1, 2014-01-06,2014-01-08
+Active task               :active,  des2, 2014-01-09, 3d
+Future task               :         des3, after des2, 5d
+Future task2               :         des4, after des3, 5d
+```
+
+![Gantt diagram](./img/gantt.png)
+
+### Class diagram - :exclamation: experimental
+
+```
+classDiagram
+Class01 <|-- AveryLongClass : Cool
+Class03 *-- Class04
+Class05 o-- Class06
+Class07 .. Class08
+Class09 --> C2 : Where am i?
+Class09 --* C3
+Class09 --|> Class07
+Class07 : equals()
+Class07 : Object[] elementData
+Class01 : size()
+Class01 : int chimp
+Class01 : int gorilla
+Class08 <--> C2: Cool label
+```
+
+![Class diagram](./img/class.png)
+
+### Git graph - :exclamation: experimental
+
+```
+gitGraph:
+options
+{
+    "nodeSpacing": 150,
+    "nodeRadius": 10
+}
+end
+commit
+branch newbranch
+checkout newbranch
+commit
+commit
+checkout master
+commit
+commit
+merge newbranch
+
+```
+
+![Git graph](./img/git.png)
+
+## Installation
+
+### CDN
+
+```
+https://unpkg.com/mermaid@<version>/dist/
+```
+
+Replace `<version>` with expected version number.
+
+Example: https://unpkg.com/mermaid@7.1.0/dist/
+
+### Node.js
+
+```
+yarn add mermaid
+```
+
+## Documentation
+
+https://mermaidjs.github.io
+
+## Sibling projects
+
+- [mermaid CLI](https://github.com/mermaidjs/mermaid.cli)
+- [mermaid live editor](https://github.com/mermaidjs/mermaid-live-editor)
+- [mermaid webpack demo](https://github.com/mermaidjs/mermaid-webpack-demo)
+- [mermaid Parcel demo](https://github.com/mermaidjs/mermaid-parcel-demo)
+
+## Request for assistance
+
+Things are piling up and I have a hard time keeping up. To remedy this
+it would be great if we could form a core team of developers to cooperate
+with the future development of mermaid.
+
+As part of this team you would get write access to the repository and would
+represent the project when answering questions and issues.
+
+Together we could continue the work with things like:
+
+- Adding more types of diagrams like mindmaps, ert diagrams, etc.
+- Improving existing diagrams
+
+Don't hesitate to contact me if you want to get involved.
+
+## For contributors
+
+### Setup
+
+```
+yarn install
+```
+
+### Build
+
+```
+yarn build:watch
+```
+
+### Lint
+
+```
+yarn lint
+```
+
+We use [eslint](https://eslint.org/).
+We recommend you installing [editor plugins](https://eslint.org/docs/user-guide/integrations) so you can get real time lint result.
+
+### Test
+
+```
+yarn test
+```
+Manual test in browser: open `dist/index.html`
+
+### Release
+
+For those who have the permission to do so:
+
+Update version number in `package.json`.
+
+```
+npm publish
+```
+
+Command above generates files into the `dist` folder and publishes them to npmjs.org.
+
+## Credits
+
+Many thanks to the [d3](http://d3js.org/) and [dagre-d3](https://github.com/cpettitt/dagre-d3) projects for providing the graphical layout and drawing libraries!
+
+Thanks also to the [js-sequence-diagram](http://bramp.github.io/js-sequence-diagrams) project for usage of the grammar for the sequence diagrams. Thanks to Jessica Peter for inspiration and starting point for gantt rendering.
+
+_Mermaid was created by Knut Sveidqvist for easier documentation._
+
+_[Tyler Long](https://github.com/tylerlong) has became a collaborator since April 2017._
+
+Here is the full list of the projects [contributors](https://github.com/knsv/mermaid/graphs/contributors).