Skip to content

Commit

Permalink
Contributions page (cncf#519)
Browse files Browse the repository at this point in the history
* Contributions page

We get a lot of questions about where to start with the TAG or a WG.
This page is a great location for us to start supporting people with
an easier path into the groups.

@techmaharaj and I put together a draft of something we could add
here to get started.

Signed-off-by: Abby Bangser <[email protected]>

* Introduce blog contribution standards

There is an intention to introduce more community blogs onto the TAG
website. This is being particularly pushed by the platforms WG where
it is an emergent space and we would like an opportunity to explore
some of the ideas with a lower barrier to entry. This will also enable
more inclusion as we will encourage and support new voices without
requiring 6-12 months of editing.

This page is meant to introduce a baseline requirement for all TAG
contributions. If this content is approved, it is expected that the
WG Platforms will release a blog which further extends this to match
the way that WG in particular would like to work with new authors.

Big thanks to @earth2marsh for putting together the key points for
this policy!

Signed-off-by: Abby Bangser <[email protected]>

---------

Signed-off-by: Abby Bangser <[email protected]>
Signed-off-by: Hoon Jo <[email protected]>
  • Loading branch information
abangser authored and sysnet4admin committed Feb 24, 2024
1 parent 00a4eb5 commit 76eb286
Show file tree
Hide file tree
Showing 2 changed files with 93 additions and 0 deletions.
22 changes: 22 additions & 0 deletions website/content/en/contribute/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,25 @@ menu:
weight: 20
description: Ways to get involved with the TAG
---

Here are a few suggestions on how to get started with the CNCF Technical Advisory Group (TAG) App Delivery. While you may find it useful to approach each in order, there is no requirement to do so. Find what makes sense to you and jump in!

**Research a bit on what topics interest you the most.**

The TAG has a lot of topics to cover under App Delivery. Some of the larger topics have become Working Groups (WGs) but there is still a lot more to discuss at the top TAG level. Titles of WGs and projects may be self-explanatory, but sometimes not. Continue on to learn more about how to find the right project for you.

**Join Slack**

Luckily, the CNCF slack isn’t a quiet place, it’s very active and provides a lot of great value. A great thing to start with is by simply introducing yourself in a WG channel and saying what you’re interested in. The leaders of the WG will point you in the right direction along with others that have contributed.

**See what issues are available on GitHub**

There’s everything from code-specific issues to documentation issues and everything in-between. Feel free to leave a comment or a suggestion. You can find them under the CNCF GitHub org for each TAG. For example, here’s the link to the App Delivery Tag: https://github.com/cncf/tag-app-delivery

**Join a meeting**

This may seem scary at first, especially if you’re new, but it’s a great way to dive in and see friendly faces after chatting with folks on Slack when you’re more comfortable. The meetings are structured with talking points in a shared google doc. You may be given time to introduce yourself (if you want!) and you are welcome to bring a topic to the meeting.

**In conclusion, get started your way**

TAG and WG members come in all styles. Some have never been to a call, others rarely engage on GitHub. The real power in the community is the coming together of different experiences and ideas to generate useful content for the wider cloud native community. You and your experiences are a big part of that, so come join us today!
71 changes: 71 additions & 0 deletions website/content/en/contribute/community-post-guidelines/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,71 @@
---
title: Community Post Guidelines
list_pages: false
---

## Introduction

This policy outlines the guidelines for accepting, reviewing, and publishing blog posts on our platform: https://tag-app-delivery.cncf.io/blog.

Blog posts are an opportunity to foster a diverse and vibrant discussion environment, showcasing a variety of viewpoints from members and the wider open source community.

It is important to note that this TAG is not itself a publishing house, and therefore the main focus of the group is to generate conversation and collaboration which will be true for blog posts as well, though to a lesser degree than for writing which is deemed a TAG official publication.

## Representation of Diverse Viewpoints

### Community Voices
Our blog serves as a collective of diverse viewpoints from our community members. We believe in representing a wide array of thoughts, experiences, and perspectives.

### Inclusion of Disclaimer
Each post will include a short disclaimer, This blog post represents the viewpoint of its author(s) and does not necessarily reflect an official position or perspective of the TAG or any subsidiary working group. See this blog and contributions guidelines for more information on how you too can contribute." If the blog includes information about the authors current workplace or otherwise affiliated products, this must also be disclosed in the disclaimer.

## Submission, Review and Acceptance Criteria

### Submission Process
Contributors are required to submit their blog posts as pull requests (PRs).

### Review Process
The TAG content is open for review from anyone with good intentions across the open source community. These reviews can be used to refine the content and help TAG leaders determine if the blog will be posted.

### Acceptance Criteria
At least one TAG leader must approve the blog before it can be published. A non-exhaustive list of things the TAG leadership will evaluate is:
* Alignment with our community’s ethos and values.
* Relevance and usefulness to our community members.
* Independence from any one vendor or product.
* Originality and clarity of content.

## Criteria for Rejection

### Misalignment with Group Positions
Submissions fundamentally misaligned with the positions or values upheld by our group will be rejected. With this said, blogs are encouraged to have independent ideas which may at times challenge previous TAG publications, blog posts, or other content. This is not inherently an issue if the challenge is done using respect and detailed explanation of the data and experiences that led to this change.

### Non-Adherence to Community Standards
Submissions failing to meet our community standards in terms of content quality, relevance, or ethical considerations will be subject to rejection. Content must also adhere to the [CNCF Code of Conduct](https://github.com/cncf/foundation/blob/main/code-of-conduct.md).

### Feedback and Appeals
In cases of rejection, contributors will be provided with feedback. An appeal process is available for reconsideration, subject to the discretion of our TAG leadership team.

## Publication Process

### Editing and Finalization
Blog posts may undergo minor editing for clarity, grammar, and format consistency before publication. This will be done through PR reviews, suggestions, or adding a commit to the PR.

### Notification of Acceptance
Contributors will be notified of the acceptance of their submission through a GitHub PR approval.

### Publication and Promotion
Published posts will be shared on our platform and may be promoted through our social media channels and newsletters. Publication is expected to occur at the date of approval unless a specific date has been previously requested by the author and agreed with the TAG leadership team.

## Cross-Posting Policy

We actively encourage and support cross-posting content from personal or external blogs. This initiative helps in amplifying diverse voices and perspectives within our community.

Cross-posts must either start on this platform or be published to this platform within 7 calendar days. If your intent is to publish to the community platform blog, we recommend having a publishing window approved before that post is published elsewhere, so that a link to the cross-post may be added. If 7 days are exceeded, the community post may be rejected as unoriginal content.

## Amendments to the Policy

This policy is subject to change at the discretion of the group's leadership, with the aim of continually adapting to the evolving needs of our community and maintaining the highest standards of content quality and diversity.

## Acknowledgement

By submitting content to our platform, contributors agree to abide by the terms outlined in this policy.

0 comments on commit 76eb286

Please sign in to comment.