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