Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Various link and content updates #2986

Merged
merged 18 commits into from
May 17, 2024

Conversation

mmulji-ic
Copy link
Contributor

Description

Closes: #XXXX

Fixes a number of broken links and updates some content where services are no longer available.
Removed historic proposals which do not need to be maintained in the current set of docs.


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...

  • included the correct docs: prefix in the PR title
  • targeted the correct branch (see PR Targeting)
  • provided a link to the relevant issue or specification
  • 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 docs: prefix in the PR title
  • Confirmed all author checklist items have been addressed
  • Confirmed that this PR only changes documentation
  • Reviewed content for consistency
  • Reviewed content for thoroughness
  • Reviewed content for spelling and grammar
  • Tested instructions (if applicable)

@mmulji-ic
Copy link
Contributor Author

Should run this through the markdown link checker before merging to make sure that all nits have been fixed.

@mmulji-ic mmulji-ic added the scope: docs Improvements or additions to documentation label Mar 7, 2024
@mpoke
Copy link
Contributor

mpoke commented Mar 8, 2024

Should run this through the markdown link checker before merging to make sure that all nits have been fixed.

@mmulji-ic Still failing https://github.com/cosmos/gaia/actions/runs/8203120601/job/22435298975

@mmulji-ic
Copy link
Contributor Author

mmulji-ic commented Mar 14, 2024

Should run this through the markdown link checker before merging to make sure that all nits have been fixed.

@mmulji-ic Still failing https://github.com/cosmos/gaia/actions/runs/8203120601/job/22435298975

Will check again, seems definitely some existing working links are failing. Have added another PR to check mdx files. The links I checked seem to be working, might need to tweak the markdown checker config some more.

Copy link
Contributor

@MSalopek MSalopek left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@MSalopek MSalopek marked this pull request as draft April 15, 2024 07:51
@MSalopek MSalopek force-pushed the mmulji-ic/fix-broken-links-in-docs-2 branch from 98db3b9 to 6e7f30b Compare May 9, 2024 10:35
@MSalopek MSalopek changed the base branch from main to masa/docs-versioning May 9, 2024 10:35
Base automatically changed from masa/docs-versioning to main May 14, 2024 10:43
@MSalopek MSalopek marked this pull request as ready for review May 14, 2024 10:53
Copy link
Contributor

@mpoke mpoke left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I haven't review the entire thing, but there are a bunch of broken links (at least on GH). Not sure if they work on the doc site.

docs/README.md Outdated Show resolved Hide resolved
docs/docs/architecture/adr/adr-002-globalfee.md Outdated Show resolved Hide resolved
docs/docs/architecture/adr/adr-002-globalfee.md Outdated Show resolved Hide resolved
docs/docs/delegators/delegator-faq.md Outdated Show resolved Hide resolved
docs/docs/delegators/delegator-guide-cli.md Outdated Show resolved Hide resolved
docs/docs/getting-started/README.md Outdated Show resolved Hide resolved
@MSalopek MSalopek requested a review from mpoke May 15, 2024 12:53
Copy link
Contributor

@mpoke mpoke left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great work

@@ -121,7 +121,7 @@ Please note that `feeCoins` does not contain zero coins. The fee coins are split

### Fee Checks in `DeliverTx`
Implementing fee checks within the `DeliverTx` function introduces a few requirements:
- **Deterministic Minimum Fee Requirement**: For the `DeliverTx` process, it is essential to have a deterministic minimum fee requirement. In `CheckTx`, fee is checked by the `CombinedFeeRequirement(globalFees, localFees)`, which considers both `minimum-gas-prices` from `config/app.toml` and `MinimumGasPricesParam` from the globalfee Params (For more details, see [globalfee.md](/modules/globalfee.md)). `CombinedFeeRequirement` contains non-deterministic part: `minimum-gas-prices` from `app.toml`. Therefore, `CombinedFeeRequirement` cannot be used in `DeliverTx`. In `DeliverTx`, only `MinimumGasPricesParam` in globalfee Params is used for fee verification. The code implementation is shown below.
- **Deterministic Minimum Fee Requirement**: For the `DeliverTx` process, it is essential to have a deterministic minimum fee requirement. In `CheckTx`, fee is checked by the `CombinedFeeRequirement(globalFees, localFees)`, which considers both `minimum-gas-prices` from `config/app.toml` and `MinimumGasPricesParam` from the globalfee Params (For more details, see [globalfee](../../modules/globalfee)). `CombinedFeeRequirement` contains non-deterministic part: `minimum-gas-prices` from `app.toml`. Therefore, `CombinedFeeRequirement` cannot be used in `DeliverTx`. In `DeliverTx`, only `MinimumGasPricesParam` in globalfee Params is used for fee verification. The code implementation is shown below.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Link without the .md or .mdx extensions don't work for me in GH.

