[FLINK-1230] Add documentation and an example for collection-based execution

The *Local Execution/Debugging* section appears a bit unstructured to me. 
There are many short paragraphs (1 or 2 sentences) that do not link to each other (order seems to be random) and briefly discuss various things related to local execution and debugging.