Help Book: Added sorting, syncing, keyboard shortcuts

Added pages:
- Sorting the timeline
- Syncing accounts
- Keyboard shortcuts

Updated pages:
- On My Mac: added hiding/disabling
- On My Mac: added syncing note
- Adding Feeds: added links
- Various pages, adjusting formatting

Many files touched to make minor content and formatting changes

Technotes/HelpBook/5.0/en/adding-feeds.markdown

@@ -15,33 +15,37 @@ Before you finish, you can choose an alternative name for the feed and where it
 Click ‘Add’ and NetNewsWire will fetch the URL you entered. If you entered an address that’s not a feed, NetNewsWire will search the page and add the feed it finds.
 
 
-## Choosing an alternative name for a feed
+
+Choosing an alternative name for a feed
+---------------------------------------
 
 Feeds specify their own name, but you may want to change it to something easier to remember. ‘Brent’ rather than ‘inessential’, for example. You also change this later in the [feed inspector].
 
 
-## Choosing a feed’s folder
+
+Choosing a feed’s folder
+------------------------
 
 Before you add a feed, you can choose the account and folder where it will be saved. 
 
-This option is especially important if you’re using multiple accounts. You can choose whether to save the subscription to your [On My Mac](on-my-mac.html) account or [Feedbin] account.
+This option is especially important if you’re using multiple accounts. You can choose whether to save the subscription to your [On My Mac](on-my-mac.html) account or [Feedbin](syncing-accounts.html) account.
 
 In either case, if you use folders, you can also choose which one keep the feed in.
 
 
-## What to do when NetNewsWire can’t find a feed
 
-Sometimes NetNewsWire won’t be able to find a feed for a site.  Either the site doesn’t offer a feed, or the feed isn’t advertised in a way that NetNewsWire can find it.
+What to do when NetNewsWire can’t find a feed
+---------------------------------------------
+
+Sometimes NetNewsWire won’t be able to find a feed for a site. Either the site doesn’t offer a feed, or the feed isn’t advertised in a way that NetNewsWire can find it.
 
 You may be able to find a feed manually by visiting the site. There, look for a link to an RSS, Atom or JSON feed. If one exists, you can add this direct URL to NetNewsWire using the process above. Right-click on the link and copy the URL to paste into NetNewsWire.
 
 
-## Other ways to add feeds
 
-### Safari Extension
+Other ways to add feeds
+-----------------------
 
-You can also add a feed from Safari using the [NetNewsWire Safari Extension](safari-extension.html).
+Adding feeds in the NetNewsWire app isn’t the only way. You can also add feeds from Safari using the [NetNewsWire Safari Extension](safari-extension.html).
 
-### Importing an OPML list of feeds
-
-If you have an existing subscription list in OPML format, you can [import those feeds into NetNewsWire](import-opml.html).
+If you have an existing OPML subscription list from another app or service, you can [import those feeds into NetNewsWire](import-opml.html), too.

Technotes/HelpBook/5.0/en/contributing.markdown

@@ -6,10 +6,16 @@ NetNewsWire is open-source and contributions from the community are welcomed.
 
 There are two channels for contributing. There is a Slack group for conducting discussions. For filing tickets, and contributing code or documentation, we use GitHub.
 
