Changing description to excerpt

2012-07-07-nsindexset.md

@@ -4,7 +4,7 @@ title: NSIndexSet
 ref: "https://developer.apple.com/library/mac/#documentation/Cocoa/Reference/Foundation/Classes/NSSet_Class/Reference/Reference.html"
 category: Cocoa
 rating: 7.8
-description: "NSIndexSet (and its mutable counterpart, NSMutableIndexSet) is a sorted collection of unique unsigned integers. Think of it like an NSRange that supports non-contiguous series. It has wicked fast operations for finding indexes in ranges or set intersections, and comes with all of the convenience methods you'd expect in a Foundation collection class."
+excerpt: "NSIndexSet (and its mutable counterpart, NSMutableIndexSet) is a sorted collection of unique unsigned integers. Think of it like an NSRange that supports non-contiguous series. It has wicked fast operations for finding indexes in ranges or set intersections, and comes with all of the convenience methods you'd expect in a Foundation collection class."
 ---
 
 `NSIndexSet` (and its mutable counterpart, `NSMutableIndexSet`) is a sorted collection of unique unsigned integers. Think of it like an `NSRange` that supports non-contiguous series. It has wicked fast operations for finding indexes in ranges or set intersections, and comes with all of the convenience methods you'd expect in a Foundation collection class.

2012-07-14-nscache.md

@@ -4,7 +4,7 @@ title: NSCache
 ref: "https://developer.apple.com/library/mac/#documentation/Cocoa/Reference/Foundation/Classes/NSCache_Class/Reference/Reference.html"
 category: Cocoa
 rating: 7.5
-description: "Poor NSCache, always being overshadowed by NSMutableDictionary. It's as if no one knew how it provides all of that garbage collection behavior that developers take great pains to re-implement themselves."
+excerpt: "Poor NSCache, always being overshadowed by NSMutableDictionary. It's as if no one knew how it provides all of that garbage collection behavior that developers take great pains to re-implement themselves."
 ---
 
 Poor `NSCache`, always being overshadowed by `NSMutableDictionary`. It's as if no one knew how it provides all of that garbage collection behavior that developers take great pains to re-implement themselves.

2012-07-24-nssortdescriptor.md

@@ -4,7 +4,7 @@ title: NSSortDescriptor
 ref: "https://developer.apple.com/library/mac/#documentation/Cocoa/Reference/Foundation/Classes/NSSortDescriptor_Class/Reference/Reference.html"
 category: Cocoa
 rating: 8.4
-description: "Sorting: it's the mainstay of Computer Science 101 exams and whiteboarding interview questions. But when was the last time you actually needed to know how to implement Quicksort yourself?"
+excerpt: "Sorting: it's the mainstay of Computer Science 101 exams and whiteboarding interview questions. But when was the last time you actually needed to know how to implement Quicksort yourself?"
 ---
 
 Sorting: it's the mainstay of Computer Science 101 exams and whiteboarding interview questions. But when was the last time you actually needed to know how to implement Quicksort yourself?

2012-07-31-nsdatecomponents.md

@@ -4,7 +4,7 @@ title: NSDateComponents
 ref: "https://developer.apple.com/library/mac/#documentation/Cocoa/Reference/Foundation/Classes/NSDateComponents_Class/Reference/Reference.html"
 category: Cocoa
 rating: 6.9
-description: "NSDateComponents serves an important role in Foundation's date and time APIs. By itself, it's nothing impressive—just a container for information about a date (its month, year, day of month, week of year, or whether that month is a leap month). However, combined with NSCalendar, NSDateComponents becomes a remarkably convenient interchange format for calendar calculations."
+excerpt: "NSDateComponents serves an important role in Foundation's date and time APIs. By itself, it's nothing impressive—just a container for information about a date (its month, year, day of month, week of year, or whether that month is a leap month). However, combined with NSCalendar, NSDateComponents becomes a remarkably convenient interchange format for calendar calculations."
 ---
 
 `NSDateComponents` serves an important role in Foundation's date and time APIs. By itself, it's nothing impressive—just a container for information about a date (its month, year, day of month, week of year, or whether that month is a leap month). However, combined with `NSCalendar`, `NSDateComponents` becomes a remarkably convenient interchange format for calendar calculations.

