One of the pain points for developers is finding out which fields go where in the ci.yaml definitions. We should add some more information about the schema of the file and how it relates to the builds so developers can help themselves rather than going through infra when they have questions.