KIP Draft: KIP Format, Categories and Templates

KIP-2x: KIP Format, Categories and Templates

title: KIP Format, Categories and Templates
category: governance process
authors: JasonW<jason@rook.fi>, Wes²<wes@rook.fi>
created: 2022-06-21
replaces: KIP-0 (in part)
dependencies: TBD (pending KIPs for overall process and Sophons, as well as templates to be posted separately)

Proposal

Adopt a standardized process for drafting KIPs, including a set of templates to guide drafting, editing and review. This document will be amended over time as the Rook DAO and its technology evolve.

Background

Governance proposals are at the core of Rook’s governance process. Ensuring that these proposals follow a consistent format and process for drafting is important to ensuring that the process is as efficient and effective as possible. To that end, this proposal expands on the basic format outlined in KIP-0 to specify several categories of KIPs, and provides a template for each.

These templates are expected to conform to a combination of general requirements applicable to all KIPs, as well as category-specific requirements that reflect the information necessary for collective analysis and decision-making about various domains over which the DAO has decision power. The general and specific requirements are described further below.

General Requirements

Editorial requirements

A KIP should be written in plain language, formatted as Markdown on the forum. It should clearly and completely describe the proposal, its motivations, and why the author believes it improves the status quo. Where applicable, it should also describe a set of steps to enact the proposal. Authors and Governance Stewards (a role defined more fully in KIP X, the process one) should work together to ensure that the KIP meets at least the following minimum requirements:

  • Consistency: Does it contradict itself or any other KIP?
  • Accuracy: Are its data, arguments, and understanding of systems complete, accurate, and up-to-date? Are data points supported by citations with dates specified?
  • Feasibility: Does it propose outcomes or require resources that are impossible or impractical?
  • Mission Alignment and Rationale: Does the proposal provide a full rationale aligned with Rook DAO’s long-term goals and mission?
  • Verifiable Execution and Reporting: Does the proposal provide a clear statement of how it would be executed, as well as the means for anyone verify for themselves that an implementation did occur in the way described by the KIP?

Formatting requirements

The bulk of formatting requirements for KIPs are driven by the templates for individual categories. The unifying element across all templates is the need for a header at the top of each proposal that contains metadata that can be used to help organize the governance record. The required components are:

  • title The title of the proposed KIP
  • category The category of the proposal (see table in following section).
  • author A list of author names (or usernames if anonymous), along with e-mail addresses or another way to contact them.
  • created Date that the proposal was created in the forum. Should be in ISO 8601 format (YYYY-MM-DD).
  • replaces (If relevant) Comma-separated list of KIPs that the proposed KIP would replace.
  • dependencies (If relevant) Comma-separated list of KIPs on which the proposed KIP relies.

Rook’s Governance Stewards will amend and expand on these fields as and when the proposal moves through the process, but these fields are necessary to begin that process.

Specific Requirements: Categories and Templates

In addition to the General Requirements described above, each KIP will be required to conform to one of the following categories, and to use the template developed for that category. Proposal authors are expected to work first with the Stewards to identify the most appropriate category and thus template. If there is no relevant template for a given proposal, the Stewards will work with the author to ensure that the proposal rises to the same standards of argument and disclosure. In the event of a dispute over categorization, the Sophons will make a final determination of the most appropriate format.

The table below lists the categories as well as historical precedents, and includes links to the templates each proposal must choose from. The individual templates are posted as sub-KIPs in the Rook governance forum.

Category Description/Use Prior KIPs*
Integration Integrating Rook’s protocol and products with other protocols 7, 17, 18
Research/Dev Grant Funding significant research and development efforts 20
Product Altering products post-launch 16, 19
Treasury Investment Making specific investments using Rook treasury funds 5, 6, 10, 11, 22
Budget Requests for funding from the DAO for ongoing activities 3, 15
Governance Process Changes to Rook DAO’s governance process 0, 1, 8
Delegation of Powers Delegating discretionary powers to specific parties 12, 21, 23
Core Documents Establishing ongoing principles and frameworks for the DAO

* Examples are as of June 21, 2022.

Specifications

  • On ratification, prepare markdown versions of each template in Rook’s governance forum on Discourse
  • Stewards to work with proposal authors to ensure adherence to adopted templates
1 Like