diff --git a/README.md b/README.md
index 38f3b7d..2561ea1 100644
--- a/README.md
+++ b/README.md
@@ -7,10 +7,10 @@ It shows up as a **Tabs** view in the Explorer — drag it wherever you want it,
 
 ## Two ways to use it
 
-**Just the colours.**  colours files by project wherever VS Code shows file
+**Just the colours.** `verticalTabs.decorateFiles` colours files by project wherever VS Code shows file
 decorations — the Explorer, the built-in **Open Editors** view, and the editor tabs. If colour coding is all you
 want, use this and keep the built-in view: it drags to dock, shows file icons, and can focus every kind of tab.
-Set it to  to add a two-letter project badge such as  for .
+Set it to `colorAndBadge` to add a two-letter project badge such as `AC` for `Acme.Shop.Client`.
 
 **The Tabs view.** A drawn list that the built-in view cannot be: a project border down each row, real spacing,
 and file names that keep their extension. Costs drag-and-drop and file icons — see *Known limitations*.
@@ -54,8 +54,10 @@ the close button replaces on hover.
 - `verticalTabs.colorByProject` — colour each row's left border by project (default `true`)
 - `verticalTabs.borderWidth` — width of that border in pixels (default `3`)
 - `verticalTabs.rowSpacing` — pixels between rows (default `2`)
-- `verticalTabs.showProject` — also show the project name as text (default `true`)
-- `verticalTabs.showDirectory` — also show the directory as text (default `true`)
+- `verticalTabs.showProject` — also show the project name as text (default `true`); turn it off and the file
+  name gets the whole row, with the border still telling you the project
+- `verticalTabs.showDirectory` — when to show the directory: `never`, `duplicates` (default — only when two
+  open tabs share a file name), or `always`
 - `verticalTabs.allGroups` — list every editor group, not just the active one (default `true`)
 - `verticalTabs.projectFiles` — file names or extensions that mark a project root
 
@@ -77,6 +79,13 @@ The twelve project colours are theme colours (`verticalTabs.project1` … `proje
   icon set, since a webview cannot reach the active file-icon theme.
 - Rows are drawn rather than native, so they do not pick up list styling from every theme the way a tree view
   would, and there is no native drag-and-drop.
+- **Drag to dock is not possible in this view, at all.** Dragging a row into the editor area needs
+  `TreeDragAndDropController` and its `text/uri-list` support, which only tree views have — a drag started
+  inside a webview iframe cannot be handed to the workbench. If dragging matters more than the borders and
+  spacing, use `decorateFiles` with the built-in Open Editors view instead.
+- Decorations colour the Explorer as well as the Open Editors view; there is no way to target one. Git also
+  decorates modified files and only one colour wins, so a dirty file may show Git's colour rather than its
+  project's.
 
 ## Tests