Improve documentation around (scheduled) jobs

Does https://docs.meltano.com/reference/command-line-interface#job put jobs in meltano.yml? What does that look like? It’s not documented under https://docs.meltano.com/concepts/project#meltanoyml-project-file.

https://docs.meltano.com/guide/orchestration#create-a-schedule also doesn’t mention scheduling a job, and should.

It’s also not clear to me what “Add a new job with multiple tasks by passing arrays in yaml format, where each item representing a run command.” means in https://docs.meltano.com/reference/command-line-interface#job. In a job with multiple tasks, do the tasks run in parallel when you call meltano run <that-job>?

[cjohnhanson]

@aaronsteers Yeah I can pick this up this afternoon. I’ll definitely need a PR review from @pandemicsyn to double check my understanding though.

[aaronsteers]

@DouweM - I think we need @pandemicsyn to stay focused on telemetry a bit longer.

I’ve added this to Iteration 3 as unassigned.

@cjohnhanson, @WillDaSilva - Do either of you have capacity to pick this up?