Skip to content

Latest commit

 

History

History
69 lines (40 loc) · 2.28 KB

CONTRIBUTING.md

File metadata and controls

69 lines (40 loc) · 2.28 KB

Contributing to Cosign

Thank you for considering contributing to Cosign! We welcome any contributions, whether it's bug fixes, new features, or improvements to the existing codebase.

Your First Pull Request

Review Sigstore's contribution guidelines which includes some high level information on how to contribute to Sigstore projects.

To help you get familiar with our contribution process, we have a list of good first issues which are relatively limited in scope.

Before working on an issue, please:

  1. Check the comments to see if someone is already working on it.
  2. If it's unassigned, comment that you're working on it to avoid duplication.

Contribution Prerequisites

Before running Cosign, ensure that you have Go installed.

Sending a Pull Request

You can find a step by step guide to submit your contribution on Sigstore's contribution guidelines.

The following steps describe the build, unit testing, linting, and documentation processes:

Building Cosign

To build cosign locally, run this command:

make cosign

Running Unit Tests

To run the unit tests, execute the following command:

make test

Make sure all tests pass without any failures or errors.

Running Lint

To run the linting checks, use the following command:

make lint

Address any linting warnings or errors before submitting your PR.

Document Generation

If your changes require updates to project documentation, run the following:

make docgen

Ensure that the documentation is up-to-date and reflects your changes accurately.

Sign DCO

Make sure to sign the Developer Certificate of Origin.

Additional Documentation

In addition to the README file, documentation for Cosign exists in the repository's doc folder and consists of one markdown file for each command. If you add, delete or modify a Cosign command you must also add, delete, or edit the appropriate file in the doc folder.