public-mirrors/NewsBlur-viq
1
0
Fork 0
mirror of https://github.com/viq/NewsBlur.git synced 2025-09-18 21:43:31 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Remainder of FAQ re-writes

Browse source
This commit is contained in:
alliepape 2012-10-05 11:45:06 -07:00
parent 84498eaa31
commit 5a030d41e6
1 changed files with 37 additions and 21 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

58
templates/static/faq.xhtml
View file

@ -22,12 +22,18 @@
NewsBlur defaults to Feed view, which is the plain ol’ RSS feed from a given site. (You might recognize this look from Google Reader.) But we know a lot of people enjoy reading in the original design and typeface of a given site, which is why we also offer Original view (which shows the entire original site) and Story view (which shows each individual blog post from the original site, one story at a time). That sound you just heard? It’s a thousand web designers sighing with pleasure.
</div>
</li>
<li>
<div class="NB-faq-question">
How do I view a story in Story View?
</div>
<div class="NB-faq-answer">
To temporarily open up a story in Story view, just double-click. The next story you open will revert back to the view you were using before. Double-clicking a Feed will open up the feed in a new tab.
<li>
<div class="NB-faq-question">
Am I actually at the original site? Can NewsBlur see what I see?
</div>
<div class="NB-faq-answer">
In order to show you the original site, NewsBlur takes a snapshot of the page. You may have noticed that if you are logged into the original site, you are not logged into NewsBlur's snapshot of the page. This is because NewsBlur fetched the site for you.
Well, not exactly. In order to show you a site in Original or Story view, NewsBlur takes a snapshot of the page when you switch over. So if you log into the real site, it might not look exactly the same. We do this because it helps everything load more quickly, and no one likes waiting.
</div>
</li>
<li class="last">
@ -35,10 +41,10 @@
Why doesn't NewsBlur follow me when I click on links on the page?
</div>
<div class="NB-faq-answer">
When you click on a link, you are technically leaving NewsBlur, although only for a portion of the page in an iframe. In order to track what you're reading, you need to read NewsBlur's snapshot of the page, or switch to the Feed view.
</div>
Since NewsBlur runs as a webpage, clicking on a link means you’re technically leaving our site, although only for a portion of the page. In order to track what you're reading, you need to read NewsBlur's snapshot of the page, or switch to the Feed view.
</div>
<div class="NB-faq-answer last">
This may change one day. There is a way to fix this behavior so it works like you would expect. It is not easy to do, however. One day.
There’s a way to fix this so it works like you would expect, but it’s pretty difficult to do. We’ve got a lot of other big priorities that come first, and we also like to have some time for things like eating dinner and watching television and playing with random dogs we pass walking down the street, so it hasn’t happened yet. If you really want to see it change, drop us a line, and we’ll consider it if the response is big enough.
</div>
</li>
</ul>
@ -64,19 +70,24 @@
How does NewsBlur know whether I like or dislike a story?
</div>
<div class="NB-faq-answer">
When you like or dislike a story, you mark a facet of that story by checking a tag, author, part of the title, or entire publisher. When these facets are found in future stories, the stories are then weighted with your preferences. It is a very simple, explicit process where you tell NewsBlur what you like and don't like.
Our favorite thing about NewsBlur is that you can teach it your preferences every time you read a story. When you like or dislike something you read, you can click the button at the bottom that says “Train This Story.” You’ll be presented with a whole list of characteristics about the story, including the author, the title, any tags, the blog from which it comes, and the person who shared it. Everything defaults to yellow, which is neutral—you neither like or dislike it. But if there’s an author on a blog you particularly like, or a particular category you want to know more about, you can use the thumbs-up button to mark it green. The same goes for authors, categories, and even whole blogs that don’t really strike your fancy.
</div>
<li>
<div class="NB-faq-question">
What's the point of training your feed?
</div>
<div class="NB-faq-answer">
The idea is that by explicitly telling NewsBlur what your story preferences are, there is increased likelihood that you will like what the intelligence slider does for you.
</div>
<div class="NB-faq-answer last">
Currently, there is not an automated way of detecting stories you like or dislike without having to train NewsBlur. This implicit, automatic intelligence will come in the near-term future, but it will require an evolution to the interface that has not been easy to figure out how to make in a simple, clear, and effective manner. Soon.
The more you train NewsBlur, the more able it is to dish up stories that suit your interests. So if you read a blog that covers both politics and sports, but you only like politics, or a blog where you love Author A’s work but not Author B or Author C’s, NewsBlur will only give you stories about politics and stories by Author A. That means less stuff to sort through, and more time playing with random dogs you pass while walking down the street.
</div>
</li>
<li>
<div class="NB-faq-question">
Why should I invest the time to train my feed?
</div>
<div class="NB-faq-answer">
We know that training is time-consuming, which is why NewsBlur is still a good RSS reader even if you don’t much feel like training it. We want to eventually develop an automated way of detecting stories without you having to train NewsBlur, but that’s still in the future. In the meantime, consider the time you put into training it now as an investment in your interest and attention at a later date.
</div>
</li>
</ul>
</div>
</div>
<div class="NB-module">
<h5 class="NB-module-title">Information for Publishers</h5>
<div class="NB-module-content">
@ -122,23 +133,28 @@
<h5 class="NB-module-title">Something's Wrong</h5>
<div class="NB-module-content">
<ul class="NB-about-client">
<li>
<li>
<div class="NB-faq-question">
Help! All of the stories are several days old and new stories are not showing up.
Help! All of my stories are several days old and new stories are not showing up.
</div>
<div class="NB-faq-answer">
Sites that only have a single subscriber tend to get updated much less often than popular sites. Additionally, the frequency that a site publishes stories (once per month or several per day) has an impact on how often the site is refreshed.
Congratulations on your esoteric taste in blogs&mdash;and condolences as well. The way NewsBlur works requires that sites get updated on a regular basis, so we try to serve the most popular and frequently updated sites first. Sites that only have a single subscriber tend to get updated much less often, in comparison to those that have many; the same goes for those that update a few times a month instead of several times a day.
<li>
<div class="NB-faq-question">
Why can't NewsBlur show me all the stories I want, when I want them?
</div>
</li>
<li>
<div class="NB-faq-answer">
Totally unfair, we know. Our best recommendation is to post some of your favorite older stuff from that obscure site you love on your Blurblog. If more people see that stuff, then you’ve increased the likelihood that blog will snag other subscribers, and it’ll get bumped up NewsBlur’s list of sites to refresh more often.
</div>
<li>
<div class="NB-faq-question">
Help! A bunch of my sites are misbehaving and they work in Google Reader.
</div>
<div class="NB-faq-answer">
This is a known issue that is being addressed in a number of ways. About half of these misbehaving errors are errors that you really do need to address (like 404 Not Found errors). The other half are various edge cases, parser errors, uncaught exceptions, and bad code on NewsBlur's part.
Yeah, we know, and we’re sorry about that. About half of these misbehaving errors aren’t on us (like 404 Not Found errors), but the other half are various edge cases, parser errors, uncaught exceptions, and bad code on NewsBlur's part. We do our best to find and root out everything we can, but there are only so many hours in a day.
</div>
<div class="NB-faq-answer">
But because this problem is so severe, various measures are taken every few weeks that fix a huge swath of misbheaving sites at once. You might find that this happens and it's quite nice when it does.
On the upside, the severity of this problem means that we take measures every few weeks that fix a huge swath of misbehaving sites at once. It’s pretty great when this happens, but we know it’s not frequent enough. We’re working on it, we promise.
</div>
</li>
<li class="last">
@ -146,7 +162,7 @@
Help! I have an issue and it's not mentioned here.
</div>
<div class="NB-faq-answer last">
Please, please, please e-mail <a href="mailto:samuel@newsblur.com">samuel@newsblur.com</a>. If you have an issue it is entirely possible that other people do, too.
Please, please, please e-mail <a href="mailto:samuel@newsblur.com">samuel@newsblur.com</a>. If you have an issue it is entirely possible that other people do, too, and the more we know about something that’s gone wrong, the more able and likely we are to fix it. Don’t be shy, drop us a line!
</div>
</li>
</ul>