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

Merge pull request #70 from alliepape/master

Browse source 
FAQ
This commit is contained in:
Samuel Clay 2013-01-06 16:12:31 -08:00
commit 08336fe6a8
3 changed files with 70 additions and 48 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

12
templates/mail/email_new_account.xhtml
View file

@ -4,16 +4,16 @@
{% block body %}
<p style="font-size: 37px; color:#555555; margin-top: 18px;margin-bottom: 10px;padding-top:6px;">Welcome to NewsBlur, {{ user.username }}.</p>
<p style="line-height: 20px;">OK, firstly, thank you for trying out NewsBlur. We've worked hard to make a great app, so congratulations on discovering a handcrafted experience.</p>
<p style="line-height: 20px;">Here are some easy ways to have a great time on NewsBlur:</p>
<p style="line-height: 20px;">Thanks for trying out NewsBlur! We hope we can make your daily reading more personal, sociable, and pleasurable.</p>
<p style="line-height: 20px;">Here are some ways to make NewsBlur work for you:</p>
<p style="line-height: 20px;">
<ul style="list-style: none;">
<li style="line-height:22px;"><img src="http://{% current_domain %}/media/img/icons/silk/rainbow.png" style="width:16px;height:16px;vertical-align:top;padding-top:3px;"> <a href="http://{% current_domain %}{{ user.profile.autologin_url }}?next=friends" style="text-decoration:none">Follow friends from Twitter, Facebook, and NewsBlur</a>.</li>
<li style="line-height:22px;"><img src="http://{% current_domain %}/media/img/reader/popular_thumb.jpg?1" style="width:16px;height:16px;vertical-align:top;padding-top:3px;"> Visit the popular blurblog: <a href="http://popular.newsblur.com" style="text-decoration:none">The People Have Spoken</a>.</li>
<li style="line-height:22px;"><img src="http://{% current_domain %}/media/img/reader/hamburger_l.png" style="width:16px;height:16px;vertical-align:top;padding-top:3px;"> <a href="http://{% current_domain %}{{ user.profile.autologin_url }}?next=chooser" style="text-decoration:none">Upgrade to a premium account for only $12/year</a>.</li>
<li style="line-height:22px;"><img src="http://{% current_domain %}/media/img/reader/popular_thumb.jpg?1" style="width:16px;height:16px;vertical-align:top;padding-top:3px;"> Visit <a href="http://popular.newsblur.com" style="text-decoration:none">The People Have Spoken</a>, our blog of the most popular and talked-about articles posted by NewsBlur readers.</li>
<li style="line-height:22px;"><img src="http://{% current_domain %}/media/img/reader/hamburger_l.png" style="width:16px;height:16px;vertical-align:top;padding-top:3px;"> <a href="http://{% current_domain %}{{ user.profile.autologin_url }}?next=chooser" style="text-decoration:none">Upgrade to a premium account for only $12/year, and get access to an unlimited number of RSS feeds.</a>.</li>
</ul>
</p>
<p style="line-height: 20px;">Spend a few days trying out NewsBlur. We hope you love it.</p>
<p style="line-height: 20px;">We made NewsBlur because we wanted a better way to read the news. We hope you'll love it, too.</p>
{% endblock %}
{% block resources_header %}There are a couple resources you can use if you end up loving NewsBlur:{% endblock resources_header %}
{% block resources_header %}If you enjoy using NewsBlur, these resources might be of interest to you:{% endblock resources_header %}

43
templates/static/about.xhtml
View file

