README.md | 26 +++++++++++++-------------
 nnn.1     | 16 +++++++++++++++-

diff --git a/README.md b/README.md
index 838fa76bd9c6b109efba59b9520b01b18d13c7a6..f6abc30c0829057da88cbd8e9bfbcc8e07c9f2dd 100644
--- a/README.md
+++ b/README.md
@@ -49,6 +49,7 @@ - [Shell completion](#shell-completion)
 - [Usage](#usage)
   - [Cmdline options](#cmdline-options)
   - [Keyboard shortcuts](#keyboard-shortcuts)
+  - [Contexts](#contexts)
   - [Filters](#filters)
   - [Navigate-as-you-type mode](#navigate-as-you-type-mode)
   - [File indicators](#file-indicators)
@@ -57,7 +58,6 @@   - [Help](#help)
 - [Quickstart](#quickstart)
 - [How to](#how-to)
   - [add bookmarks](#add-bookmarks)
-  - [contexts](#contexts)
   - [copy file paths](#copy-file-paths)
     - [selection shortcuts](#selection-shortcuts)
     - [default copy](#default-copy)
@@ -258,6 +258,18 @@ ```
 
 Help & settings, file details, media info and archive listing are shown in the PAGER. Please use the PAGER-specific keys in these screens.
 
+#### Contexts
+
+Contexts (aka _tabs_ aka _workspaces_) serve the purpose of exploring multiple directories in parallel. `nnn` provides 4 contexts simultaneously. The status of the contexts are shown in the top left corner:
+
+- the current context is in reverse
+- other used contexts are underlined
+- rest are unused
+
+The bookmark prompt understands contexts. To switch contexts press `^B` and enter the context number (1-4).
+
+The first time a context is entered, it copies the state of the last visited context. Each context remembers its start directory and last visited directory.
+
 #### Filters
 
 Filters support regexes to instantly (search-as-you-type) list the matching entries in the current directory.
@@ -342,18 +354,6 @@
     export NNN_BMS='doc:~/Documents;u:/home/user/Cam Uploads;D:~/Downloads/'
 
 The bookmark prompt also understands the <kbd>~</kbd> (HOME), <kbd>-</kbd> (last visited directory) and <kbd>&</kbd> (start directory) shortcuts.
-
-#### contexts
-
-Contexts (aka _tabs_ aka _workspaces_) serve the purpose of exploring multiple directories in parallel. `nnn` provides 4 contexts simultaneously. The status of the contexts are shown in the top left corner:
-
-- the current context is in reverse
-- other used contexts are underlined
-- rest are unused
-
-The bookmark prompt understands contexts. To switch contexts press `^B` and enter the context number (1-4).
-
-The first time a context is entered, it copies the state of the last visited context. Each context remembers its start directory and last visited directory.
 
 #### copy file paths
 
diff --git a/nnn.1 b/nnn.1
index 73183d34390252c0e6610cd054eb9875fe5366b9..37ca998e552937a26928204c88e84c4f6406e75b 100644
--- a/nnn.1
+++ b/nnn.1
@@ -166,7 +166,7 @@ .Nm
 uses \fIxdg-open\fR (on Linux) and \fIopen(1)\fR (on OS X) as the desktop
 opener. It invokes
 .Pa nlay
-to run desktop search utility or terminal locker. Read more on
+to run the terminal locker. Read more on
 .Pa nlay
 at:
 .br
@@ -180,6 +180,20 @@ .Nm
 to change to the last visited directory on quit requires shell integration in a
 few easy steps. Please visit the project page (linked below) for the
 instructions.
+.Sh CONTEXTS
+Contexts (aka \fItabs\fR aka \fIworkspaces\fR) serve the purpose of exploring multiple directories in parallel.
+.Nm
+provides 4 contexts simultaneously. The status of the contexts are shown in the top left corner:
+.Pp
+- the current context is in reverse
+.br
+- other used contexts are underlined
+.br
+- rest are unused
+.Pp
+The bookmark prompt understands contexts. To switch contexts press \fI^B\fR and enter the context number (1-4).
+.Pp
+The first time a context is entered, it copies the state of the last visited context. Each context remembers its start directory and last visited directory.
 .Sh FILTERS
 Filters support regexes to instantly (search-as-you-type) list the matching
 entries in the current directory.