updated handlers docs for handler
added future example
added json / xml produces example