Community Handbook

What is Layer5

Layer5 is a community and open source-centered service mesh company, representing the largest collection of service meshes and their maintainers in the world. Layer5 is also the creator and maintainer of service mesh standards and also the maker of Meshery, the service mesh management plane.

Community First

Layer5 also represents the community. We build projects to provide learning environments, deployment, and operational best practices, performance benchmarks, create documentation, share networking opportunities, and more. Our shared commitment to the open-source spirit pushes Layer5 projects forward. New members are always welcome.

Open Source First

Layer5 projects are open-source software. Anyone can download, use, work on, and share it with others. It's built on principles like collaboration, globalism, and innovation. Layer5 projects are distributed under the terms of Apache v2.

Goals

  • To build a large collection of service meshes.
  • To build products that are accessible and easy to use.
  • To build a welcoming community for open-source contributions.

Newcomer’s Path

Thank you for your interest in contributing to Layer5 open source initiatives!

In combination with the Layer5 Community Guide and Contributing Guide, the following set of instructions are to encourage and support first-time (or near first-time) open-source contributors.

How to contribute?

The following steps outline the process by which you can openly engage, learn, and participate in the broad set of open source projects at Layer5.

  1. Browse the list of Layer5 org issues bearing the “good first issue”, “first-timers-only” or the “help wanted” label.
  2. Alternatively, find an area of interest by checking out the Layer5 Repository Overview section of this handbook.
  3. After identifying the issue you wish to work on, check if it has been assigned by taking a look at the assignee section on the issue, otherwise signal your interest by commenting on the issue so that it can be assigned to you.

Working on your issue

Once an issue has been assigned to you, it’s time to get started!

  1. Be sure to sign off on your commits
  2. Contributions of all sizes are welcome.
  3. If you need some additional help, please join the Layer5 Slack workspace and find your way to the #newcomers channel. Feel free to ask questions.

While your issue is under review

  1. Please double-check that you have signed off on all of your git commits.
  2. Be patient. There are a large number of contributors and only a small number of maintainers/reviewers. All contributors are equally important to us, and we'll be sure to get to you as soon as possible. In the meanwhile, you are welcome to join our Slack workspace and take a look at all our projects.
Layer5, the service mesh company

Representing the largest collection of service meshes and their maintainers in the world, Layer5 is the service mesh company. Creator and maintainer of service mesh standards. Maker of Meshery, the service mesh management plane.