<commit_before># News
Interesting new features added to this project will be documented here reverse chronologically.
This is [not a change log](CHANGELOG.md).

## October 4th, 2016
### Improved search and keyword match display

I can't believe it's been a whole year since the last major new feature, I've 
certainly been working on some cool stuff, but this has been perhaps the longest 
standing issue with Orientation: searching things easily.

I've replaced the search library we were using with one that allows us to be a 
lot more specific with regards to the weighing of results. Article titles are 
now weighed higher in search than article content. We now also display exactly 
what the full-text search engine matched on when you type keywords so you 
can know **why** an article came back in the search results.

![Animation showing search keywords being displayed in article match results](https://d3vv6lp55qjaqc.cloudfront.net/items/1w1H1d431a2b0617032A/Screen%20Recording%202016-10-04%20at%2010.36%20PM.gif?X-CloudApp-Visitor-Id=2861&v=534bb77a)

## October 4th, 2015
### Email privacy

I noticed a few weeks ago that private emails from people trying out try.orientation.io were being displayed. That was problematic because people testing out the site didn't agree to have their email shared. So I added a new option that can be triggered with `user.update(private_email: true)`. It's stored inside of a native Postgres JSON column called `preferences` to which we'll eventually add more user-specific settings (without need for new columns).

There's also a `rake make_all_emails_private` which can run this command for all existing users. I will not be making private emails a default for now but will likely add a new Orientation configuration option to have email privacy be a default or not so that public-facing Orientation installations don't leak private email information from people authenticating with their private Gmail accounts.

## September 22nd, 2015
### Rot reporter logging and more human emails

![Rotten Banner displaying the name of the rot reporter and the date at which it was marked as rotten](https://s3.amazonaws.com/f.cl.ly/items/103F280238162B1N3r0H/Screen%20Shot%202015-09-22%20at%206.59.51%20PM.png)

Whenever someone reported an article as rotten, there used to be no way to know who that person was. Now rot reporter is logged and when the contributors to the article are notified, they are told who reported the rot. Here's why:

- it makes things more human, it's not just a game of whack-a-mole to find articles and mark them as rotten
- it allows for conversations to happen between the reporter and the article contributors
- if notifications are turned off it allows a reader or contributor of the article to reach out to the rot reporter in order to refresh the article

This update requires a manual update to your Mandrill templates for [`Article Endorsement Notification`](https://github.com/orientation/orientation/blob/master/doc/MANDRILL.md#article-rotten-update) and `Article Rotten Update`](https://github.com/orientation/orientation/blob/master/doc/MANDRILL.md#article-rotten-update)
<commit_msg>Add news item about hidden non-current guides<commit_after># News
Interesting new features added to this project will be documented here reverse chronologically.
This is [not a change log](CHANGELOG.md).

## October 4th, 2016
### Improved search and keyword match display

I can't believe it's been a whole year since the last major new feature, I've 
certainly been working on some cool stuff, but this has been perhaps the longest 
standing issue with Orientation: searching things easily.

I've replaced the search library we were using with one that allows us to be a 
lot more specific with regards to the weighing of results. Article titles are 
now weighed higher in search than article content. We now also display exactly 
what the full-text search engine matched on when you type keywords so you 
can know **why** an article came back in the search results.

![Animation showing search keywords being displayed in article match results](https://d3vv6lp55qjaqc.cloudfront.net/items/1w1H1d431a2b0617032A/Screen%20Recording%202016-10-04%20at%2010.36%20PM.gif?X-CloudApp-Visitor-Id=2861&v=534bb77a)

### Hiding archived or rotted guide articles from the home page

Previously, even when a guide article was archived or marked as rotten, it would 
still show up on the homepage. Now we'll hide those guides.

## October 4th, 2015
### Email privacy

I noticed a few weeks ago that private emails from people trying out try.orientation.io were being displayed. That was problematic because people testing out the site didn't agree to have their email shared. So I added a new option that can be triggered with `user.update(private_email: true)`. It's stored inside of a native Postgres JSON column called `preferences` to which we'll eventually add more user-specific settings (without need for new columns).

There's also a `rake make_all_emails_private` which can run this command for all existing users. I will not be making private emails a default for now but will likely add a new Orientation configuration option to have email privacy be a default or not so that public-facing Orientation installations don't leak private email information from people authenticating with their private Gmail accounts.

## September 22nd, 2015
### Rot reporter logging and more human emails

![Rotten Banner displaying the name of the rot reporter and the date at which it was marked as rotten](https://s3.amazonaws.com/f.cl.ly/items/103F280238162B1N3r0H/Screen%20Shot%202015-09-22%20at%206.59.51%20PM.png)

Whenever someone reported an article as rotten, there used to be no way to know who that person was. Now rot reporter is logged and when the contributors to the article are notified, they are told who reported the rot. Here's why:

- it makes things more human, it's not just a game of whack-a-mole to find articles and mark them as rotten
- it allows for conversations to happen between the reporter and the article contributors
- if notifications are turned off it allows a reader or contributor of the article to reach out to the rot reporter in order to refresh the article

This update requires a manual update to your Mandrill templates for [`Article Endorsement Notification`](https://github.com/orientation/orientation/blob/master/doc/MANDRILL.md#article-rotten-update) and `Article Rotten Update`](https://github.com/orientation/orientation/blob/master/doc/MANDRILL.md#article-rotten-update)

{'fraction_non_alphanumeric': 0.05591102985984156, 'fraction_numerical': 0.031687995124923825, 'mean_word_length': 4.887892376681615, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 8, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1702043', 'n_tokens_mistral': 1847, 'n_tokens_neox': 1652, 'n_words': 895}