Suggested change
- **Deterministic Minimum Fee Requirement**: For the `DeliverTx` process, it is essential to have a deterministic minimum fee requirement. In `CheckTx`, fee is checked by the `CombinedFeeRequirement(globalFees, localFees)`, which considers both `minimum-gas-prices` from `config/app.toml` and `MinimumGasPricesParam` from the globalfee Params (For more details, see [globalfee](../../modules/globalfee)). `CombinedFeeRequirement` contains non-deterministic part: `minimum-gas-prices` from `app.toml`. Therefore, `CombinedFeeRequirement` cannot be used in `DeliverTx`. In `DeliverTx`, only `MinimumGasPricesParam` in globalfee Params is used for fee verification. The code implementation is shown below.
- **Deterministic Minimum Fee Requirement**: For the `DeliverTx` process, it is essential to have a deterministic minimum fee requirement. In `CheckTx`, fee is checked by the `CombinedFeeRequirement(globalFees, localFees)`, which considers both `minimum-gas-prices` from `config/app.toml` and `MinimumGasPricesParam` from the globalfee Params (For more details, see [globalfee](../../modules/globalfee.md)). `CombinedFeeRequirement` contains non-deterministic part: `minimum-gas-prices` from `app.toml`. Therefore, `CombinedFeeRequirement` cannot be used in `DeliverTx`. In `DeliverTx`, only `MinimumGasPricesParam` in globalfee Params is used for fee verification. The code implementation is shown below.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changed

@@ -162,4 +162,4 @@ The introduction of FeeDecorator has replaced the usage of `MempoolFeeDecorator`

## References

* [Documentation of the globalfee module](/modules/globalfee.md)
* [Documentation of the globalfee module](../../modules/globalfee)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ditto

Suggested change
* [Documentation of the globalfee module](../../modules/globalfee)
* [Documentation of the globalfee module](../../modules/globalfee.md)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Applied

order: 4
---

This Cosmos Hub educational documentation aims to outline the Hub's parameters, describe their functions, and describe the potential implications of modifying each parameter. This documentation also aims to provide guidelines for creating and assessing parameter-change proposals.
This documentation also aims to provide guidelines for creating and assessing parameter-change proposals.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This documentation also aims to provide guidelines for creating and assessing parameter-change proposals.
This documentation aims to provide guidelines for creating and assessing parameter-change proposals.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changed


Drafting and submitting a parameter-change governance proposal involves two kinds of risk: losing proposal deposit amounts and the potential to alter the function of the Cosmos Hub network in an undesirable way.

## What parameters can be changed?

The complete parameters of the Cosmos Hub are split up into different modules, each of which has its own set of parameters. Any of them can be updated with a Param Change Proposal. If you are technically inclined, this is the full [list of modules](https://github.com/cosmos/cosmos-sdk/tree/master/x) in the Cosmos SDK. The Cosmos Hub is built using the Cosmos SDK, but not all available modules are in use on the Hub.
The complete parameters of the Cosmos Hub are split up into different modules, each of which has its own set of parameters. Most module's parameters can be updated by submitting a governance proposal.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The complete parameters of the Cosmos Hub are split up into different modules, each of which has its own set of parameters. Most module's parameters can be updated by submitting a governance proposal.
The complete parameters of the Cosmos Hub are split up into different modules, each of which has its own set of parameters. Most parameters can be updated by submitting a governance proposal.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changed

@MSalopek MSalopek merged commit 0bea14d into main May 17, 2024
9 checks passed
@MSalopek MSalopek deleted the mmulji-ic/fix-broken-links-in-docs-2 branch May 17, 2024 12:00
@MSalopek MSalopek linked an issue May 17, 2024 that may be closed by this pull request
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
scope: docs Improvements or additions to documentation
Projects
Status: 👍 F4: Assessment
Development

Successfully merging this pull request may close these issues.

Variety of content updates for Gaia docs
3 participants