From 566576d709ec0c3dfa8a76a226c99015e5dd7021 Mon Sep 17 00:00:00 2001 From: Nikolay Rozhkov Date: Sat, 12 Aug 2023 02:36:15 +0300 Subject: [PATCH] Cleaning up unused files and comments --- .../mermaid/src/docs/.vitepress/config.ts | 34 ---------- .../src/docs/community/n00b-overview.md | 68 ------------------- 2 files changed, 102 deletions(-) delete mode 100644 packages/mermaid/src/docs/community/n00b-overview.md diff --git a/packages/mermaid/src/docs/.vitepress/config.ts b/packages/mermaid/src/docs/.vitepress/config.ts index fcf20dec246..a3c2f06e019 100644 --- a/packages/mermaid/src/docs/.vitepress/config.ts +++ b/packages/mermaid/src/docs/.vitepress/config.ts @@ -203,40 +203,6 @@ function sidebarCommunity() { ]; } -// Development and Contributing -// function sidebarCommunityDevelopContribute() { -// const page_path = '/community/development'; -// return [ -// { -// text: 'Contributing to Mermaid', -// link: page_path + '#contributing-to-mermaid', -// collapsed: false, -// items: [ -// { -// text: 'Technical Requirements and Setup', -// link: pathToId(page_path, 'technical-requirements-and-setup'), -// }, -// { -// text: 'Contributing Code', -// link: pathToId(page_path, 'contributing-code'), -// }, -// { -// text: 'Contributing Documentation', -// link: pathToId(page_path, 'contributing-documentation'), -// }, -// { -// text: 'Questions or Suggestions?', -// link: pathToId(page_path, 'questions-or-suggestions'), -// }, -// { -// text: 'Last Words', -// link: pathToId(page_path, 'last-words'), -// }, -// ], -// }, -// ]; -// } - function sidebarNews() { return [ { diff --git a/packages/mermaid/src/docs/community/n00b-overview.md b/packages/mermaid/src/docs/community/n00b-overview.md deleted file mode 100644 index bf142f40de1..00000000000 --- a/packages/mermaid/src/docs/community/n00b-overview.md +++ /dev/null @@ -1,68 +0,0 @@ -# Overview for Beginners - -**Explaining with a Diagram** - -A picture is worth a thousand words, a good diagram is undoubtedly worth more. They make understanding easier. - -## Creating and Maintaining Diagrams - -Anyone who has used Visio, or (God Forbid) Excel to make a Gantt Chart, knows how hard it is to create, edit and maintain good visualizations. - -Diagrams/Charts are significant but also become obsolete/inaccurate very fast. This catch-22 hobbles the productivity of teams. - -## Doc Rot in Diagrams - -Doc-Rot kills diagrams as quickly as it does text, but it takes hours in a desktop application to produce a diagram. - -Mermaid seeks to change using markdown-inspired syntax. The process is a quicker, less complicated, and more convenient way of going from concept to visualization. - -It is a relatively straightforward solution to a significant hurdle with the software teams. - -## Definition of Terms/ Dictionary - -**Mermaid text definitions can be saved for later reuse and editing.** - -> These are the Mermaid diagram definitions inside `
` tags, with the `class=mermaid`. - -```html -
-    graph TD
-    A[Client] --> B[Load Balancer]
-    B --> C[Server01]
-    B --> D[Server02]
-
-``` - -**render** - -> This is the core function of the Mermaid API. It reads all the `Mermaid Definitions` inside `div` tags and returns an SVG file, based on the definition. - -**Nodes** - -> These are the boxes that contain text or otherwise discrete pieces of each diagram, separated generally by arrows, except for Gantt Charts and User Journey Diagrams. They will be referred often in the instructions. Read for Diagram Specific [Syntax](../intro/n00b-syntaxReference.md) - -## Advantages of using Mermaid - -- Ease to generate, modify and render diagrams when you make them. -- The number of integrations and plugins it has. -- You can add it to your or companies website. -- Diagrams can be created through comments like this in a script: - -## The catch-22 of Diagrams and Charts: - -**Diagramming and charting is a large waste of developer's time, but not having diagrams ruins productivity.** - -Mermaid solves this by reducing the time and effort required to create diagrams and charts. - -Because, the text base for the diagrams allows it to be updated easily. Also, it can be made part of production scripts (and other pieces of code). So less time is spent on documenting, as a separate task. - -## Catching up with Development - -Being based on markdown, Mermaid can be used, not only by accomplished front-end developers, but by most computer savvy people to render diagrams, at much faster speeds. -In fact one can pick up the syntax for it quite easily from the examples given and there are many tutorials available in the internet. - -## Mermaid is for everyone. - -Video [Tutorials](https://mermaid.js.org/config/Tutorials.html) are also available for the mermaid [live editor](https://mermaid.live/). - -Alternatively you can use Mermaid [Plug-Ins](https://mermaid-js.github.io/mermaid/#/./integrations), with tools you already use, like Google Docs.