How can we help? 👋

How to submit an improvement proposal for the Kin Rewards Engine logic

Information in relation to contributing ideas to improve the KRE logic.

The Kin Rewards Engine

The Kin Rewards Engine is overseen by the Kin Foundation, a non-profit entity that aims to foster the viability and effectiveness of Kin’s monetary systems to drive macroeconomic growth. All actions and decisions on the governance of the KRE are made with this goal in mind. Kin is designed to build a new digital economy where everyone is fairly compensated for the value they create online. By improving the Kin Rewards Engine to be more equitable and prosperous for the new digital economy’s participants, the Foundation hopes to continue moving that mission forward.

Contributing to the Kin Rewards Engine

Anyone can contribute to the Kin Rewards Engine discussion; participation in its iteration is welcomed and encouraged. Feel free to start your own discussion in any of Kin’s social channels. The place to provide formal feedback on proposals under consideration to be adopted is the Github Discussion section. To learn how to submit your own formal proposals and participate in the discussion, review this How to Contribute Guide.

Getting Started

If it is your first time contributing to the KRE, you may have to complete any number of the following steps, depending on your prior engagement with GitHub and Kin’s rewards-engine repository:

  1. Make a GitHub account. In order to participate, you will need a GitHub account. This step is self-explanatory. Use this link to sign up: Sign Up for GitHub.
  1. Explore the KRE repository. Before submitting new ideas, it might be a good idea to see what the current KRE looks like, and what people are already suggesting. To do this, explore the following sections:

How to Submit an Improvement Proposal

  1. Review the Improvement Proposal Template.  If you would like to submit your own improvement proposals for specific modifications of the KRE algorithms and spend guidelines, you should first review the Improvement Proposal template. While this format is not required, it is an easy-to-use guide that can save a contributor a lot of time.
    1. Notion image

2. Create and submit an improvement proposal for consideration. Firstly you will need to create a fork. Fork the rewards-engine repo so that you can make changes in your own repository. Creating a fork creates your own clone of an existing GitHub repo

  1. Create a new file in your rewards-engine/improvement-proposals folder. “Create New File” will allow you to make an addition inside your fork of the repo
  1. Using the Improvement Proposal Templatecreate an improvement proposal of your own. If you used a word program to type your proposal, copy and past it into the text input section. When saving your file, your file must end in .md in order for markdown to apply. Customize your proposal as you see fit and use the “Preview” tab to see what your improvement proposal will look once posted. When you have finished, select “Commit New File” to save the file to your repository.
  1. Now that you have your proposal saved in your local repository, it’s time to request it be filed in Kin Ecosystem’s repository which is called a “Pull Request”. Select this option and “Create Pull Request”. This will notify the Kin Foundation that there is a new proposal to be picked up.

Improvement Process

The Kin Foundation representation scans the rewards-engine repo regularly. Valid issues and improvement proposals are move forward. When an improvement proposal has been picked up for consideration, it will be announced, along with a window of time during which the community can comment, debate, and suggest edits to the improvement proposal. By that date, the Kin Foundation will deliberate and make a decision on the implementation of that proposal. Please note that the iteration process for the KRE is one that is always evolving.

Did this answer your question?