cosmos-sdk/x
Ivan Gavran 9f543b1c3b
refactor: Small clarifications to authz docs and one error description (#11506)
## Description

This small PR is trying to clarify the documentation that I found ambiguous when reading it.
Furthermore, it makes one error message more precise ("non-negative" --> "positive").

In particular:
 - I clarified that the field `AcceptResponse.Accept` will be set to `true` when an authorization is accepted, but **will not** be set to `false` otherwise (instead, the function `Accept` will return an error).
 - I clarified that the field `AcceptResponse.Updated` will not always be populated: it will be `nil` unless there are real changes to the authorization
 - I changed the error message in the `send_authorization.go` function, when `IsAllPositive()` returns `false` from _spend limit cannot be negitive_ to _spend limit must be positive_. I emphasized the fact that spend limit must be positive in the documentation.

This is my first contribution to the Cosmos-SDK codebase so if I made some mistake the process (wrt the checklist), guide me patiently, pls.



---

### 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))
- [ ] provided a link to the relevant issue or specification: NOTE: does not apply, these are clarification changes
- [ ] followed the guidelines for [building modules](https://github.com/cosmos/cosmos-sdk/blob/master/docs/building-modules): NOTE: does not apply, these are clarification changes
- [ ] included the necessary unit and integration [tests](https://github.com/cosmos/cosmos-sdk/blob/master/CONTRIBUTING.md#testing): NOTE: does not apply, these are clarification changes
- [ ] added a changelog entry to `CHANGELOG.md`: NOTE: does not apply, these are clarification changes
- [ ] included comments for [documenting Go code](https://blog.golang.org/godoc) NOTE: does not apply, these are clarification changes
- [x] updated the relevant documentation or specification
- [x] reviewed "Files changed" and left comments if necessary
- [ ] 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)
2022-04-03 09:50:51 +00:00
..
auth refactor(auth): better error message for method handler panic (#11482) 2022-03-29 16:06:30 +00:00
authz refactor: Small clarifications to authz docs and one error description (#11506) 2022-04-03 09:50:51 +00:00
bank refactor: Small clarifications to authz docs and one error description (#11506) 2022-04-03 09:50:51 +00:00
capability docs: Improve markdownlint configuration (#11104) 2022-02-10 12:07:01 +00:00
crisis fix: RegisterLegacyAminoCodec should error if Msg name is >39 chars (#11349) 2022-03-16 13:21:00 +00:00
distribution feat!: add 'amount' field to withdrawal responses #11457 2022-03-28 14:31:47 -04:00
epoching docs: Improve markdownlint configuration (#11104) 2022-02-10 12:07:01 +00:00
evidence fix: dockerfile for building proto (#11452) 2022-03-25 12:35:09 +00:00
feegrant fix: dockerfile for building proto (#11452) 2022-03-25 12:35:09 +00:00
genutil fix: Improve gentx validation & error messages (#11500) 2022-03-31 20:13:33 +00:00
gov docs: x/gov state machine inline comments changes (#11498) 2022-03-31 04:49:40 +00:00
group chore: remove votes sum invariant (#11483) 2022-03-29 13:38:39 +00:00
mint fix: dockerfile for building proto (#11452) 2022-03-25 12:35:09 +00:00
nft fix: dockerfile for building proto (#11452) 2022-03-25 12:35:09 +00:00
params fix: dockerfile for building proto (#11452) 2022-03-25 12:35:09 +00:00
simulation chore: bump TM to v0.35.0 release candidate (#10210) 2021-11-16 11:24:38 -08:00
slashing fix: dockerfile for building proto (#11452) 2022-03-25 12:35:09 +00:00
staking fix: dockerfile for building proto (#11452) 2022-03-25 12:35:09 +00:00
upgrade fix: dockerfile for building proto (#11452) 2022-03-25 12:35:09 +00:00
README.md docs: Improve markdownlint configuration (#11104) 2022-02-10 12:07:01 +00:00

README.md

List of Modules

Here are some production-grade modules that can be used in Cosmos SDK applications, along with their respective documentation:

  • Auth - Authentication of accounts and transactions for Cosmos SDK applications.
  • Authz - Authorization for accounts to perform actions on behalf of other accounts.
  • Bank - Token transfer functionalities.
  • Capability - Object capability implementation.
  • Crisis - Halting the blockchain under certain circumstances (e.g. if an invariant is broken).
  • Distribution - Fee distribution, and staking token provision distribution.
  • Epoching - Allows modules to queue messages for execution at a certain block height.
  • Evidence - Evidence handling for double signing, misbehaviour, etc.
  • Feegrant - Grant fee allowances for executing transactions.
  • Governance - On-chain proposals and voting.
  • Mint - Creation of new units of staking token.
  • Params - Globally available parameter store.
  • Slashing - Validator punishment mechanisms.
  • Staking - Proof-of-Stake layer for public blockchains.
  • Upgrade - Software upgrades handling and coordination.

To learn more about the process of building modules, visit the building modules reference documentation.

IBC

The IBC module for the SDK has moved to its own repository.