@ -13,15 +13,35 @@
<div class="NB-static-title">
About NewsBlur
</div>
<div class="NB-module">
<h5 class="NB-module-title"><span class="NB-module-title-prefix">What:</span>The story behind NewsBlur</h5>
<h5 class="NB-module-title"><span class="NB-module-title-prefix">What Is NewsBlur?</h5>
<div class="NB-module-content">
<ul class="NB-about-what">
<li>NewsBlur is a social news reader built for people who want to enjoy reading the news. NewsBlur is a great place to read the best stories from your friends and favorite blogs.</li>
<li>In New York City during the Summer of 2009, Samuel Clay wanted a better way to read the news. So he built the first version of NewsBlur almost entirely underground on the A train.</li>
<li>In mid-2010, NewsBlur launched to the public and to favorable reviews. In October 2010 premium accounts launched, paying for NewsBlur's increasing server costs.</li>
<li>After entering Y Combinator during the Summer of 2012, Blurblogs are launched as a new way to share and talk about the news between friends. Samuel and Shiloh celebrate with champagne and biscuits.
<li>NewsBlur is a social news reader that's built to simplify the process of reading news and make it easier to share your favorite stories with your friends.
</ul>
</div>
</div>
<div class="NB-module">
<h5 class="NB-module-title"><span class="NB-module-title-prefix">Why:</span>What makes NewsBlur better</h5>
<div class="NB-module-content">
<ul class="NB-about-why">
<li><b>News reading</b>: With first-class iOS, Android, and web apps, NewsBlur is an easy and organized way to read the news wherever you are.</li>
<li><b>Training</b>: By using NewsBlur's training filters, you can hide stories you don't want to see and highlight the stories that interest you. Teaching NewsBlur your preferences (or lack thereof) for certain blogs, authors, and topics cuts down on the noise and connects you with the news that interests you most.</li>
<li><b>Social</b>: Sharing and talking about the news is not only fun, but allows you to break out of your routine and embrace the serendipity of your friends' tastes.</li>
<li><b>Blurblogs</b>: Even if your friends aren't NewsBlur users, they can keep up with what you're reading through a public blog of all the stories you've shared, including your comments.</li>
</ul>
</div>
</div>
<div class="NB-module">
<h5 class="NB-module-title"><span class="NB-module-title-prefix">When:</span>The story behind NewsBlur</h5>
<div class="NB-module-content">
<ul class="NB-about-what">
<li>In New York City during the summer of 2009, Samuel Clay wanted a better way to read the news. So he built the first version of NewsBlur almost entirely underground on the A train.</li>
<li>In mid-2010, NewsBlur launched to the public and to favorable reviews. In October 2010, premium accounts launched, paying for NewsBlur's increasing server costs.</li>
<li>After Samuel enters Y Combinator in the summer of 2012, he's able to launch lots of new features, like Blurblogs. Samuel and his dog Shiloh celebrate with champagne and biscuits.
</ul>
</div>
</div>
@ -47,17 +67,6 @@
</div>
</div>
<div class="NB-module">
<h5 class="NB-module-title"><span class="NB-module-title-prefix">Why:</span>What makes NewsBlur better</h5>
<div class="NB-module-content">
<ul class="NB-about-why">
<li><b>News reading</b>: With first-class iOS, Android, and web apps, NewsBlur is an easy and organized way to read the news wherever you are. </li>
<li><b>Training</b>: By using NewsBlur's training filters, you can hide stories you don't want to see while highlighting the stories you want to focus on.</li>
<li><b>Social</b>: Sharing and talking about the news is not only fun, but allows you to break out of your filter bubble and embrace the serendipity of your friend's tastes.</li>
</ul>
</div>
</div>
<div class="NB-module">
<h5 class="NB-module-title"><span class="NB-module-title-prefix">How:</span>Server-side technologies</h5>
<div class="NB-module-content">

63
templates/static/faq.xhtml
View file

@ -19,18 +19,21 @@
What is the difference between the three views: Original, Feed, and Story?
</div>
<div class="NB-faq-answer">
Original view is the original site. Feed view is the RSS feed from the site. And Story view is the original site for one story at a time. Original view is the blog site, whereas Story view is an individual blog post. It's all personal preference, really.
</div>
<div class="NB-faq-answer">
You can double-click a story to temporarily open it up in the Story view. The next story you open will transport you back to whichever view you were on before. Double-clicking a Feed will open up the feed in a new tab.
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">
@ -38,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>
@ -67,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">
@ -125,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">
@ -149,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>