feat(userguide): document job definitions

related to #CAM-1421