update docs to reflect new job api changes and add some more examples