diff --git a/docs/n00b-overview.md b/docs/n00b-overview.md index 08bd754db..44d7b8d8b 100644 --- a/docs/n00b-overview.md +++ b/docs/n00b-overview.md @@ -2,27 +2,27 @@ **Explaining with a Diagram** -A picture is worth a thousand words, a good diagram is certainly worth more. +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 make, edit and maintain good visualizations. +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 both very important but also become obsolete/inaccurate very fast. This catch-22 hobbles the productivity of teams. +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 that. mermaid creates diagrams using markdown inspired syntax. The process is quicker, less complicated and more convenient way of going from concept to visualization +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. -This is a relatively straightforward solution to a major hurdle in software teams. +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 deffinitions inside `