Learning Docs
Product DocsTechnical DocsLearning & GovernanceUseful Links
  • Learn about cheqd
  • Getting Started
    • ♟️What is cheqd?
    • ✋What is Creds?
  • Decentralised Identity
    • 🟢Start here
    • What are DIDs?
      • What is a DID?
      • What is a DID method?
      • What is a Verifiable Data Registry?
    • What are Verifiable Credentials?
      • What is a Verifiable Credential?
      • Types of Verifiable Credential
        • JSON (JWT)
        • JSON-LD
        • AnonCreds (ZKCreds)
        • SD-JWT
      • What is a Verifiable Presentation?
    • What are DID-Linked Resources?
  • $CHEQ
    • 🟢Start here
    • 📈Tokenomics
      • Tokenomics: Part 1
      • Tokenomics: Part 2
      • Tokenomics: Part 3
      • Tokenomics: Part 4
      • Circulating Supply Explained
      • Network Parameters
    • ✍️Identity writes
    • ♻️Credential Payments
      • Verifier pays Issuer
      • Holder pays Issuer
  • Governance
    • 🟢Start here
      • Introduction to Governance
      • Introduction to Entropy
      • Governance Principles
        • Foundational Principles
        • General Principles
    • 📚Learn
      • 🍎Core concepts
        • Staking
        • Slashing
        • Validating
        • Voting
        • Community Pool
      • ✏️Terminology
      • 📖Glossary
    • 🍍How to Participate
      • How to stake
      • How to vote
      • Making Network Changes
        • Minor Network Changes
        • Major Network Changes
    • ⚡Advanced
      • What is a Liquidity Pool?
        • How do liquidity pools work?
        • How to take part in a Liquidity Pool
      • CHEQ-ERC20 wrapped token
        • Why did we decide on a bridge to Ethereum?
        • What is the Gravity Bridge?
        • Why did we decide to use the Gravity Bridge?
        • What other bridging options did we explore?
        • How to send tokens to Ethereum with Gravity Bridge
        • How to add CHEQ tokens to UniSwap Liquidity Pools
        • How to send CHEQ tokens from Ethereum to cheqd
  • ⚖️ Legal
    • License
    • Code of Conduct
    • Security Policy
    • Legal Disclaimer
  • 🆘Support
    • System Status
    • Slack Channel
    • Discord
Powered by GitBook
LogoLogo

General

  • Website
  • Blog
  • Get $CHEQ

Product Docs

  • Product Docs
  • cheqd Studio
  • Creds.xyz

Technical Docs

  • Node Docs
  • GitHub
  • Block Explorer

Learning Docs

  • Learning Docs
  • Governance Docs
  • Governance Forum
  • Governance Explorer
On this page
  • Context
  • Decision tree
  • Voting off-chain
  • How do I make edits to general text or code in cheqd documentation?
  • GitBook
  • GitHub
  • Bug reports
  • Translations

Was this helpful?

Edit on GitHub
Export as PDF
  1. Governance
  2. How to Participate
  3. Making Network Changes

Minor Network Changes

Last updated 4 months ago

Was this helpful?

Context

These are changes that are insignificant, and do not affect the way the Network runs overall. Minor Network changes include, but are not limited to:

  • Textual edits to the Governance Framework or written general documentation;

  • Sensible additions to general documentation to improve clarity;

  • Minor code changes;

  • Finding, reporting and suggesting fixes to bugs;

  • Translating the cheqd documentation into various languages.

Decision tree

To help YOU understand how to make changes on the cheqd Network, the decision tree below visualises how changes should be carried out.

Voting off-chain

One of the core components of cheqd governance is having both on-chain and off-chain voting mechanisms.

Off-chain voting should be used for Minor Network Changes as well as for more general community polling.

cheqd uses the Governance platform Commonwealth to enable off-chain votes on specific forum discussion topics.

We will point the community to off-chain votes using our Telegram and Discord to keep all of the community in the loop.