-## Slack
+
+
+Slack
+-----
 
 [Join the Slack group](https://join.slack.com/t/netnewswire/shared_invite/enQtNjM4MDA1MjQzMDkzLTNlNjBhOWVhYzdhYjA4ZWFhMzQ1MTUxYjU0NTE5ZGY0YzYwZWJhNjYwNTNmNTg2NjIwYWY4YzhlYzk5NmU3ZTc) to talk with other NetNewsWire users — and to help out, if you’d like to, by testing, coding, writing, providing feedback, or just helping us think things through. Everybody is welcome and encouraged to join.
 
-## GitHub
+
+
+GitHub
+------
 
 The [NetNewsWire project on GitHub](https://github.com/brentsimmons/NetNewsWire) is the place to raise formal issues like bugs and feature requests. If you want to make contributions to NetNewsWire’s code or documentation, please refer to our [contribution guidelines](https://github.com/brentsimmons/NetNewsWire/blob/master/CONTRIBUTING.md) page on GitHub.

Technotes/HelpBook/5.0/en/deleting-feeds-folders.markdown

@@ -4,6 +4,9 @@
 
 To delete a feed or folder, select it from the subscription list and choose **Edit → Delete** from the menu bar. Alternatively, select the feed and press the **delete** key.
 
-## Undo deleting a feed or folder
+
+
+Undo deleting a feed or folder
+------------------------------
 
 If you change your mind, you can undo the deletion by selecting **Edit → Undo** in the menu bar or pressing ⌘-Z.

Technotes/HelpBook/5.0/en/index.markdown

@@ -10,11 +10,11 @@
 
 [How to go through your articles](reading-articles.html)
 
-How to sort the timeline
+[How to sort the timeline](sorting-the-timeline.html)
 
 Tour of the built-in smart feeds: Today, All Unread, Starred
 
-Keyboard shortcuts (see Help menu command)
+[Keyboard shortcuts](keyboard-shortcuts.html)
 
 Sharing to other apps, including MarsEdit and Micro.blog
 
@@ -42,7 +42,7 @@ Accounts overview
 
 [About the On My Mac account](on-my-mac.html)
 
-How to add a syncing account
+[How to add a syncing account](syncing-accounts.html)
 
 
 
@@ -70,6 +70,8 @@ How to add a syncing account
 
 ## Other ideas? Add them here.
 
+
+
 ---
 
 Credits: The Help book was written by [Brent Simmons](https://inessential.com/), [Ryan Dotson](https://nostodnayr.net), your name here, etc.

Technotes/HelpBook/5.0/en/keyboard-shortcuts.markdown

@@ -0,0 +1,55 @@
+@title Keyboard shortcuts
+
+# Keyboard shortcuts
+
+NetNewsWire’s interface is easily navigable using keyboard shortcuts.
+
+The most useful shortcuts are for reading articles: **space** to scroll articles and jump to the next unread one, or **n** to jump immediately to the next unread article. There’s also **b** to open the article in your browser (the **Return** or **Enter** keys work too).
+
+
+
+In-app list of keyboard shortcuts
+---------------------------------
+
+A comprehensive list of NetNewsWire’s keyboard shortcuts is always accessible to you in NetNewsWire. Just click on **Help → Keyboard Shortcuts** in the menu bar.
+
+The list opens in a separate window which you can leave open to remind you of the keys to press. *You’ll be a NetNewsWire keyboard magician in no time.*
+
+
+### Do I need to use the Command key?
+
+No, the Command (⌘) key isn’t required for these advanced keyboard shortcuts – just press the key by itself. 
+
+
+
+NetNewsWire’s keyboard shortcuts
+--------------------------------
+
+Many of NetNewsWire’s shortcuts work from anywhere in the app. Others only work when a certain pane is active and highlighted.
+
+<!-- From in-app shortcut page -->
+<table>
+    <tr><th>Everywhere in NetNewsWire</th></tr>
+       <tr><td>Scroll or go to next unread</td>             <td>space</td></tr>
+       <tr><td>Go to next unread</td>                       <td>n or +</td></tr>
+       <tr><td>Mark as read</td>                            <td>r</td></tr>
+       <tr><td>Mark all as read</td>                        <td>k</td></tr>
+       <tr><td>Mark older articles as read</td>             <td>o</td></tr>
+       <tr><td>Mark all as read, go to next unread</td>     <td>l</td></tr>
+       <tr><td>Mark as unread, go to next unread</td>       <td>m</td></tr>
+       <tr><td>Mark as unread</td>                          <td>u</td></tr>
+       <tr><td>Open in browser</td>                         <td>b or &#9166; or Enter</td></tr>
+       <tr><td>Previous subscription</td>                   <td>a</td></tr>
+       <tr><td>Next subscription</td>                       <td>z</td></tr>
+    <tr><th>Feed list (left pane)</th></tr>
+       <tr><td>Collapse</td>                                <td>, or &#8997;+&larr;</td></tr>
+       <tr><td>Expand</td>                                  <td>. or &#8997;+&rarr;</td></tr>
+       <tr><td>Collapse All (except for group items)</td>   <td>; or &#8997;+&#8984;+&larr;</td></tr>
+       <tr><td>Expand All</td>                              <td>' or &#8997;+&#8984;+&rarr;</td></tr>
+       <tr><td>Move focus to headlines</td>                 <td>&rarr;</td></tr>
+    <tr><th>Article list timeline (centre pane)</th></tr>
+       <tr><td>Move focus to subscriptions</td>             <td>&larr;</td></tr>
+	   <tr><td>Move focus to detail</td>                    <td>&rarr;</td></tr>
+	<tr><th>Article reader (right pane)</th></tr>
+	   <tr><td>Move focus to headlines</td>                 <td>&larr;</td></tr>
+</table>

Technotes/HelpBook/5.0/en/netnewswire-news.markdown

@@ -4,7 +4,10 @@
 
 The very best way to get news about NetNewsWire is with NetNewsWire itself, using the *NetNewsWire News Feed*. Important and notable news about NetNewsWire will appear there: new version announcements, critical bug notices, tech notes and important project announcements.
 
-## Add the NetNewsWire News Feed
+
+
+Add the NetNewsWire News Feed
+-----------------------------
 
 The NetNewsWire News Feed is part of the default subscription list installed the first time you launched NetNewsWire. If it’s no longer in your list, it’s easy to add it back.
 

Technotes/HelpBook/5.0/en/on-my-mac.markdown

@@ -1,6 +1,6 @@
-@title About the On My Mac account
+@title The On My Mac account
 
-# About the On My Mac account
+# The On My Mac account
 
 The On My Mac account is the simplest way to use NetNewsWire. Using it requires no additional service or software. It’s just you, your subscriptions and NetNewsWire.
 
@@ -8,7 +8,33 @@ On My Mac subscriptions are wholly managed by NetNewsWire. It keeps your subscri
 
 The On My Mac account does not sync this data to any other location. It works best for those people who only read NetNewsWire feeds on one Mac and nowhere else.
 
+*NetNewsWire can also be used with a [syncing account](syncing-accounts.html) service like Feedbin.*
 
-## Refreshing On My Mac feeds
 
-The feeds in the On My Mac account will be refreshed automatically whenever you open NetNewsWire. If left open, NetNewsWire will refresh your feeds every hour, or according to the schedule you set in Preferences. You can also disable all automatic refreshing from there.
+Refreshing On My Mac feeds
+--------------------------
+
+The feeds in the On My Mac account will be refreshed automatically whenever you open NetNewsWire. If left open, NetNewsWire will refresh your feeds every hour, or according to the schedule you set in Preferences.
+
+
+
+If you don’t use the On My Mac account
+--------------------------------------
+
+If you only use a syncing account with NetNewsWire, you may want to hide or disable the On My Mac account.
+
+
+### Hide the On My Mac account
+
+To hide the On My Mac account, place the mouse over the **On My Mac** listing in the sidebar and click on **Hide**.
+
+
+### Disable the On My Mac account
+
+Disabling the On My Mac account can be done in NetNewsWire’s preferences.
+
+1. Open the NetNewsWire preferences from **NetNewsWire → Preferences…** (⌘-,)
+2. Click on **Accounts** and select *On My Mac*
+3. Deselect the *Active* tick box
+
+You’ll no longer see the On My Mac account in the NetNewsWire sidebar.

Technotes/HelpBook/5.0/en/privacy.markdown

@@ -10,6 +10,7 @@ The only data we collect about how you use NetNewsWire, *only if you agree and o
 
 
 
-## Changes to the Privacy Policy
+Changes to the Privacy Policy
+-----------------------------
 
 The [full privacy policy](https://github.com/brentsimmons/NetNewsWire/blob/master/Technotes/privacypolicy.markdown) is stored in the NetNewsWire GitHub repository, where you can track any changes we might make.

Technotes/HelpBook/5.0/en/reading-articles.markdown

@@ -9,21 +9,27 @@ One-handed reading is accomplished with keyboard shortcuts. NetNewsWire’s shor
 (For a full list of keyboard shortcuts, including Command (⌘) key alternatives, see the [Keyboard Shortcuts](keyboard-shortcuts.html) help page, or use **Help → Keyboard Shortcuts** in NetNewsWire.)
 
 
-## Use the Space bar
+
+Use the Space bar
+-----------------
 
 The easiest way to read articles in NetNewsWire is using the **space bar**.
 
 If you’re reading an article that can be scrolled, pressing **space bar** will scroll it – just like it would in Safari. If you’re at the end of the article, **space bar** will take you to the next unread article.
 
 
-## Go to Next Unread
+
+Go to Next Unread
+-----------------
 
 Sometimes you may want to skip reading an article entirely – that’s totally fine! Rather than press space bar multiple times, you can jump directly to the next unread item by pressing ⌘-/ or just press **n** or **+**.
 
 If you want to skip the article for now, but plan to come back to it later, the **m** key is for you. Pressing it will mark the current article as unread and then go to the *next unread* item.
 
 
-## Moving around lists
+
+Moving around lists
+-------------------
 
 You may not always want to read linearly – imagine there’s a new article on [Julia Evans’](https://jvns.ca) site you want to read first. You still don’t need to leave the keyboard.
 
@@ -32,7 +38,9 @@ Pressing the left and right arrow keys will move you between the three panes in
 In the subscription and article lists, the up and down arrow keys will change the currently selected item.
 
 
-## Marking as read or unread
+
+Marking as read or unread
+-------------------------
 
 As you zip through the NetNewsWire interface, you may want to mark an article as read or unread. The easiest way to do this is use the **r** and **u** keys, respectively.
 

Technotes/HelpBook/5.0/en/safari-extension.markdown

@@ -5,7 +5,9 @@
 NetNewsWire provides a Safari Extension which adds a *Subscribe to Feed* button to your Safari toolbar. This allows you to quickly add a site’s feed without entering an address manually into NetNewsWire.
 
 
-## Installing the NetNewsWire Safari Extension
+
+Installing the NetNewsWire Safari Extension
+-------------------------------------------
 
 The Safari Extension is installed automatically with NetNewsWire. However, it must be *enabled* before you can use it.
 
@@ -20,7 +22,9 @@ You will enable the extension in Safari:
 Once this is done, the *Subscribe to Feed* button will be added to your Safari toolbar.
 
 
-## Adding a feed using the Safari Extension
+
+Adding a feed using the Safari Extension
+----------------------------------------
 
 For any site that advertises its feeds, you can use the ‘Subscribe to Feed’ button. Clicking it send the feed’s address to NetNewsWire where you can set options like an alternative feed name, and the account and folder where it will be stored.
 

Technotes/HelpBook/5.0/en/sorting-the-timeline.markdown

@@ -0,0 +1,13 @@
+@title Sorting the NetNewsWire timeline
+
+# Sorting the NetNewsWire timeline
+
+The NetNewsWire timeline is the list of articles shown in the centre pane.
+
+« Screenshot »
+
+By default, this list displays newer articles at the top.
+
+You can change the sorting for the timeline in the View menu: **View → Sort by → Newest Article on Top** or **Oldest Article on Top**.
+
+This setting applies to all feeds and can be changed anytime.

Technotes/HelpBook/5.0/en/updating.markdown

@@ -6,13 +6,15 @@ NetNewsWire can check for and install updated versions of itself. This can be do
 
 
 
-## Automatic checks for updates
+Automatic checks for updates
+----------------------------
 
 When you first launch NetNewsWire you’ll be asked whether it should periodically check for updates. You will be notified of any new updates and can choose to update when you’re ready.
 
 
 
-## Manually checking for updates
+Manually checking for updates
+-----------------------------
 
 You may have declined automatic checks for updates or just [read about a great new update](netnewswire-news.html) and want to download it now. You can always check for updates manually by selecting **NetNewsWire → Check for Updates…** from the menu bar.
 
@@ -20,6 +22,7 @@ If a new update is found, NetNewsWire can download and install it for you.
 
 
 
-## Privacy
+Privacy
+-------
 
 When checking for updates, whether automatically or manually, no personally-identifiable information is collected – not even an anonymous system profile. For more information about your privacy and NetNewsWire, please see the NetNewsWire Privacy Policy.

Technotes/HelpBook/5.0/en/userdata-location.markdown

@@ -6,7 +6,8 @@ NetNewsWire remembers your feeds and article read status, as well as your accoun
 
 
 
-## Preferences file
+Preferences file
+----------------
 
 Your NetNewsWire preferences file is called `com.ranchero.NetNewsWire-Evergreen.plist`. It’s stored in your account’s Preferences folder, which can be found in the Finder by navigating to:
 
@@ -19,7 +20,8 @@ The contents in the preferences `plist` file are cached by macOS. If you make an
 
 
 
-## Feeds and accounts data
+Feeds and accounts data
+-----------------------
 
 Information about your subscribed feeds, article read status and accounts (On my Mac and Feedbin) are stored in your account’s Application Support folder. This can be found in the Finder by navigating to:
 
@@ -32,9 +34,12 @@ If you just want to export your list of subscribed feeds, NetNewsWire [can expor
 
 
 
-## Resetting or removing NetNewsWire
+Resetting or removing NetNewsWire
+---------------------------------
 
-If you are encountering problems while using NetNewsWire, by removing the files and folders above you can set up NetNewsWire again from scratch. You may also want to delete these files if you want to completely remove NetNewsWire from your Mac.
+If you are running into problems while using NetNewsWire, you may want to reset your settings. By removing the files and folders above you can start over again from scratch. 
+
+You may also want to delete these files if you want to completely remove NetNewsWire from your Mac.
 
 
 ### Can’t find the Library folder?

Technotes/HelpBook/5.0/en/what-is-rss.markdown

@@ -12,7 +12,7 @@ Like this imaginary squished-down web page:
 
 The good part is the part in the middle — that’s the part with the news. That’s the part that you read. That’s the part you’re interested in.
 
-<p>And that’s what RSS is — it’s just that part, minus the rest of the stuff.
+And that’s what RSS is — it’s just that part, minus the rest of the stuff.
 
 #### Details