Docs: add icon explanations

docs/syntax/block.md

@@ -6,6 +6,14 @@
 
 # Block Diagrams Documentation
 
+## Icons
+
+Here is a brief explanation of the icons used in the documentation:
+
+> **Note**
+> 🔥: Indicates newly added diagrams.<br>
+> -beta: Marks diagrams with experimental syntax that might change over time.
+
 ## Introduction to Block Diagrams
 
 ```mermaid-example

docs/syntax/xyChart.md

@@ -6,6 +6,14 @@
 
 # XY Chart
 
+## Icons
+
+Here is a brief explanation of the icons used in the documentation:
+
+> **Note**
+> 🔥: Indicates newly added diagrams.<br>
+> -beta: Marks diagrams with experimental syntax that might change over time.
+
 > In the context of mermaid-js, the XY chart is a comprehensive charting module that encompasses various types of charts that utilize both x-axis and y-axis for data representation. Presently, it includes two fundamental chart types: the bar chart and the line chart. These charts are designed to visually display and analyze data that involve two numerical variables.
 
 > It's important to note that while the current implementation of mermaid-js includes these two chart types, the framework is designed to be dynamic and adaptable. Therefore, it has the capacity for expansion and the inclusion of additional chart types in the future. This means that users can expect an evolving suite of charting options within the XY chart module, catering to various data visualization needs as new chart types are introduced over time.

packages/mermaid/src/docs/syntax/block.md

@@ -5,6 +5,15 @@ outline: 'deep' # shows all h3 headings in outline in Vitepress
 
 # Block Diagrams Documentation
 
+## Icons
+
+Here is a brief explanation of the icons used in the documentation:
+
+```note
+🔥: Indicates newly added diagrams.<br>
+-beta: Marks diagrams with experimental syntax that might change over time.
+```
+
 ## Introduction to Block Diagrams
 
 ```mermaid

packages/mermaid/src/docs/syntax/xyChart.md

@@ -1,5 +1,14 @@
 # XY Chart
 
+## Icons
+
+Here is a brief explanation of the icons used in the documentation:
+
+```note
+🔥: Indicates newly added diagrams.<br>
+-beta: Marks diagrams with experimental syntax that might change over time.
+```
+
 > In the context of mermaid-js, the XY chart is a comprehensive charting module that encompasses various types of charts that utilize both x-axis and y-axis for data representation. Presently, it includes two fundamental chart types: the bar chart and the line chart. These charts are designed to visually display and analyze data that involve two numerical variables.
 
 > It's important to note that while the current implementation of mermaid-js includes these two chart types, the framework is designed to be dynamic and adaptable. Therefore, it has the capacity for expansion and the inclusion of additional chart types in the future. This means that users can expect an evolving suite of charting options within the XY chart module, catering to various data visualization needs as new chart types are introduced over time.