feat(docs): improve include note

docs/User Guide/!!!meta.json

@@ -4594,6 +4594,13 @@
                                                     "value": "s8alTXmpFR61",
                                                     "isInheritable": false,
                                                     "position": 70
+                                                },
+                                                {
+                                                    "type": "label",
+                                                    "name": "iconClass",
+                                                    "value": "bx bxs-file-image",
+                                                    "isInheritable": false,
+                                                    "position": 80
                                                 }
                                             ],
                                             "format": "markdown",
@@ -4619,6 +4626,43 @@
                                         }
                                     ]
                                 },
+                                {
+                                    "isClone": false,
+                                    "noteId": "nBAXQFj20hS1",
+                                    "notePath": [
+                                        "pOsGYCXsbNQG",
+                                        "KSZ04uQ2D1St",
+                                        "iPIMuisry3hd",
+                                        "nBAXQFj20hS1"
+                                    ],
+                                    "title": "Include Note",
+                                    "notePosition": 60,
+                                    "prefix": null,
+                                    "isExpanded": false,
+                                    "type": "text",
+                                    "mime": "text/html",
+                                    "attributes": [
+                                        {
+                                            "type": "relation",
+                                            "name": "internalLink",
+                                            "value": "nRhnJkTT8cPs",
+                                            "isInheritable": false,
+                                            "position": 10
+                                        }
+                                    ],
+                                    "format": "markdown",
+                                    "dataFileName": "Include Note.md",
+                                    "attachments": [
+                                        {
+                                            "attachmentId": "GoLuBbQUYIQE",
+                                            "title": "image.png",
+                                            "role": "image",
+                                            "mime": "image/png",
+                                            "position": 10,
+                                            "dataFileName": "Include Note_image.png"
+                                        }
+                                    ]
+                                },
                                 {
                                     "isClone": false,
                                     "noteId": "QEAPj01N5f7w",
@@ -4629,7 +4673,7 @@
                                         "QEAPj01N5f7w"
                                     ],
                                     "title": "Links",
-                                    "notePosition": 60,
+                                    "notePosition": 70,
                                     "prefix": null,
                                     "isExpanded": false,
                                     "type": "text",
@@ -4685,7 +4729,7 @@
                                         "S6Xx8QIWTV66"
                                     ],
                                     "title": "Lists",
-                                    "notePosition": 70,
+                                    "notePosition": 80,
                                     "prefix": null,
                                     "isExpanded": false,
                                     "type": "text",
@@ -5931,6 +5975,13 @@
                                     "value": "0ESUbbAxVnoK",
                                     "isInheritable": false,
                                     "position": 120
+                                },
+                                {
+                                    "type": "relation",
+                                    "name": "internalLink",
+                                    "value": "nBAXQFj20hS1",
+                                    "isInheritable": false,
+                                    "position": 130
                                 }
                             ],
                             "format": "markdown",

docs/User Guide/User Guide/Note Types/File.md

@@ -82,8 +82,8 @@ If the file could not be identified as any of the supported file types from abov
 *   It is **not** possible to change the note type of a _File_ note.
 *   Convert into an [attachment](../Basic%20Concepts%20and%20Features/Notes/Attachments.md) from the [note menu](../Basic%20Concepts%20and%20Features/UI%20Elements/Note%20buttons.md).
 
-## Note list
+## Relation with other notes
 
-Files are also displayed in the [Note List](../Basic%20Concepts%20and%20Features/Notes/Note%20List.md) based on their type:
-
-![](6_File_image.png)
+*   Files are also displayed in the [Note List](../Basic%20Concepts%20and%20Features/Notes/Note%20List.md) based on their type:![](6_File_image.png)
+*   Non-image files can be embedded into text notes as read-only widgets via the [Include Note](Text/Include%20Note.md) functionality.
+*   Image files can be embedded into text notes like normal images via [Image references](Text/Images/Image%20references.md).

docs/User Guide/User Guide/Note Types/Text.md

@@ -72,10 +72,4 @@ When editing a document that becomes too large, you can split it into sub-notes:
 2.  Create a new sub-note and name it.
 3.  Paste the content from the clipboard into the sub-note.
 
-Trilium can automate this process. Select some text within the note, and in the selection toolbar, click the scissors icon for the "cut & pasted selection to sub-note" action. The heading is automatically detected and the new sub-note is named accordingly. You can also assign a keyboard shortcut for this action. This functionality is available through the block toolbar icon.
-
-## Including a Note
-
-Text notes can "include" another note as a read only widget. This can be useful for e.g. including a dynamically generated chart (from scripts & "render HTML" note) or other more advanced use cases.
-
-This functionality is available in the block toolbar icon.
+Trilium can automate this process. Select some text within the note, and in the selection toolbar, click the scissors icon for the "cut & pasted selection to sub-note" action. The heading is automatically detected and the new sub-note is named accordingly. You can also assign a keyboard shortcut for this action. This functionality is available through the block toolbar icon.

docs/User Guide/User Guide/Note Types/Text/Include Note.md

@@ -0,0 +1,6 @@
+# Include Note
+Text notes can "include" another note as a read-only widget. This can be useful for e.g. including a dynamically generated chart (from scripts & "render HTML" note) or other more advanced use cases.
+
+## Including a note
+
+In the [Formatting toolbar](Formatting%20toolbar.md), look for the ![](Include%20Note_image.png) button. There is also a keyboard shortcut defined for it but it is not allocated by default.