## Welcome!

Welcome to the Knative community!

![Kuack the Knative Duck](./mascot/kuack.png)
*Meet Kuack, the Knative Duck - our community mascot!*

This is the starting point for becoming a contributor - improving code,
improving docs, giving talks, etc.

- [Introduction](#introduction)
- [Knative authors](#knative-authors)
  - [Authoring samples](#authoring-samples)
- [Meetings and work groups](#meetings-and-work-groups)
- [How can I help?](#how-can-i-help)
- [Questions and issues](#questions-and-issues)

Other Documents

- [Code of Conduct](./CODE-OF-CONDUCT.md) - all contributors must abide by the
  code of conduct
- [Values](./VALUES.md) - shared goals and values for the community
- [Contributing to Knative](./CONTRIBUTING.md) - guidelines and advice on
  becoming a contributor
- [Working Groups](./working-groups/WORKING-GROUPS.md) - describes our various
  working groups
- [Working Group Processes](./mechanics/WORKING-GROUP-PROCESSES.md) - describes
  how working groups operate
- [Steering Committee](./STEERING-COMMITTEE.md) - describes our steering
  committee
- [Technical Oversight Committee](./TECH-OVERSIGHT-COMMITTEE.md) - describes our
  technical oversight committee
- [Community Roles](./ROLES.md) - describes the roles individuals can assume
  within the Knative community
- [Reviewing and Merging Pull Requests](./REVIEWING.md) - how we manage pull
  requests
- [Repository Guidelines](./REPOSITORY-GUIDELINES.md) - how we create and remove
  core repositories

## Introduction

Knative is a Kubernetes-based platform to deploy and manage modern serverless
workloads. See the
[Knative documentation](https://knative.dev) for in-depth information about
using Knative.

## Knative authors

Knative is an open source project with an active development community. The
project was started by Google but has contributions from a growing number of
industry-leading companies.

### Authoring samples

Beyond the official documentation there are endless possibilities for combining
tools, platforms, languages, and products. By submitting a tutorial you can
share your experience and help others who are solving similar problems.

Community tutorials are stored in Markdown files under the `community` folder
[Community Samples](https://github.com/knative/docs/blob/main/code-samples/community/README.md).
These documents are contributed, reviewed, and maintained by the community.

Submit a Pull Request to the community sample directory under the Knative
component folder that aligns with your document. For example, Knative Serving
samples are under the `serving` folder. A reviewer will be assigned to review
your submission. They'll work with you to ensure that your submission is clear,
correct, and meets the [style guide](https://github.com/knative/docs/blob/main/contribute-to-docs/README.md),
but it helps if you follow it as you write your tutorial.

## Meetings and work groups

Knative has public and recorded monthly community meetings. You can see the
agenda and links to previous recordings
[here](https://docs.google.com/document/d/1o0ENlHpv5nYPOznlbDc9xzNcwTqtxZrmPAVZLoWRHyE/edit#heading=h.yzvtyg3omrak).

Each project has one or more
[working groups](./working-groups/WORKING-GROUPS.md) driving the project, and
Knative has a single
[technical oversight committee](./TECH-OVERSIGHT-COMMITTEE.md) monitoring the
overall project.

There's also a [Knative Calendar](./CALENDAR.MD) that has all the Knative
related meetings in one place.

## How can I help

If you're looking for something to do to get your feet wet working on Knative,
look for GitHub issues marked with the Help Wanted label:

- [Eventing issues](https://github.com/knative/eventing/labels/kind%2Fgood-first-issue)
- [Serving issues](https://github.com/knative/serving/labels/kind%2Fgood-first-issue)
- [Documentation repo](https://github.com/knative/docs/labels/kind%2Fgood-first-issue)
- [All of Knative](https://clotributor.dev/search?project=knative&page=1)

Even if there's not an issue opened for it, we can always use more testing
throughout the platform. Similarly, we can always use more docs, richer docs,
insightful docs. Or maybe a cool blog post? And if you're a web developer, we
could use your help in spiffing up our public-facing web site.

## Questions and issues

If you're a developer, operator, or contributor trying to use Knative, the
following resources are available for you:

- [Knative Users](https://groups.google.com/forum/#!forum/knative-users)
- [Knative Developers](https://groups.google.com/forum/#!forum/knative-dev)
- [Knative on CNCF Slack](./SLACK-GUIDELINES.md)

---

Except as otherwise noted, the content of this page is licensed under the
[Creative Commons Attribution 4.0 License](https://creativecommons.org/licenses/by/4.0/),
and code samples are licensed under the
[Apache 2.0 License](https://www.apache.org/licenses/LICENSE-2.0).
