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: fix links in governance section #1089

Merged
merged 4 commits into from
Dec 9, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion docs/governance/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,6 @@ Governance discussions happens in a number of places moderated by diverse
community members, including:

- [Forum](http://forum.cosmos.network/)
- [Discord](https://discord.gg/W8trcGV)
- [Reddit](http://reddit.com/r/cosmosnetwork)
- [Telegram (Governance Working Group)](https://t.me/hubgov)
- anywhere else you might interact with members of the Cosmos community!
20 changes: 9 additions & 11 deletions docs/governance/best_practices.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# Best Practices for Drafting a Proposal

There are currently three types of proposals supported by the Cosmos Hub:
- [Community Pool Spend](/community-pool-spend) - Proposal to spend funds from the community pool on
- [Community Pool Spend](./community-pool-spend) - Proposal to spend funds from the community pool on
an important project.
- [Parameter Change](/params-change) - Proposal to change a core on-chain parameter.
- [Text](/text) - Proposal to agree to a certain strategy, plan, commitment, future
- [Parameter Change](./params-change) - Proposal to change a core on-chain parameter.
- [Text](./text) - Proposal to agree to a certain strategy, plan, commitment, future
upgrade or other statement. Text proposals are exclusively a signalling mechanism and focal point for future coordination -
they do not directly cause any changes.

Expand Down Expand Up @@ -34,7 +34,7 @@ If you're already confident about your idea, [skip to Stage 2](#stage-2-your-dra
### Not yet confident about your idea?
Great! Governance proposals potentially impact many stakeholders. Introduce your idea with known members of the community before investing resources into drafting a proposal. Don't let negative feedback dissuade you from exploring your idea if you think that it's still important.

If you know people who are very involved with the Cosmos Hub, send them a private message with a concise overview of what you think will result from your idea or proposed changes. Wait for them to ask questions before providing details. Do the same in semi-private channels where people tend to be respectful (and hopefully supportive). I recommend [this Cosmos Discord community][discord] and the private Cosmos Network VIP Telegram channel (ask for an invite [on the forum][forum] if you are or would like to be a Cosmos contributor).
If you know people who are very involved with the Cosmos Hub, send them a private message with a concise overview of what you think will result from your idea or proposed changes. Wait for them to ask questions before providing details. Do the same in semi-private channels where people tend to be respectful (and hopefully supportive). I recommend the private Cosmos Network VIP Telegram channel (ask for an invite [on the forum][forum] if you are or would like to be a Cosmos contributor).

### Confident with your idea?
Great! However, remember that governance proposals potentially impact many stakeholders, which can happen in unexpected ways. Introduce your idea with members of the community before investing resources into drafting a proposal. At this point you should seek out and carefully consider critical feedback in order to protect yourself from [confirmation bias](https://en.wikipedia.org/wiki/Confirmation_bias). This is the ideal time to see a critical flaw, because submitting a flawed proposal will waste resources.
Expand Down Expand Up @@ -68,16 +68,15 @@ on Github is the ultimate standard for distributed collaboration on text files.
### Engage the community with your draft proposal
1. Post a draft of your proposal as a topic in the 'governance' category of the [Cosmos forum][forum]. Ideally this should contain a link to this repository, either directly to your proposal if it has been merged, or else to a pull-request containing your proposal if it has not been merged yet.
2. Directly engage key members of the community for feedback. These could be large contributors, those likely to be most impacted by the proposal, and entities with high stake-backing (eg. high-ranked validators; large stakers).
3. Engage with the Cosmos Governance Working Group (GWG). These are people focused on Cosmos governance--they won't write your proposal, but will provide feedback and recommend resources to support your work. Members can be contacted on the [forum][forum] (they use the tag 'GWG' in posts), in [Telegram](https://t.me/hubgov), and on [Discord][discord].
4. Target members of the community in a semi-public way before bringing the draft to a full public audience. The burden of public scrutiny in a semi-anonymized environment (eg. Twitter) can be stressful and overwhelming without establishing support. Solicit opinions in places with people who have established reputations first. For example, there is a private Telegram group called Cosmos Network VIP (ask for an invite [on the forum][forum] if you are or would like to be a Cosmos contributor). Let people in the [Discord community][discord] know about your draft proposal.
3. Engage with the Cosmos Governance Working Group (GWG). These are people focused on Cosmos governance--they won't write your proposal, but will provide feedback and recommend resources to support your work. Members can be contacted on the [forum][forum] (they use the tag 'GWG' in posts) and in [Telegram](https://t.me/hubgov).
4. Target members of the community in a semi-public way before bringing the draft to a full public audience. The burden of public scrutiny in a semi-anonymized environment (eg. Twitter) can be stressful and overwhelming without establishing support. Solicit opinions in places with people who have established reputations first. For example, there is a private Telegram group called Cosmos Network VIP (ask for an invite [on the forum][forum] if you are or would like to be a Cosmos contributor).
5. Alert the entire community to the draft proposal via
- Twitter, tagging accounts such as the All in Bits [Cosmos account](https://twitter.com/cosmos), the [Cosmos GWG](https://twitter.com/CosmosGov), and Today in Cosmos [@adriana_kalpa](https://twitter.com/adriana_kalpa)
- [Telegram](https://t.me/cosmosproject), [Adriana](https://t.me/adriana_KalpaTech) (All in Bits)
- [Discord][discord]

### Submit your proposal to the testnet

I intend to expand this [guide to include testnet instructions](/submitting.md#submitting-your-proposal-to-the-testnet).
I intend to expand this [guide to include testnet instructions](submitting.md#submitting-your-proposal-to-the-testnet).

You may want to submit your proposal to the testnet chain before the mainnet for a number of reasons, such as wanting to see what the proposal description will look like, to share what the proposal will look like in advance with stakeholders, and to signal that your proposal is about to go live on the mainnet.

Expand All @@ -89,10 +88,10 @@ Submitting your proposal to the testnet increases the likelihood of engagement a

A majority of the voting community should probably be aware of the proposal and have considered it before the proposal goes live on-chain. If you're taking a conservative approach, you should have reasonable confidence that your proposal will pass before risking deposit contributions. Make revisions to your draft proposal after each stage of engagement.

See the [submitting guide](/submitting.md) for more on submitting proposals.
See the [submitting guide](./submitting.md) for more on submitting proposals.

### The Deposit Period
The deposit period currently lasts 14 days. If you submitted your transaction with the minimum deposit (512 ATOM), your proposal will immediately enter the voting period. If you didn't submit the minimum deposit amount (currently 512 ATOM), then this may be an opportunity for others to show their support by contributing (and risking) their ATOMs as a bond for your proposal. You can request contributions openly and also contact stakeholders directly (particularly stakeholders who are enthusiastic about your proposal). Remember that each contributor is risking their funds, and you can [read more about the conditions for burning deposits here](/overview.md#burned-deposits).
The deposit period currently lasts 14 days. If you submitted your transaction with the minimum deposit (512 ATOM), your proposal will immediately enter the voting period. If you didn't submit the minimum deposit amount (currently 512 ATOM), then this may be an opportunity for others to show their support by contributing (and risking) their ATOMs as a bond for your proposal. You can request contributions openly and also contact stakeholders directly (particularly stakeholders who are enthusiastic about your proposal). Remember that each contributor is risking their funds, and you can [read more about the conditions for burning deposits here](./overview.md#burned-deposits).

This is a stage where proposals may begin to get broader attention. Most popular explorers currently display proposals that are in the deposit period, but due to proposal spamming, this may change. [Hubble](https://hubble.figment.network/cosmos/chains/cosmoshub-3/governance), for example, only displays proposals that have 10% or more of the minimum deposit, so 51.2 ATOM or more.

Expand All @@ -106,5 +105,4 @@ At this point you'll want to track which validator has voted and which has not.

Remember that any voter may change their vote at any time before the voting period ends. That historically doesn't happen often, but there may be an opportunity to convince a voter to change their vote. The biggest risk is that stakeholders won't vote at all (for a number of reasons). Validator operators tend to need multiple reminders to vote. How you choose to contact validator operators, how often, and what you say is up to you--remember that no validator is obligated to vote, and that operators are likely occupied by competing demands for their attention. Take care not to stress any potential relationship with validator operators.

[discord]: https://discord.gg/W8trcGV
[forum]: https://forum.cosmos.network/c/governance
8 changes: 4 additions & 4 deletions docs/governance/community-pool-spend/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Cosmos Hub 3 and the Community Pool

The Cosmos Hub 3 launched with community-spend capabilities on December 11, 2019, effectively unlocking the potential for token-holders to vote to approve spending from the Community Pool. **This documentation is in active development, so please seek feedback and take care when using this information.** [Discuss its development here](https://forum.cosmos.network/t/gwg-community-spend-best-practices/3240).
The Cosmos Hub 3 launched with community-spend capabilities on December 11, 2019, effectively unlocking the potential for token-holders to vote to approve spending from the Community Pool.

🇪🇸 Esta página también está [disponible en español](https://github.com/raquetelio/CosmosCommunitySpend/blob/master/README%5BES_es%5D.md).

Expand All @@ -22,9 +22,9 @@ Drafting and submitting a proposal is a process that takes time, attention, and

If you are considering drafting a proposal, you should review the general
background on drafting and submitting a proposal:
1. [How the voting process and governance mechanism works](/overview.md)
1. [How to draft your proposal and engage with the Cosmos community about it](/best_practices.md)
1. [How to submit your proposal](/submitting.md)
1. [How the voting process and governance mechanism works](../overview.md)
1. [How to draft your proposal and engage with the Cosmos community about it](../best_practices.md)
1. [How to submit your proposal](../submitting.md)

You should also review details specific to Community Pool Spend proposals:

Expand Down
13 changes: 7 additions & 6 deletions docs/governance/community-pool-spend/README[ES_es].md
Original file line number Diff line number Diff line change
Expand Up @@ -18,11 +18,12 @@ Crear y enviar una propuesta es un proceso que lleva tiempo, atención y conllev

Si estás considerando realizar una propuesta, deberías conocer:
1. [Sobre la Community Pool](#sobre-la-community-pool)
2. [Cómo funciona el mecanismo de voto y gobernanza](voting.md)
3. [Dónde y cómo involucrar a la comunidad de Cosmos acerca de tu idea](bestpractices.md)
4. [Lo que la comunidad querrá saber sobre tu propuesta](bestpractices.md#elements-of-a-community-spend-proposal)
5. [Cómo preparar tu borrador de propuesta final para ser enviada](submitting.md)
6. [Cómo enviar tu propuesta al Cosmos Hub testnet & mainnet](submitting.md)
2. [Cómo funciona el mecanismo de voto y gobernanza](../overview.md#_2-voting-period)
3. [Dónde y cómo involucrar a la comunidad de Cosmos acerca de tu idea](../best_practices.md)
4. [Lo que la comunidad querrá saber sobre tu propuesta](./best_practices.md#elements-of-a-community-spend-proposal)
5. [Cómo preparar tu borrador de propuesta final para ser enviada](../submitting.md)
6. [Cómo enviar tu propuesta al Cosmos Hub testnet & mainnet](../submitting.md)


## Sobre la Community Pool

Expand Down Expand Up @@ -60,4 +61,4 @@ La suposición principal es que los fondos deberían ser gastados de forma que a
Esperamos que todo esto tome forma a medida que las propuestas sean debatidas, aceptadas, y rechazadas por parte de la comunidad Cosmos Hub.

### ¿Cómo se desembolsan los fondos una vez que una prouesta de gastos de comunidad es aprobada?
Si una propuesta de gastos de comunidad es aprobada, el número de ATOM inluidos en la propuesta serán transferidos desde la community pool a la dirección especificada en la propuesta, y esto ocurrirá justo inmediatamente después de que el periodo de votación termine.
Si una propuesta de gastos de comunidad es aprobada, el número de ATOM inluidos en la propuesta serán transferidos desde la community pool a la dirección especificada en la propuesta, y esto ocurrirá justo inmediatamente después de que el periodo de votación termine.
2 changes: 1 addition & 1 deletion docs/governance/params-change/Bank.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,4 +32,4 @@ Setting the `sendenabled` parameter to `false` will prevent ATOMs from being tra


#### Notes
The cosmoshub-1 chain launched with `sendenabled` set to `false` and with [`withdrawaddrenabled`](params-change/Distribution.md#4-withdrawaddrenabled) set to `false`. Staking was enabled on cosmoshub-1, so setting `withdrawaddrenabled` to false was necessary to prevent a loophole that would enable ATOM transfer via diverting staking rewards to a designated address.
The cosmoshub-1 chain launched with `sendenabled` set to `false` and with [`withdrawaddrenabled`](./Distribution.md#4-withdrawaddrenabled) set to `false`. Staking was enabled on cosmoshub-1, so setting `withdrawaddrenabled` to false was necessary to prevent a loophole that would enable ATOM transfer via diverting staking rewards to a designated address.
Loading