<p><b>@ntrel</b> commented on this pull request.</p>

<p>Haven't tested, but the idea seems great. (To be honest if this works well I don't know why we need the other 2 options besides <em>Show Tree</em>).</p>
<p>I've reviewed the doc changes and made suggestions, not a blocker. If I have time maybe I'll fix those.</p><hr>

<p>In <a href="https://github.com/geany/geany/pull/1813#discussion_r332671068">doc/geany.txt</a>:</p>
<pre style='color:#555'>> @@ -530,6 +530,48 @@ order. It is not alphabetical as shown in the documents list
 See the `Notebook tab keybindings`_ section for useful
 shortcuts including for Most-Recently-Used document switching.
 
+Document list views
+^^^^^^^^^^^^^^^^^^^
+
+There are three different ways to display documents on the sidebar if *Show
+documents list* is active.  To switch between views press the right mouse button
+on documents list and select one of those radio buttons:
</pre>
<p>on <em>the</em> documents list</p>
<p>those radio buttons -> these items<br>
(Users might not know what radio buttons are)</p>

<hr>

<p>In <a href="https://github.com/geany/geany/pull/1813#discussion_r332672563">doc/geany.txt</a>:</p>
<pre style='color:#555'>> +    .. image:: ./images/sidebar_documents_only.png
+
+Show Paths
+    Show open documents as a two-level tree in which first level is the paths
+    of directories containing open files and the second level is the file names of
+    the documents open in that path.  All documents with the same path are grouped
+    together under the same first level item.  Paths are in sorted order and
+    documents are sorted within each group.
+
+    .. image:: ./images/sidebar_show_paths.png
+
+Show Tree
+    Show paths as above, but as a multiple level partial tree.  The tree is only
+    expanded at positions where two or more directory paths to open documents
+    share the same prefix.  The common prefix is shown as a parent level, and
+    the remainer of those paths are shown as child levels.  This applies
</pre>
<p>remainder</p>

<hr>

<p>In <a href="https://github.com/geany/geany/pull/1813#discussion_r332673626">doc/geany.txt</a>:</p>
<pre style='color:#555'>> +    the documents open in that path.  All documents with the same path are grouped
+    together under the same first level item.  Paths are in sorted order and
+    documents are sorted within each group.
+
+    .. image:: ./images/sidebar_show_paths.png
+
+Show Tree
+    Show paths as above, but as a multiple level partial tree.  The tree is only
+    expanded at positions where two or more directory paths to open documents
+    share the same prefix.  The common prefix is shown as a parent level, and
+    the remainer of those paths are shown as child levels.  This applies
+    recursively down the paths making a tree to the file names of open documents,
+    which are grouped in sorted order as an additional level below the last path
+    segment.
+
+    For convenience two common file locations are handled specifically, open
</pre>
<p>specifically, -> specially:</p>

<p style="font-size:small;-webkit-text-size-adjust:none;color:#666;">—<br />You are receiving this because you are subscribed to this thread.<br />Reply to this email directly, <a href="https://github.com/geany/geany/pull/1813?email_source=notifications&email_token=AAIOWJYDV5E5LAVPSO374VTQNTKH7A5CNFSM4EWIWKT2YY3PNVWWK3TUL52HS4DFWFIHK3DMKJSXC5LFON2FEZLWNFSXPKTDN5WW2ZLOORPWSZGOCHI6QXY#pullrequestreview-298969183">view it on GitHub</a>, or <a href="https://github.com/notifications/unsubscribe-auth/AAIOWJ4BKEHMGSZPHINVXKLQNTKH7ANCNFSM4EWIWKTQ">mute the thread</a>.<img src="https://github.com/notifications/beacon/AAIOWJ27CZWRLDC5JTVN3Z3QNTKH7A5CNFSM4EWIWKT2YY3PNVWWK3TUL52HS4DFWFIHK3DMKJSXC5LFON2FEZLWNFSXPKTDN5WW2ZLOORPWSZGOCHI6QXY.gif" height="1" width="1" alt="" /></p>
<script type="application/ld+json">[
{
"@context": "http://schema.org",
"@type": "EmailMessage",
"potentialAction": {
"@type": "ViewAction",
"target": "https://github.com/geany/geany/pull/1813?email_source=notifications\u0026email_token=AAIOWJYDV5E5LAVPSO374VTQNTKH7A5CNFSM4EWIWKT2YY3PNVWWK3TUL52HS4DFWFIHK3DMKJSXC5LFON2FEZLWNFSXPKTDN5WW2ZLOORPWSZGOCHI6QXY#pullrequestreview-298969183",
"url": "https://github.com/geany/geany/pull/1813?email_source=notifications\u0026email_token=AAIOWJYDV5E5LAVPSO374VTQNTKH7A5CNFSM4EWIWKT2YY3PNVWWK3TUL52HS4DFWFIHK3DMKJSXC5LFON2FEZLWNFSXPKTDN5WW2ZLOORPWSZGOCHI6QXY#pullrequestreview-298969183",
"name": "View Pull Request"
},
"description": "View this Pull Request on GitHub",
"publisher": {
"@type": "Organization",
"name": "GitHub",
"url": "https://github.com"
}
}
]</script>