How do I make edits to general text or code in cheqd documentation?

You are able to make revisions and amendments to the Wiki and source code without making a formal Proposal.

cheqd is an Open Source project which means that anyone is free to propose or make a revision, addition or amendment.

Changes can be made through two routes:

GitBook

GitBook is where cheqd's Wiki lives and where YOU can make suggested changes to the written documentation.

We suggest that YOU use our GitBook if you are unfamiliar with GitHub or if you prefer visual editors to code-based editors.

We have a Wiki for:

To make a change on either Wiki, you need to use the link below to become an Open Source Editor on cheqd's GitBook:

You should follow these instructions to make a edit to any cheqd GitBook content.

  1. Make your edits in the text directly or use comments: Via the link above, you will gain permissions to to read, edit and comment directly to the text. If you are confident with your edits, you can write and amend the text directly. If you are less confident, you can leave comments in the text, which admins will review and make changes from accordingly.

  2. Save your changes as a draft: You can save your changes as a draft and return to your draft later. If you want to remind yourself with the changes you made previously, you should click the Diff view button:

  3. Submit your changes: Once you are happy with your changes in your draft you should click Submit. This will send your changes to one of our Reviewers to be moderated before being pushed onto the documentation. There will be a pop-up asking you to explain the changes you made. Make sure to write a clear sentence summarising your main changes to make it easier for the cheqd reviewers to go through your work.

Comparing changes in Gitbook

You should keep your changes in drafts until you are happy with them.

Following this as best practice, avoids the Wiki being misused or flooded with changes from one person.

GitHub

You may also use GitHub to make changes and amendments to both the source code and the written content in this documentation.

Example:

Not ideal
Better

Fixed NoMethodError in RemovalWorker

Fix nil error when removing statuses caused by race condition

It is not always possible to phrase every change in such a manner, but it is desired.

The smaller the set of changes in the pull request is, the quicker it can be reviewed and merged. Splitting tasks into multiple smaller pull requests is often preferable.

Pull requests that do not pass automated checks may not be reviewed.

Bug reports

During the course of cheqd's lifecycle, it is likely that bugs will arise. Reporting these bugs effectively and resolving them promptly will be very important for the smooth running of the Network.

If there is common acknowledgement of the bug, next the bug SHOULD be highlighted as an issue in our forum, at:

Please use the search function to make sure that you are not submitting duplicates, and that a similar report or request has not already been resolved or rejected.

Translations

We would greatly appreciate this work from our community to ensure that cheqd reaches a diverse, multijurisdictional and multilingual spread of society.

We are currently working on a simple process for submitting translations through a GitHub branch. Please bear with us until we figure out a simple way to achieve this.

Once you have made your account using the link above, you will be classified as a on cheqd's GitBook. This will give you the ability to make edits and submit them to be reviewed by a . Reviewers are able to merge submitted changes.

We have multiple GitHub repositories which can all be accessed .

For instructions about making edits to GitHub repositories, we suggest you follow the instructions .

Please use clean, concise titles for your pull requests. Assume that the person reading the pull request title is not a programmer, but instead a cheqd Network user or lay-person, and try to describe your change or fix from in plain English. We use commit squashing, so the final commit in the main branch will carry the title of the pull request, and commits from the main branch are fed into the changelog. The changelog is separated into , and while that spec does not prescribe how the entries ought to be named, for easier sorting, start your pull request titles using one of the verbs "Add", "Change", "Deprecate", "Remove", or "Fix" (present tense).

Bugs can be discussed or raised in our or .

🍍
GitBook
GitHub
cheqd Technical documentation
Learning about cheqd
cheqd Product
cheqd Governance Framework
Editor
Reviewer
here
here
keepachangelog.com categories
Telegram
Discord
LogocheqdCommonwealth
LogocheqdCommonwealth
LogoGitBook
Tree diagram showing when to use on-chain or off-chain governance
How to compare GitBook changes