Add reasons for deprecation

Change-Id: Ia27437c9c0732eb4aae347c467746ee87c3a7670
Reviewed-on: http://review.couchbase.org/38427
Tested-by: Mark Nunberg <mnunberg@haskalah.org>
Reviewed-by: Brett Lawson <brett19@gmail.com>