Establish guidelines for CI/CD template submissions from Technology Partners
Proposal
Based on this MR: !51415 (closed) and later discussions in Slack, it seems we'll have a new "class" of CI/CD templates: CI/CD templates submitted by GitLab Technology Partners: https://about.gitlab.com/partners/technology-partners/
I believe we need to establish guidelines for every step of this process. Including:
- Guidelines for creating the template itself, with standards that can be used across all templates. This includes:
- Where to put the template, and naming standards?
- What syntax is recommended, and what syntax to avoid?
- Required style?
- Required comments? For example, explain if it's intended to be added with
include
or used standalone. Explanation of variables, prerequisites, etc.
- MR review process:
- Who to ping first?
- How to demonstrate the template in action?
- Template maintenance:
- Who is responsible for maintenance?
- How is the template maintained? If there are issues, who should the public contact, and how should they do it?
- What happens to the template if the partnership expires?
Current Documentation
The current template guide is generally for internal use: https://docs.gitlab.com/ee/development/cicd/templates.html
@DarwinJS wrote some details at https://gitlab.com/guided-explorations/ci-cd-plugin-extensions/design-guide-and-templates-for-ci-cd-extensions, but I don't see this as clear/precise enough for the authors/reviewers.
Edited by Marcel Amirault