developer-portal icon indicating copy to clipboard operation
developer-portal copied to clipboard

Revamp Governance Section: Proposal for a restructured and accurate section

Open thenic95 opened this issue 3 months ago • 6 comments

Hi everyone,

I think it's about time that we think about how to properly restructure and repurpose the governance section.

The current information could be more varied, and as the Chang Hard Fork is about to happen sometime in 2024, we should think about revamping the section to keep it up-to-date.

I have included my proposal below for you to take a look at. I would mainly want to rewrite the Overview.md file in the main category and build out the two new sub-categories, Cardano Governance and Governance Tutorials.

Please let me know what you think and if you would like to contribute, please let me know 😃

Proposed New Structure

Main-Category: Participate in Governance

Current Name: Be Part of the Governance

Structure of Main-Category

  • Overview
    • Heading: Participate in Governance
      • Short Introduction
    • Heading: Cardano Governance
      • Updated text
    • Heading: Cardano Improvement Proposal (CIPs)
    • Heading: Cardano Problem Statements (CPSs)
    • Heading: Fund your project with Project Catalyst
  • Sub-Category: Cardano Governance -> See below
  • Governance Action Overview
    • Content: Detailed explanation of governance actions, voting thresholds, and participants.
      • Headings: Types of governance actions, eligibility for voting.
  • Sub-Category: Governance Tutorials -> See below
  • Cardano Improvement Proposals (C.I.P.) - Stays the Same
  • Cardano Problem Statements (CPS) - Stays the Same
  • Project Catalyst - TBD

Structure Sub-Category Cardano Governance

  • Contents:
    • Heading: Cardano's Governance Model
      • Introduction: A brief explanation of the on-chain governance system, emphasizing the tri-cameral model.
    • Sub-Heading:
      • Delegated Representatives (DReps): Their roles within the governance model.
      • Stake Pool Operators (SPOs): Overview of their function.
      • Constitutional Committee (CC): Introduction to its purpose and activities.
    • Heading: Decision-Making Process
      • Overview of governance actions, detailing the process from proposal to decision.

Structure Sub-Category Governance Tutorials

  • File: Overview.md
    • Content: Explain the intricacies of using the CLI for voting purposes. Link to install node example. Link to other governance tooling that doesn’t require the node
  • File: tutorials-drep.md
    • Contents: Explanation of DReps' roles, registration, and voting processes.
      • Heading: Registration and Deregistration: Guide
      • Heading: Voting as a DRep: Tutorial
      • Heading: How to host your DRep Metadata: (e.g. via GitHub)
      • Heading: Useful Queries: CLI Queries
      • Heading: Key Management: Advice on using an air-gapped machine for security.
  • File: tutorials-spo.md
    • Contents: Explain the roles of SPO in the on-chain governance system
      • Heading: Voting Tutorial: https://sancho.network/tutorials/vote-action/
  • File: tutorials-cc.md
    • Contents: Overview of the CC's role within Cardano's governance.
      • Heading: Cold Committee Keys Creation: Tutorial
      • Heading: Hot Committee Keys Creation: Tutorial
      • Heading: Voting with CC Keys: Explanation on how to vote.
  • File: tutorials-ada-holder.md
    • Contents: Overview of ADA holders' capabilities within governance.
      • Heading: Creating a Governance Action: Guide
      • Heading: Querying Votes of DReps and SPOs
      • Heading: Delegating to a DRep: Tutorial

Screenshot of How it might look like

Screenshot 2024-03-07 at 15 31 02

thenic95 avatar Mar 07 '24 14:03 thenic95