Helpbook: organised index, updating NetNewsWire, user data, privacy

Organised index a bit
Added pages:
- user data location
- privacy summary
- updating the app
Minor formatting adjustments
This commit is contained in:
Ryan Dotson 2019-08-05 07:55:50 +09:00
parent 12f85f3ad3
commit 5a594fd3cb
5 changed files with 135 additions and 30 deletions

View File

@ -1,52 +1,75 @@
@title NetNewsWire 5 Help
## Getting Started
[What is RSS? What are feeds?](what-is-rss.html)
More topics to do…
## Reading Feeds
[How to go through your articles](reading-articles.html)
How to sort the timeline
Tour of the built-in smart feeds: Today, All Unread, Starred
Keyboard shortcuts (see Help menu command)
Sharing to other apps, including MarsEdit and Micro.blog
## Managing Feeds
[How to add a feed](adding-feeds.html)
[Installing and using the Safari Extension to add feeds](safari-extension.html)
[How to import OPML](import-opml.html)
[How to export OPML](export-opml.html)
[How to go through your articles](reading-articles.html)
Sharing to other apps, including MarsEdit and Micro.blog
[How to delete feeds and folders](deleting-feeds-folders.html)
How to add a syncing account
[How to contribute](contributing.html)
[How to get NetNewsWire news](netnewswire-news.html)
Keyboard shortcuts (see Help menu command)
[About the On My Mac account](on-my-mac.html)
Privacy (including link to privacy policy)
How to add special Micro.blog feeds
How to rename feeds and folders
How to get and copy feed information
Where NetNewsWire data is stored
How to update NetNewsWire
How to sort the timeline
## Accounts
Tour of the built-in smart feeds: Today, All Unread, Starred
Accounts overview
Other ideas? Add them here.
[About the On My Mac account](on-my-mac.html)
How to add a syncing account
## NetNewsWire Data
[Where NetNewsWire data is stored](userdata-location.html)
[How to import OPML](import-opml.html)
[How to export OPML](export-opml.html)
## The NetNewsWire Project
[How to Update NetNewsWire](updating.html)
[How to get NetNewsWire news](netnewswire-news.html)
[NetNewsWire and your privacy](privacy.html)
[How to contribute to NetNewsWire](contributing.html)
## Other ideas? Add them here.
---
Credits: The Help book was written [Brent Simmons](https://inessential.com/), your name here, etc.
Credits: The Help book was written by [Brent Simmons](https://inessential.com/), [Ryan Dotson](https://nostodnayr.net), your name here, etc.

View File

@ -0,0 +1,15 @@
@title NetNewsWire and your privacy
# NetNewsWire and your privacy
[The NetNewsWire Privacy Policy](https://github.com/brentsimmons/NetNewsWire/blob/master/Technotes/privacypolicy.markdown)
NetNewsWire has a very strict privacy policy we dont want any private information about you.
The only data we collect about how you use NetNewsWire, *only if you agree and opt in*, is crash logs.
## 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.

View File

@ -2,7 +2,7 @@
# Installing and using the Safari Extension to add feeds
NetNewsWire provides a Safari Extension which adds a Subscribe to Feed button to your Safari toolbar. This allows you to quickly add a sites feed without entering an address manually into NetNewsWire.
NetNewsWire provides a Safari Extension which adds a *Subscribe to Feed* button to your Safari toolbar. This allows you to quickly add a sites feed without entering an address manually into NetNewsWire.
## Installing the NetNewsWire Safari Extension
@ -17,7 +17,7 @@ You will enable the extension in Safari:
4. From the list, click the checkbox beside **Subscribe to Feed** to enable the extension
5. Close the Preferences window
Once this is done, the Subscribe to Feed button will be added to your Safari toolbar.
Once this is done, the *Subscribe to Feed* button will be added to your Safari toolbar.
## Adding a feed using the Safari Extension
@ -27,6 +27,6 @@ For any site that advertises its feeds, you can use the Subscribe to Feed
### What to do if the Subscribe to Feed button is greyed out and disabled
The Subscribe in NetNewsWire button will only be enabled for sites that advertise their feeds in their code. If the button is disabled, NetNewsWire wasnt able to find any feeds automatically.
The *Subscribe to Feed* button will only be enabled for sites that advertise their feeds in their code. If the button is disabled, NetNewsWire wasnt able to find any feeds automatically.
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 URL to NetNewsWire directly](adding-feeds.html). Right-click on the link and copy the URL to paste into NetNewsWire.

View File

@ -0,0 +1,25 @@
@title How to Update NetNewsWire
# How to Update NetNewsWire
NetNewsWire can check for and install updated versions of itself. This can be done for you automatically in the background or you can check for updates manually.
## Automatic checks for updates
When you first launch NetNewsWire youll be asked whether it should periodically check for updates. You will be notified of any new updates and can choose to update when youre ready.
## 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.
If a new update is found, NetNewsWire can download and install it for you.
## 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.

View File

@ -0,0 +1,42 @@
@title Where NetNewsWire data is stored
# Where NetNewsWire data is stored
NetNewsWire remembers your feeds and article read status, as well as your account information and preferences. This information is stored in two different locations on your Mac, but separately from the NetNewsWire app.
## Preferences file
Your NetNewsWire preferences file is called `com.ranchero.NetNewsWire-Evergreen.plist`. Its stored in your accounts Preferences folder, which can be found in the Finder by navigating to:
*Your home folder* Library Preferences
### Preferences caching
The contents in the preferences `plist` file are cached by macOS. If you make any changes or delete the file, log out and log back in before relaunching NetNewsWire to make sure the old settings are fully cleared. (Alternatively, if you prefer, you can also run `killall cfprefsd` from Terminal to reload the preferences cache.)
## Feeds and accounts data
Information about your subscribed feeds, article read status and accounts (On my Mac and Feedbin) are stored in your accounts Application Support folder. This can be found in the Finder by navigating to:
*Your home folder* Library Application Support NetNewsWire
### Exporting your feeds
If you just want to export your list of subscribed feeds, NetNewsWire [can export an OPML for you](export-opml.html).
## 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.
### Cant find the Library folder?
If you cant see the Library folder in the Finder, you can open it by holding down the Option (⌥) key and clicking **Go → Library**. For more information, see the [Library folder](https://support.apple.com/en-gb/guide/mac-help/aside/mh35934/10.14/mac/10.14) note in the macOS Documentation.