BigJob Examples Directory is Very Out-of-Date

[melrom]

We need to clean-up the BigJob 'examples' directory. There are examples from 'old-school' BigJob and also the 'pilot-api' examples are now largely out of date. We should systematically run these examples and either update them to work or remove them from the directory altogether so as not to confuse users.

In a perfect world, maybe we can also sync these up with the sphinx docs. :+1:

[oleweidner]

syncing examples with documentation is easy in Sphinx. We do this for saga-python, e.g.:

http://saga-project.github.io/saga-python/doc/adaptors/saga.adaptor.shell_job.html#example

The code is simply included via .. literalinclude:: ../../../examples/jobs/localjob.py

[melrom]

We have new examples/tutorial directory which follows Ole's example_styleguide.py. I feel that this is largely cleaned up for now.