Go to file
Robert Zaremba 9833bf14c1
docs: update contributing guidelines (#10223)
## Description

Closes: #9814

+ Updates the contributing page
+ Adds contributing guidelines 

NOTE:
+ This pr doesn't update the code owners section. We will still need to define it.

This is based on the discussion we had 2 months ago and recent chats.

---

### Author Checklist

*All items are required. Please add a note to the item if the item is not applicable and
please add links to any relevant follow up issues.*

I have...

- [x] included the correct [type prefix](https://github.com/commitizen/conventional-commit-types/blob/v3.0.0/index.json) in the PR title
- [x] added `!` to the type prefix if API or client breaking change
- [x] targeted the correct branch (see [PR Targeting](https://github.com/cosmos/cosmos-sdk/blob/master/CONTRIBUTING.md#pr-targeting))
- [x] provided a link to the relevant issue or specification
- [x] followed the guidelines for [building modules](https://github.com/cosmos/cosmos-sdk/blob/master/docs/building-modules)
- [x] included the necessary unit and integration [tests](https://github.com/cosmos/cosmos-sdk/blob/master/CONTRIBUTING.md#testing)
- [x] added a changelog entry to `CHANGELOG.md`
- [x] included comments for [documenting Go code](https://blog.golang.org/godoc)
- [x] updated the relevant documentation or specification
- [x] reviewed "Files changed" and left comments if necessary
- [x] confirmed all CI checks have passed

### Reviewers Checklist

*All items are required. Please add a note if the item is not applicable and please add
your handle next to the items reviewed if you only reviewed selected items.*

I have...

- [ ] confirmed the correct [type prefix](https://github.com/commitizen/conventional-commit-types/blob/v3.0.0/index.json) in the PR title
- [ ] confirmed `!` in the type prefix if API or client breaking change
- [ ] confirmed all author checklist items have been addressed 
- [ ] reviewed state machine logic
- [ ] reviewed API design and naming
- [ ] reviewed documentation is accurate
- [ ] reviewed tests and test coverage
- [ ] manually tested (if applicable)
2021-10-01 11:36:22 +00:00
.github dont close issues (#10207) 2021-09-21 13:13:56 +00:00
baseapp fix!: remove grpc query routing through tendermint (#10045) 2021-09-30 08:17:33 +00:00
client build(deps): Use self-maintained btcutil (#10082) (#10201) 2021-09-30 13:25:44 +00:00
codec refactor: Implementing sigs.k8s.io YAML to remove .proto yaml annotations (#9780) 2021-09-24 14:37:34 +00:00
container feat: bump Go version to 1.17 (#9987) 2021-09-17 13:31:46 +02:00
contrib feat: bump Go version to 1.17 (#9987) 2021-09-17 13:31:46 +02:00
cosmovisor chore: cosmovisor/v1.0.0 release notes (#10266) 2021-09-30 12:45:18 +02:00
crypto build(deps): Use self-maintained btcutil (#10082) (#10201) 2021-09-30 13:25:44 +00:00
db feat: bump Go version to 1.17 (#9987) 2021-09-17 13:31:46 +02:00
docs docs: 10180 Fix SDK (#10237) 2021-09-28 19:33:58 +02:00
internal/conv internal/conv: fix wrong string to bytes implementation (#9141) 2021-04-19 14:51:05 +01:00
proto/cosmos refactor: Implementing sigs.k8s.io YAML to remove .proto yaml annotations (#9780) 2021-09-24 14:37:34 +00:00
scripts feat: Introduce Cosmos Scalars (#9933) 2021-09-21 09:46:29 +00:00
server fix!: remove grpc query routing through tendermint (#10045) 2021-09-30 08:17:33 +00:00
simapp fix: --home flag parsing (#10226) 2021-09-30 12:01:56 +00:00
snapshots docs: add `README` for `snapshots` package (#10120) 2021-09-16 15:43:03 +00:00
std Add ADR 031 BaseApp and codec infrastructure (#7519) 2020-10-15 13:07:59 +00:00
store fix: removed potential sources of non-determinism in upgrades (#10189) 2021-09-28 17:20:43 +02:00
telemetry refactor!: Keyring migration (#9695) 2021-09-20 12:02:15 +00:00
tests test: fix mockgen version (#9127) 2021-05-25 09:18:59 +00:00
testutil refactor!: Keyring migration (#9695) 2021-09-20 12:02:15 +00:00
third_party/proto feat: Introduce Cosmos Scalars (#9933) 2021-09-21 09:46:29 +00:00
types build(deps): Use self-maintained btcutil (#10082) (#10201) 2021-09-30 13:25:44 +00:00
version refactor: Implementing sigs.k8s.io YAML to remove .proto yaml annotations (#9780) 2021-09-24 14:37:34 +00:00
x build(deps): Use self-maintained btcutil (#10082) (#10201) 2021-09-30 13:25:44 +00:00
.build.sh fix library file path (#8301) 2021-01-12 10:08:42 +00:00
.clang-format Fix clang-format to specific version (#7350) 2020-10-27 10:04:34 +00:00
.codecov.yml CI: Fix codecov flag project config (#7994) 2020-11-20 09:13:25 -05:00
.deepsource.toml chore: refactor code quality issues (#8932) 2021-03-22 09:30:27 +00:00
.dockerignore Add basic Dockerfile to build all binaries and export gaiad 2018-04-10 12:39:47 +02:00
.gitattributes Merge PR #6426: Migrate API Server 2020-06-15 13:39:09 -04:00
.gitignore docs: fix cosmovisor quickstart (#9730) 2021-07-26 07:51:36 +00:00
.golangci.yml fix(CI): add golangci-lint to dependencies (#10112) 2021-09-14 11:05:30 +02:00
.goreleaser.yml ci: automate release post tag push (#6230) 2020-05-25 20:02:08 +02:00
.markdownlint.json chore: add markdownlint to lint commands (#9353) 2021-05-27 15:31:04 +00:00
.markdownlintignore chore: add markdownlint to lint commands (#9353) 2021-05-27 15:31:04 +00:00
.mergify.yml chore: update mergify for v0.44 backports (#10146) 2021-09-15 12:43:59 +02:00
CHANGELOG.md fix: --home flag parsing (#10226) 2021-09-30 12:01:56 +00:00
CODE_OF_CONDUCT.md Update CODE_OF_CONDUCT.md (#7381) 2020-09-28 11:28:30 +02:00
CODING_GUIDELINES.md docs: update contributing guidelines (#10223) 2021-10-01 11:36:22 +00:00
CONTRIBUTING.md docs: update contributing guidelines (#10223) 2021-10-01 11:36:22 +00:00
Dockerfile build: Update Dockerfile (#9839) 2021-08-03 09:46:16 -04:00
LICENSE docs: 10180 Fix SDK (#10237) 2021-09-28 19:33:58 +02:00
Makefile fix(CI): add golangci-lint to dependencies (#10112) 2021-09-14 11:05:30 +02:00
README.md docs:update README.md for Cosmos SDK consistent branding (#10265) 2021-09-30 06:45:43 +00:00
RELEASE_PROCESS.md docs: update contributing guidelines (#10223) 2021-10-01 11:36:22 +00:00
SECURITY.md docs: update contributing guidelines (#10223) 2021-10-01 11:36:22 +00:00
buf.yaml refactor: Bring back deprecated proto fields to `v1beta1` (#9534) 2021-06-23 13:03:33 +00:00
docker-compose.yml perf: Change localnet CIDR from /16 (65k addresses) to /25 (128 addresses) to reduce docker network conflicts (#9667) 2021-07-12 08:51:36 +00:00
go.mod build(deps): Use self-maintained btcutil (#10082) (#10201) 2021-09-30 13:25:44 +00:00
go.sum build(deps): Use self-maintained btcutil (#10082) (#10201) 2021-09-30 13:25:44 +00:00

README.md

Cosmos SDK

banner

The Cosmos SDK is a framework for building blockchain applications. Tendermint Core (BFT Consensus) and the Cosmos SDK are written in the Golang programming language. Cosmos SDK is used to build Gaia, the first implementation of the Cosmos Hub.

WARNING: The Cosmos SDK has mostly stabilized, but we are still making some breaking changes.

Note: Requires Go 1.17+

Quick Start

To learn how the Cosmos SDK works from a high-level perspective, see the Cosmos SDK High-Level Intro.

If you want to get started quickly and learn how to build on top of Cosmos SDK, visit Cosmos SDK Tutorials. You can also fork the tutorial's repository to get started building your own Cosmos SDK application.

For more information, see the Cosmos SDK Documentation.

Cosmos Hub Mainnet

The Cosmos Hub application, gaia, has moved to its own cosmos/gaia repository. Go there to join the Cosmos Hub mainnet and more.

Inter-Blockchain Communication (IBC)

The IBC module for the Cosmos SDK has moved to its own cosmos/ibc-go repository. Go there to build and integrate with the IBC module.

Starport

Starport is the all-in-one platform to build, launch, and maintain any crypto application on a sovereign and secured blockchain. If you are building a new app or a new module, use Starport to get started and speed up development.

Disambiguation

This Cosmos SDK project is not related to the React-Cosmos project (yet). Many thanks to Evan Coury and Ovidiu (@skidding) for this Github organization name. As per our agreement, this disambiguation notice will stay here.