From 5413369674a036d51abe210fdf04352fcbfabe91 Mon Sep 17 00:00:00 2001 From: Julia Furst Morgado Date: Wed, 14 Aug 2024 18:42:18 -0400 Subject: [PATCH] enhance contributing.md, link to org-wide default file, mention commits need DCO Signed-off-by: Julia Furst Morgado --- CONTRIBUTING.md | 35 ++++++++++++++++++++--------------- 1 file changed, 20 insertions(+), 15 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 8ff7374..72cdbf0 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -2,24 +2,29 @@ This repository hosts lasting documents for the OpenGitOps project, which are versioned and released together. -In addition to contributions to the ongoing evolution of the GitOps [Principles](hhttps://github.com/open-gitops/documents/blob/v1.0.0/PRINCIPLES.md) and [Glossary](https://github.com/open-gitops/documents/blob/v1.0.0/GLOSSARY.md), OpenGitOps project is looking for additional types of content to help new and existing GitOps practitioners learn from each other on their journey. +Before contributing, please review the [OpenGitOps Contributing Guidelines](https://github.com/open-gitops/community-health-files/blob/main/CONTRIBUTING.md). This document provides essential details on how to contribute, including information about discussions, meetings, the Code of Conduct, and other important guidelines for engaging with the OpenGitOps community. -These may include content initially envisioned in the [Work Products](https://github.com/cncf/tag-app-delivery/blob/main/gitops-wg/charter.md#work-products-wip) section of GitOps Working Group charter: methodologies and approaches documents, a GitOps landscape document, or working examples for getting started. -Other content, such as white papers, case studies, architectural patterns, tool and technology comparisons, or tutorials, are also good candidates for inclusion. -Use your imagination! +## Contribution Guidelines -It's encouraged to first discuss any ideas or questions asynchronously with the GitOps community using [OpenGitOps project discussions](https://github.com/open-gitops/project/discussions). -These discussion topics are regularly highlighted in the twice-monthly community meetings, and in some cases, special teams are formed within OpenGitOps to collaborate on specific content topics raised in these discussions. +In addition to contributions to the ongoing evolution of the GitOps [Principles](https://github.com/open-gitops/documents/blob/v1.0.0/PRINCIPLES.md) and [Glossary](https://github.com/open-gitops/documents/blob/v1.0.0/GLOSSARY.md), OpenGitOps is looking for additional types of content to help new and existing GitOps practitioners learn from each other on their journey. -However it's created, all content in this repo must meet the acceptance criteria below to be considered for inclusion. -Pull requests must also receive at least two approvals from project maintainers. -We look forward to your contributions! +These may include content initially envisioned in the [Work Products](https://github.com/cncf/tag-app-delivery/blob/main/gitops-wg/charter.md#work-products-wip) section of the GitOps Working Group charter, such as methodologies and approaches documents, a GitOps landscape document, or working examples for getting started. Other content, such as white papers, case studies, architectural patterns, tool and technology comparisons, or tutorials, are also good candidates for inclusion. Use your imagination! + +## Discussion and Approval + +We encourage you to first discuss any ideas or questions asynchronously with the GitOps community using [OpenGitOps project discussions](https://github.com/open-gitops/project/discussions). These discussions are highlighted in the twice-monthly community meetings, and sometimes special teams are formed to collaborate on specific content topics. -## Minimum Acceptance Criteria: +## Minimum Acceptance Criteria -* Copyright is assigned to OpenGitops / CNCF project -* Content is not a duplicate (for version changes in technology, submit a new version of an existing article) -* Content is informational and not promotional, Tutorials and case studies of vendor technology are allowed, but promotional content is limited to 1 line and 1 link (excluding any links to free trials in the requirements section) at the start or end of the content -* Content should not contain branding for anything other than the OpenGitops project -* Content must be in markdown format +All content in this repo must meet the following acceptance criteria to be considered for inclusion: + +* **Developer Certificate of Origin (DCO):** Commit sign-off is required for all contributions. +* **Copyright:** Copyright must be assigned to OpenGitOps / CNCF project. +* **Originality:** Content must not be a duplicate. For version changes in technology, submit a new version of an existing article. +* **Informational:** Content must be informational and not promotional. Tutorials and case studies of vendor technology are allowed, but promotional content is limited to one line and one link (excluding any links to free trials) at the start or end of the content. +* **Branding:** Content should not contain branding for anything other than the OpenGitOps project. +* **Format:** Content must be in markdown format. + +Pull requests must also receive at least two approvals from project maintainers. +We look forward to your contributions! \ No newline at end of file