2012-08-06-cfstringtransform.md

@@ -4,7 +4,7 @@ title: CFStringTransform
 ref: "https://developer.apple.com/library/mac/documentation/CoreFOundation/Reference/CFMutableStringRef/Reference/reference.html#//apple_ref/doc/uid/20001504-CH201-BCIGCACA"
 category: Cocoa
 rating: 9.1
-description: "NSString is the crown jewel of Foundation. But as powerful as it is, one would be remiss not to mention its toll-free bridged cousin, CFMutableString—or more specifically, CFStringTransform."
+excerpt: "NSString is the crown jewel of Foundation. But as powerful as it is, one would be remiss not to mention its toll-free bridged cousin, CFMutableString—or more specifically, CFStringTransform."
 ---
 
 There are two indicators that tell you everything you need to know about how nice a language is to use:

2012-08-13-nsincrementalstore.md

@@ -5,7 +5,7 @@ ref: "https://developer.apple.com/library/mac/#documentation/CoreData/Reference/
 category: Cocoa
 rating: 9.5
 published: true
-description: Even for a blog dedicated to obscure APIs, <tt>NSIncrementalStore</tt> sets a new standard. It was introduced in iOS 5, with no more fanfare than the requisite entry in the SDK changelog. Ironically, it is arguably the most important thing to come out of iOS 5, which will completely change the way we build apps from here on out.
+excerpt: Even for a blog dedicated to obscure APIs, <tt>NSIncrementalStore</tt> sets a new standard. It was introduced in iOS 5, with no more fanfare than the requisite entry in the SDK changelog. Ironically, it is arguably the most important thing to come out of iOS 5, which will completely change the way we build apps from here on out.
 ---
 
 Even for a blog dedicated to obscure APIs, `NSIncrementalStore` brings a new meaning to the word "obscure".

2012-08-20-nsoperation.md

@@ -4,7 +4,7 @@ title: NSOperation
 ref: "https://developer.apple.com/library/mac/#documentation/Cocoa/Reference/NSOperation_class/Reference/Reference.html"
 category: Cocoa
 rating: 9.0
-description: "Everyone knows that the secret to making an app snappy and responsive is to offload computation asynchronously to the background."
+excerpt: "Everyone knows that the secret to making an app snappy and responsive is to offload computation asynchronously to the background."
 ---
 
 Everyone knows that the secret to making an app snappy and responsive is to offload computation to be done asynchronously in the background.

2012-08-27-cfbag.md

@@ -5,7 +5,7 @@ ref: "https://developer.apple.com/library/mac/#documentation/CoreFOundation/Refe
 category: Cocoa
 rating: 7.2
 published: true
-description: "In the pantheon of collection data types in computer science, bag doesn't really have the same clout as lists, sets, associative arrays, trees, graphs, or priority queues. In fact, it's pretty obscure. You've probably never heard of it."
+excerpt: "In the pantheon of collection data types in computer science, bag doesn't really have the same clout as lists, sets, associative arrays, trees, graphs, or priority queues. In fact, it's pretty obscure. You've probably never heard of it."
 ---
 
 Objective-C is a language caught between two worlds.

2012-09-03-nslocale.md

@@ -5,7 +5,7 @@ ref: "https://developer.apple.com/library/mac/#documentation/Cocoa/Reference/Fou
 category: Cocoa
 rating: 9.0
 published: true
-description: "Internationalization is like flossing: everyone knows they should do it, but probably don't."
+excerpt: "Internationalization is like flossing: everyone knows they should do it, but probably don't."
 ---
 
 Internationalization is like flossing: everyone knows they should do it, but probably don't.

2012-09-10-uiaccessibility.md

@@ -5,7 +5,7 @@ ref: "http://developer.apple.com/library/ios/#documentation/uikit/reference/UIAc
 category: Cocoa
 rating: 10.0
 published: true
