Improve helper motions and documentation

1 files changed, 17 insertions, 3 deletions

diff --git a/doc/hackernews.txt b/doc/hackernews.txt
index b382245..2031efd 100644
--- a/doc/hackernews.txt
+++ b/doc/hackernews.txt
@@ -9,14 +9,28 @@ Version: 0.1.1
 BASIC USAGE                                     *hackernews-usage*
 
 * Open the Hacker News front page in Vim by executing the `:HackerNews` command
-* Move between items on the front page with uppercase `J` and `K`
 * Press lowercase `o` to open links in Vim
 * Press uppercase `O` to open links in default web browser
-* Press lowercase `u` to go back (or whatever you've remapped `undo` to)
-* Press `Ctrl+r` to go forward (or whatever you're remapped `redo` to)
+* Numbered lines with story titles on the front page link to the story url
+* Comment lines on the front page link to the comments url
+* Press lowercase `u` to go back
+* Press `Ctrl+r` to go forward
 * Execute the `:bd` command to close and remove the Hacker News buffer
 
 
+ENHANCED MOTIONS                                *hackernews-motions*
+
+Uppercase `J` and `K` are mapped to helpful new motions based on what type of
+content is on the screen:
+
+* Move to next/prev item when viewing the front page. (If the cursor is on a
+  numbered line with story title the cursor will move to the next/prev numbered
+  line with story title. If the cursor is on a comment line it will move to the
+  next/prev comment line.)
+* Move to next/prev comment when viewing comments.
+* Move to next/prev paragraph when viewing the text version of articles.
+
+
 COMMANDS                                        *hackernews-commands*
 
 :HackerNews             Open Hacker News front page stories in Vim