Skip to content

Latest commit

 

History

History
77 lines (50 loc) · 3.86 KB

CONTRIBUTING.md

File metadata and controls

77 lines (50 loc) · 3.86 KB

Contributing Guide

Welcome! We are glad that you want to contribute to our project! 💖

Please file an issue (or a pull request!) if any of the content below doesn't make sense or if you find spelling/grammar errors.

Ways to Contribute

  • Identification and inclusion of prior art. In other words, are you aware of or did you create content that is relevant to our goals? Please add your item to the spreadsheet or file an issue with the "Prior Art" tag.
  • Choose an Educational Module to work on. You can find a template for them and the current proposed list in the Proposed Educational Modules document. We are very interested in a better name for these so please also make suggestions if you have any :).

Not everything happens through a GitHub pull request. Please come to our meetings and let's discuss how we can work together.

Come to Meetings

Absolutely everyone is welcome to come to any of our meetings. You never need an invite to join us. In fact, we want you to join us, even if you don’t have anything you feel like you want to contribute. Just being there is enough!

You can find out more about our meetings here. You don’t have to turn on your video. The first time you come, introducing yourself is more than enough. Over time, we hope that you feel comfortable voicing your opinions, giving feedback on others’ ideas, and even sharing your own ideas, and experiences.

Slack Channel

Can't make the meetings but still want to be involved? Please, join our slack channel (#higher-ed) on the CNCF Slack and share your thoughts.

Ask for Help

We are a very new group so there are probably lots of things that are unclear or missing from the content we have developed. Please, please, let us know if you think information is missing or unclear.

The best way to communicate with us is via the meetings or the Slack channel.

Pull Requests

If you are interested in contributing to the project, please follow the guidelines below. If you are new to GitHub or contributing to open source, please feel free to come to a meeting or ask someone on our slack channel.

Generally speaking, any pull request (PR) is fine. However, please follow the below guidelines to ensure the PR gets feedback on its content rather than mechanics.

Sign Your Commits

DCO

Licensing is important to open source projects. It provides some assurances that the software will continue to be available based under the terms that the author(s) desired. We require that contributors sign off on commits submitted to our project's repositories. The Developer Certificate of Origin (DCO) is a way to certify that you wrote and have the right to contribute the code you are submitting to the project.

You sign-off by adding the following to your commit messages. Your sign-off must match the git user and email associated with the commit.

This is my commit message

Signed-off-by: Your Name <your.name@example.com>

Git has a -s command line option to do this automatically:

git commit -s -m 'This is my commit message'

If you forgot to do this and have not yet pushed your changes to the remote repository, you can amend your commit with the sign-off by running

git commit --amend -s