docs(guide): document table functionality

apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note List/Table.html

@@ -0,0 +1,98 @@
+<figure class="image">
+  <img style="aspect-ratio:1050/259;" src="Table_image.png" width="1050"
+  height="259">
+</figure>
+<p>The table view displays information in a grid, where the rows are individual
+  notes and the columns are&nbsp;<a class="reference-link" href="#root/pOsGYCXsbNQG/tC7s2alapj8V/zEY4DaJG4YT5/_help_OFXdgB2nNk1F">Promoted Attributes</a>.
+  In addition, values are editable.</p>
+<h2>Interaction</h2>
+<h3>Creating a new table</h3>
+<p>Right click the&nbsp;<a class="reference-link" href="#root/pOsGYCXsbNQG/gh7bpGYxajRS/Vc8PjrjAGuOp/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and
+  select <em>Insert child note</em> and look for the <em>Table item</em>.</p>
+<h3>Adding columns</h3>
+<p>Each column is a <a href="#root/pOsGYCXsbNQG/tC7s2alapj8V/zEY4DaJG4YT5/_help_OFXdgB2nNk1F">promoted attribute</a> that
+  is defined on the Book note. Ideally, the promoted attributes need to be
+  inheritable in order to show up in the child notes.</p>
+<p>To create a new column, simply press <em>Add new column </em>at the bottom
+  of the table.</p>
+<p>There are also a few predefined columns:</p>
+<ul>
+  <li>The current item number, identified by the <code>#</code> symbol. This simply
+    counts the note and is affected by sorting.</li>
+  <li><a class="reference-link" href="#root/pOsGYCXsbNQG/tC7s2alapj8V/_help_m1lbrzyKDaRB">Note ID</a>,
+    representing the unique ID used internally by Trilium</li>
+  <li>The title of the note.</li>
+</ul>
+<h3>Adding new rows</h3>
+<p>Each row is actually a note that is a child of the book note.</p>
+<p>To create a new note, press <em>Add new row</em> at the bottom of the table.
+  By default it will try to edit the title of the newly created note.</p>
+<p>Alternatively, the note can be created from the<a class="reference-link"
+  href="#root/pOsGYCXsbNQG/gh7bpGYxajRS/Vc8PjrjAGuOp/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;or
+  <a
+  href="#root/pOsGYCXsbNQG/_help_CdNpE2pqjmI6">scripting</a>.</p>
+<h3>Editing data</h3>
+<p>Simply click on a cell within a row to change its value. The change will
+  not only reflect in the table, but also as an attribute of the corresponding
+  note.</p>
+<ul>
+  <li>The editing will respect the type of the promoted attribute, by presenting
+    a normal text box, a number selector or a date selector for example.</li>
+  <li>It also possible to change the title of a note.</li>
+  <li>Editing relations is also possible, by using the note autocomplete.</li>
+</ul>
+<h2>Working with the data</h2>
+<h3>Sorting</h3>
+<p>It is possible to sort the data by the values of a column:</p>
+<ul>
+  <li>To do so, simply click on a column.</li>
+  <li>To switch between ascending or descending sort, simply click again on
+    the same column. The arrow next to the column will indicate the direction
+    of the sort.</li>
+</ul>
+<h3>Reordering and hiding columns</h3>
+<ul>
+  <li>Columns can be reordered by dragging the header of the columns.</li>
+  <li>Columns can be hidden or shown by right clicking on a column and clicking
+    the item corresponding to the column.</li>
+</ul>
+<h3>Reordering rows</h3>
+<p>Notes can be dragged around to change their order. This will also change
+  the order of the note in the&nbsp;<a class="reference-link" href="#root/pOsGYCXsbNQG/gh7bpGYxajRS/Vc8PjrjAGuOp/_help_oPVyFC7WL2Lp">Note Tree</a>.</p>
+<p>Currently, it's possible to reorder notes even if sorting is used, but
+  the result might be inconsistent.</p>
+<h2>Limitations</h2>
+<p>The table functionality is still in its early stages, as such it faces
+  quite a few important limitations:</p>
+<ol>
+  <li>As mentioned previously, the columns of the table are defined as&nbsp;
+    <a
+    class="reference-link" href="#root/pOsGYCXsbNQG/tC7s2alapj8V/zEY4DaJG4YT5/_help_OFXdgB2nNk1F">Promoted Attributes</a>.
+      <ol>
+        <li>But only the promoted attributes that are defined at the level of the
+          Book note are actually taken into consideration.</li>
+        <li>There are plans to recursively look for columns across the sub-hierarchy.</li>
+      </ol>
+  </li>
+  <li>Hierarchy is not yet supported, so the table will only show the items
+    that are direct children of the <em>Book</em> note.</li>
+  <li>Multiple labels and relations are not supported. If a&nbsp;<a class="reference-link"
+    href="#root/pOsGYCXsbNQG/tC7s2alapj8V/zEY4DaJG4YT5/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;is
+    defined with a <em>Multi value</em> specificity, they will be ignored.</li>
+</ol>
+<h2>Use in search</h2>
+<p>The table view can be used in a&nbsp;<a class="reference-link" href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/_help_m523cpzocqaD">Saved Search</a>&nbsp;by
+  adding the <code>#viewType=table</code> attribute.</p>
+<p>Unlike when used in a book, saved searches are not limited to the sub-hierarchy
+  of a note and allows for advanced queries thanks to the power of the&nbsp;
+  <a
+  class="reference-link" href="#root/pOsGYCXsbNQG/gh7bpGYxajRS/wArbEsdSae6g/_help_eIg8jdvaoNNd">Search</a>.</p>
+<p>However, there are also some limitations:</p>
+<ul>
+  <li>It's not possible to reorder notes.</li>
+  <li>It's not possible to add a new row.</li>
+</ul>
+<p>Columns are supported, by being defined as&nbsp;<a class="reference-link"
+  href="#root/pOsGYCXsbNQG/tC7s2alapj8V/zEY4DaJG4YT5/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;to
+  the&nbsp;<a class="reference-link" href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/_help_m523cpzocqaD">Saved Search</a>&nbsp;note.</p>
+<p>Editing is also supported.</p>

apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Note Map.html

@@ -6,4 +6,7 @@
   of the same name:&nbsp;<a href="#root/_help_BCkXAVs63Ttv">Note Map (Link map, Tree map)</a>.</p>
 <p>Once created, the note map will display the relations between notes. Only
   the notes that are part of the parent of the note map will be displayed
-  (including their children).</p>
+  (including their children).</p>
+<p>The labels <code>mapIncludeRelation</code> and <code>mapExcludeRelation</code>,
+  if set, filter the note map to include only the specified relations or
+  to exclude the specified relations, respectively.</p>