added deprecation warning at compile time
replaced '$i' with more meaningful variable names
documenting deprecation syntax more clearly
Merge pull request #13 from Financial-Times/deprecation-warnings

Deprecation warnings
Adding use cases for dialogs
fixed typo
Merge branch 'dialog-usecases' of https://github.com/Financial-Times/o-colors into dialog-usecases
Fixed indentation