-description: "Accessibility, like internationalization, is one of those topics that's difficult to get developers excited about. But as you know, NSHipster is all about getting developers excited about this kind of stuff."
+excerpt: "Accessibility, like internationalization, is one of those topics that's difficult to get developers excited about. But as you know, NSHipster is all about getting developers excited about this kind of stuff."
 ---
 
 > We all want to help one another, human beings are like that.

2012-09-17-nscharacterset.md

@@ -5,7 +5,7 @@ ref: "http://developer.apple.com/library/mac/#documentation/Cocoa/Reference/Foun
 category: Cocoa
 rating: 8.5
 published: true
-description: "Foundation boasts one of the best, most complete implementations of strings around. But a string implementation is only as good as the programmer who wields it. So this week, we're going to explore some common uses--and misuses--of an important part of the Foundation string ecosystem: NSCharacterSet."
+excerpt: "Foundation boasts one of the best, most complete implementations of strings around. But a string implementation is only as good as the programmer who wields it. So this week, we're going to explore some common uses--and misuses--of an important part of the Foundation string ecosystem: NSCharacterSet."
 ---
 
 As mentioned [previously](http://nshipster.com/cfstringtransform/), Foundation boasts one of the best, most complete implementations of strings around.

2012-09-24-uicollectionview.md

@@ -5,7 +5,7 @@ ref: "https://developer.apple.com/library/ios/#documentation/UIKit/Reference/UIC
 category: Cocoa
 rating: 9.6
 published: true
-description: "UICollectionView single-handedly changes the way we will design and develop iOS apps from here on out. This is not to say that collection views are in any way unknown or obscure. But being an NSHipster isn't just about knowing obscure gems in the rough. Sometimes, it's about knowing about up-and-comers before they become popular and sell out."
+excerpt: "UICollectionView single-handedly changes the way we will design and develop iOS apps from here on out. This is not to say that collection views are in any way unknown or obscure. But being an NSHipster isn't just about knowing obscure gems in the rough. Sometimes, it's about knowing about up-and-comers before they become popular and sell out."
 ---
 
 `UICollectionView` is the new `UITableView`. It's that important.

2012-10-01-pragma.md

@@ -5,7 +5,7 @@ ref: "https://developer.apple.com/library/mac/#documentation/DeveloperTools/gcc-
 category: Objective-C
 rating: 8.0
 published: true
-description: "#pragma declarations are a mark of craftsmanship in Objective-C. Although originally purposed for compiling source code across many different compilers, the modern Xcode-savvy programmer uses #pragma declarations to very different ends."
+excerpt: "`#pragma` declarations are a mark of craftsmanship in Objective-C. Although originally purposed for compiling source code across many different compilers, the modern Xcode-savvy programmer uses #pragma declarations to very different ends."
 ---
 
 `#pragma` declarations are a mark of craftsmanship in Objective-C. Although originally used to make source code compatible between different compilers, the Xcode-savvy coder uses `#pragma` declarations to very different ends.

2012-10-08-at-compiler-directives.md

@@ -5,7 +5,7 @@ ref: ""
 category: Objective-C
 rating: 8.7
 published: true
-description: "If we were to go code-watching for Objective-C, what would we look for? Square brackets, ridiculously-long method names, and <tt>@</tt>'s. \"at\" sign compiler directives are as central to understanding Objective-C's gestalt as its ancestry and underlying mechanisms. It's the sugary glue that allows Objective-C to be such a powerful, expressive language, and yet still compile all the way down to C."
+excerpt: "If we were to go code-watching for Objective-C, what would we look for? Square brackets, ridiculously-long method names, and <tt>@</tt>'s. \"at\" sign compiler directives are as central to understanding Objective-C's gestalt as its ancestry and underlying mechanisms. It's the sugary glue that allows Objective-C to be such a powerful, expressive language, and yet still compile all the way down to C."
 ---
 
 Birdwatchers refer to it as (and I swear I'm not making this up) ["Jizz"][1]: those indefinable characteristics unique to a particular kind of thing.

2012-10-15-addressbookui.md

@@ -5,7 +5,7 @@ ref: "http://developer.apple.com/library/ios/#documentation/AddressBookUI/Refere
 category: AddressBookUI
 rating: 6.2
 published: true
-description: "Address Book UI is an iOS framework for displaying, selecting, editing, and creating contacts in a user's Address Book. Similar to the Message UI framework, Address Book UI contains a number of controllers that can be presented modally, to provide common system functionality in a uniform interface."
+excerpt: "Address Book UI is an iOS framework for displaying, selecting, editing, and creating contacts in a user's Address Book. Similar to the Message UI framework, Address Book UI contains a number of controllers that can be presented modally, to provide common system functionality in a uniform interface."
 ---
 
 [Address Book UI](http://developer.apple.com/library/ios/#documentation/AddressBookUI/Reference/AddressBookUI_Framework/_index.html) is an iOS framework for displaying, selecting, editing, and creating contacts in a user's Address Book. Similar to the [Message UI](http://developer.apple.com/library/ios/#documentation/MessageUI/Reference/MessageUI_Framework_Reference/_index.html) framework, Address Book UI contains a number of controllers that can be presented modally, to provide common system functionality in a uniform interface.

2012-10-22-nslinguistictagger.md

@@ -5,7 +5,7 @@ ref: "http://developer.apple.com/library/ios/#documentation/cocoa/reference/NSLi
 category: Cocoa
 rating: 9.7
 published: true
-description: "NSLinguisticTagger is a veritable Swiss Army Knife of linguistic functionality, with the ability to tokenize natural language strings into words, determine their part-of-speech & stem, extract names of people, places, & organizations, and tell you the languages & respective writing system used in the string."
+excerpt: "NSLinguisticTagger is a veritable Swiss Army Knife of linguistic functionality, with the ability to tokenize natural language strings into words, determine their part-of-speech & stem, extract names of people, places, & organizations, and tell you the languages & respective writing system used in the string."
 ---
 
 `NSLinguisticTagger` is a veritable Swiss Army Knife of linguistic functionality, with the ability to [tokenize](http://en.wikipedia.org/wiki/Tokenization) natural language strings into words, determine their part-of-speech & [stem](http://en.wikipedia.org/wiki/Word_stem), extract names of people, places, & organizations, and tell you the languages & respective [writing system](http://en.wikipedia.org/wiki/Writing_system) used in the string.

2012-10-29-uilocalizedindexedcollation.md

@@ -5,7 +5,7 @@ ref: "http://developer.apple.com/library/ios/#documentation/iPhone/Reference/UIL
 category: Cocoa
 rating: 7.1
 published: true
-description: "UITableView starts to become unwieldy once it gets to a few hundred rows. If users are reduced to frantically scratching at the screen like a cat playing Fruit Ninja in order to get at what they want... you may want to rethink your UI approach."
+excerpt: "UITableView starts to become unwieldy once it gets to a few hundred rows. If users are reduced to frantically scratching at the screen like a cat playing Fruit Ninja in order to get at what they want... you may want to rethink your UI approach."
 ---
 
 UITableView starts to become unwieldy once it gets to a few hundred rows. If users are reduced to frantically scratching at the screen like a [cat playing Fruit Ninja](http://www.youtube.com/watch?v=CdEBgZ5Y46U) in order to get at what they want... you may want to rethink your UI approach.

2012-11-05-nsurlprotocol.md

@@ -5,7 +5,7 @@ ref: "https://developer.apple.com/library/mac/#documentation/Cocoa/Reference/Fou
 category: Cocoa
 rating: 7.4
 published: true
-description: "Foundation’s URL Loading System is something that every iOS developer would do well to buddy up with. And of all of networking classes and protocols of Foundation, NSURLProtocol is perhaps the most obscure and powerful."
+excerpt: "Foundation’s URL Loading System is something that every iOS developer would do well to buddy up with. And of all of networking classes and protocols of Foundation, NSURLProtocol is perhaps the most obscure and powerful."
 ---
 
 iOS is all about networking--whether it's reading or writing state to and from the server, offloading computation to a distributed system, or loading remote images, audio, and video from the cloud.

2012-11-12-nsvaluetransformer.md

@@ -5,7 +5,7 @@ ref: "https://developer.apple.com/library/mac/#documentation/Cocoa/Reference/Fou
 category: Cocoa
 rating: 6.6
 published: true
-description: "Of all the Foundation classes, NSValueTransformer is perhaps the one that fared the worst in the shift from OS X to iOS. But you know what? It's ripe for a comeback. With a little bit of re-tooling and some recontextualization, this blast from the past could be the next big thing in your application."
+excerpt: "Of all the Foundation classes, NSValueTransformer is perhaps the one that fared the worst in the shift from OS X to iOS. But you know what? It's ripe for a comeback. With a little bit of re-tooling and some recontextualization, this blast from the past could be the next big thing in your application."
 ---
 
 Of all the Foundation classes, `NSValueTransformer` is perhaps the one that fared the worst in the shift from OS X to iOS.

2012-11-19-ns_enum-ns_options.md

@@ -5,7 +5,7 @@ ref: "https://developer.apple.com/library/mac/#releasenotes/General/APIDiffsMacO
 category: Cocoa
 rating: 7.0
 tags: popular
-description: "A skilled Objective-C developer is able to gracefully switch between Objective and Procedural paradigms, and use each to their own advantage."
+excerpt: "A skilled Objective-C developer is able to gracefully switch between Objective and Procedural paradigms, and use each to their own advantage."
 ---
 
 When everything is an object, nothing is.

2012-11-26-nsorderedset.md

@@ -5,7 +5,7 @@ ref: "http://developer.apple.com/library/mac/#documentation/Foundation/Reference
 category: Cocoa
 rating: 6.2
 published: true
-description: "Why isn't NSOrderedSet a subclass of NSSet? The answer may surprise you."
+excerpt: "Why isn't NSOrderedSet a subclass of NSSet? The answer may surprise you."
 ---
 
 Here's a question: why isn't `NSOrderedSet` a subclass of `NSSet`?

2012-12-03-kvc-collection-operators.md

@@ -5,7 +5,7 @@ ref: "http://developer.apple.com/library/ios/#documentation/cocoa/conceptual/Key
 category: Cocoa
 rating: 7.9
 published: true
-description: "Rubyists laugh at Objective-C’s bloated syntax. Although we lost a few pounds over the summer with our sleek new object literals, those Red-headed bullies still taunt us with their map one-liners and their fancy Symbol#to_proc. Fortunately, Key-Value Coding has an ace up its sleeves."
+excerpt: "Rubyists laugh at Objective-C’s bloated syntax. Although we lost a few pounds over the summer with our sleek new object literals, those Red-headed bullies still taunt us with their map one-liners and their fancy Symbol#to_proc. Fortunately, Key-Value Coding has an ace up its sleeves."
 ---
 
 Rubyists laugh at Objective-C's bloated syntax.

2012-12-10-instancetype.md

@@ -5,7 +5,7 @@ ref: "http://clang.llvm.org/docs/LanguageExtensions.html#objc_instancetype"
 category: Cocoa
 rating: 7.3
 published: true
-description: "Objective-C is a rapidly evolving language, in a way that you just don't see in established programming languages. Developments range from the mundane to paradigm-changing, but telling the difference takes practice. Because we're talking about low-level language features, it's difficult to understand what implications they may have higher up with API design."
+excerpt: "Objective-C is a rapidly evolving language, in a way that you just don't see in established programming languages. Developments range from the mundane to paradigm-changing, but telling the difference takes practice. Because we're talking about low-level language features, it's difficult to understand what implications they may have higher up with API design."
 ---
 
 Want to know what's coming next in Objective-C? [Keep your ear to the ground](http://clang.llvm.org/docs/LanguageExtensions.html).