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.