Authored by Justin R. Miller

refs #665: docs updates for deprecation

CONTRIBUTING
------------
If you have a usage question, please email help-at-mapbox.com.
If you want to contribute code:
1. In past, for things that are generally useful to mapping libraries, we encouraged contributions to the upstream project [Alpstein/route-me](http://github.com/alpstein/route-me), from which this project is derived. But that project is no longer active, so you can contribute pull here.
**Please note that this legacy tree of the Mapbox iOS SDK is deprecated. As such, this project is not under active development. The `2.0.0` and above tree, located at https://github.com/mapbox/mapbox-ios-sdk/, is a complete rewrite based on OpenGL ES and vector map rendering.**
1. Please familiarize yourself with work in [`mapbox-gl-native`](https://github.com/mapbox/mapbox-gl-native), which will eventually be the successor to this codebase. That framework solves lots of problems inherent to a Core Graphics-based framework like this one such as performance and flexibility.
1. Fork and submit a pull request **against the `develop` branch** so that we can review, discuss, and possibly integrate your code.
If you have a usage question, please email help-at-mapbox.com.
... ...
Mapbox iOS SDK
--------------
**This tree of the Mapbox iOS SDK is deprecated in favor of http://github.com/mapbox/mapbox-ios-sdk version 2.0.0 and above. The future of Mapbox maps is vector rendering, and 2.0.0 is a rewrite based on OpenGL ES and vector rendering.**
Based on the Route-Me iOS map library (Alpstein fork) with [Mapbox](http://mapbox.com) customizations.
Requires iOS 5 or greater (includes iOS 7+ support at runtime), Xcode 5.0 or greater, and ARC.
... ...