Reorganized job/pipeline docs into relevant API reference sections
Improved language about git revisions a bit based on review feeback.
Merge branch '2488-jobs-pipeline-doc'