Deprecate 'index' special behavior.

Add pragma wich recommends transition to UDA's for "/" path definition.
Clean REST example for using 'index'.
Removed 'index' usage from docs.
Merge pull request #258 from Dicebot/deprecate_index

Deprecate index() special meaning in the REST interface generator.