Document the 'provides' decorator

- Add autodoc reference for the 'provides' decorator.
- Order functions alphabetically in the docs.
- Add doc note that use of 'implements' is deprecated.
Merge pull request #167 from enthought/document-provides-decorator

Document the 'provides' decorator